OpenClaw 連携 — index1

← 戻る

# OpenClaw 連携

ワンクリック設定で index1 を導入し、OpenClaw AI Agent にプロジェクトナレッジベース検索を追加。

1インストール方法
標準的な Python パッケージインストール、ほとんどの環境に対応
2Skill ショートカットを作成しますか？
/reindex、/isearch、/doctor ショートカットコマンドを作成
3CJK 検索サポート
jieba をインストール、BM25 モードで CJK 検索に対応

以下のスクリプトをコピーして、プロジェクトルートのターミナルで実行：

🔌 Claude Code と設定を共有
スクリプトが生成する `.mcp.json` と `.claude/CLAUDE.md` は OpenClaw と Claude Code の両方で使えるため、二重管理は不要です。
⚠️ コンテナ環境？
OpenClaw Docker コンテナ内では pip に root 権限が必要です：`docker exec -u root <コンテナ> pip3 install index1 --break-system-packages`
✅ 検証
OpenClaw を再起動後、`docs_status でインデックス状態を確認して` と入力
AI が docs_status を呼び出した → 設定成功
AI がツールが見つからないと言った → .mcp.json のパスが正しいか確認
注意事項
Ollama 利用不可時の自動フォールバック
index1 は Ollama が利用できない場合、自動的に BM25-only モードにフォールバックします：
• BM25 全文検索は完全に利用可能、レイテンシ約 60-80ms
• ベクトル意味検索は利用不可（クロスリンガル検索が制限されます）
• エラーやクラッシュは発生せず、通知メッセージのみ出力
ベクトル検索が必要な場合：`curl -fsSL https://ollama.com/install.sh | sh && ollama pull nomic-embed-text`
SQLite バージョン互換性
index1 は FTS5 `contentless_delete`（SQLite ≥ 3.43.0 が必要）を使用しており、古いバージョンでは自動的にフォールバックします。

環境 | SQLite | 動作
--- | --- | ---
macOS 14+ / Python 3.12+ | 3.43+ | フル機能
Debian Bookworm (Docker) | 3.40 | 自動フォールバック
Ubuntu 22.04 | 3.37 | 自動フォールバック

v0.1.0+ で自動処理済み。旧バージョンで `contentless_delete` エラーが出る場合はアップグレードしてください。
Python バージョン要件
Python 3.10 以上が必要、3.11+ を推奨。OpenClaw コンテナには Python 3.11 が同梱されています。
CJK 検索は jieba に依存
BM25 モードでの CJK 検索には jieba 分詞が必要です：`pip install index1[chinese]`
jieba がない場合、CJK の BM25 検索は結果が 0 件になる可能性があります。英語検索には影響しません。
確認：`index1 doctor`（Check 6 で CJK サポート状態を表示）
トラブルシューティング

問題 | 原因 | 解決方法
--- | --- | ---
ツールが表示されない | MCP 設定エラー | `.mcp.json` を確認
AI が docs_search を使わない | 検索ルールが未設定 | `.claude/CLAUDE.md` を確認
`command not found` | index1 が PATH にない | `which index1` でフルパスを取得
`contentless_delete` エラー | バージョンが古い | `pip install --upgrade index1`
検索結果なし | 未インデックス | `index1 index ./src ./docs`
CJK 検索で 0 件 | jieba なし | `pip install index1[chinese]`
ベクトル検索が利用不可 | Ollama なし | Ollama をインストールしてモデルをプル