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 をインストールしてモデルをプル