Tools

Ollama ウェブ検索

OpenClaw は、バンドルされた web_search プロバイダーとして Ollama Web Search をサポートしており、 Ollama の Web 検索 API からタイトル、URL、スニペットを返します。

ローカルまたはセルフホストの Ollama では、デフォルトで API キーは不要です。到達可能な Ollama ホストと ollama signin が必要です。直接ホスト型検索(ローカル Ollama なし)には、 baseUrl: "https://ollama.com" と実際の OLLAMA_API_KEY が必要です。

セットアップ

  • Ollama を起動

    Ollama がインストールされ、実行中であることを確認します。

  • サインイン

    bash
    ollama signin
  • Ollama Web Search を選択

    bash
    openclaw configure --section web

    プロバイダーとして Ollama Web Search を選択します。

  • モデルにすでに Ollama を使用している場合、Ollama Web Search は同じ設定済みホストを 再利用します。

    設定

    json5
    {  tools: {    web: {      search: {        provider: "ollama",      },    },  },}

    Web 検索のみに適用される、任意のホスト上書き設定:

    json5
    {  plugins: {    entries: {      ollama: {        config: {          webSearch: {            baseUrl: "http://ollama-host:11434",          },        },      },    },  },}

    または、Ollama モデルプロバイダーにすでに設定されているホストを再利用します:

    json5
    {  models: {    providers: {      ollama: {        baseUrl: "http://ollama-host:11434",      },    },  },}

    models.providers.ollama.baseUrl が正規のキーです。Web 検索プロバイダーでは、OpenAI SDK 形式の 設定例との互換性のため、そこに baseURL を指定することもできます。 何も設定されていない場合、OpenClaw はデフォルトで http://127.0.0.1:11434 を使用します。

    直接ホスト型の Ollama Web Search(ローカル Ollama なし):

    json5
    {  models: {    providers: {      ollama: {        baseUrl: "https://ollama.com",        apiKey: "OLLAMA_API_KEY",      },    },  },  tools: {    web: {      search: {        provider: "ollama",      },    },  },}

    認証とリクエストルーティング

    • Web 検索専用の API キーフィールドはありません。設定済みホストが認証で保護されている場合、プロバイダーは models.providers.ollama.apiKey(または対応する環境変数を使用したプロバイダー認証)を 再利用します。
    • ホストの解決順序:plugins.entries.ollama.config.webSearch.baseUrlmodels.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 は警告しますが、 プロバイダーの選択は妨げません。

    関連項目

    • Web 検索の概要 -- すべてのプロバイダーと自動検出
    • Ollama -- Ollama モデルのセットアップとクラウド/ローカルモード
    Was this useful?
    On this page

    On this page