web_search プロバイダーとして Ollama Web Search をサポートしており、
Ollama の Web 検索 API からタイトル、URL、スニペットを返します。
ローカルまたはセルフホストの Ollama では、デフォルトで API キーは不要です。到達可能な
Ollama ホストと ollama signin が必要です。直接ホスト型検索(ローカル Ollama なし)には、
baseUrl: "https://ollama.com" と実際の OLLAMA_API_KEY が必要です。
セットアップ
1
Ollama を起動
Ollama がインストールされ、実行中であることを確認します。
2
サインイン
3
Ollama Web Search を選択
OpenClaw が、優先度の高い認証情報付きプロバイダーよりも Ollama Web Search を
自動的に優先して選択することはありません。
tools.web.search.provider: "ollama" を使用して
明示的に選択する必要があります。設定
models.providers.ollama.baseUrl が正規のキーです。Web 検索プロバイダーでは、OpenAI SDK 形式の
設定例との互換性のため、そこに baseURL を指定することもできます。
何も設定されていない場合、OpenClaw はデフォルトで
http://127.0.0.1:11434 を使用します。
直接ホスト型の Ollama Web Search(ローカル Ollama なし):
認証とリクエストルーティング
- Web 検索専用の API キーフィールドはありません。設定済みホストが認証で保護されている場合、プロバイダーは
models.providers.ollama.apiKey(または対応する環境変数を使用したプロバイダー認証)を 再利用します。 - ホストの解決順序:
plugins.entries.ollama.config.webSearch.baseUrl→models.providers.ollama.baseUrl(またはbaseURL)→http://127.0.0.1:11434。 - 解決されたホストが
https://ollama.comの場合、OpenClaw は API キーを Bearer 認証として使用し、https://ollama.com/api/web_searchを 直接呼び出します。 - それ以外の場合、OpenClaw はまずローカルプロキシエンドポイント
/api/experimental/web_search(署名して Ollama Cloud に転送)を呼び出し、その後、 同じホスト上の/api/web_searchにフォールバックします。両方とも失敗し、OLLAMA_API_KEYが設定されている場合、そのキーを使用してhttps://ollama.com/api/web_searchに対して 1 回再試行します。このキーが ローカルホストに送信されることはありません。 - セットアップ中に Ollama に到達できない場合、またはサインインしていない場合、OpenClaw は警告しますが、 プロバイダーの選択は妨げません。