​

Web ツール

• web_search — Brave Search API（デフォルト）または Perplexity Sonar（直接または OpenRouter 経由）を使用した Web 検索。
• web_fetch — HTTP フェッチ + 可読性抽出（HTML → markdown / text）。

​

How it works

• web_search は、設定されたプロバイダーを呼び出して結果を返します。
  • Brave（デフォルト）: 構造化された結果（タイトル、URL、スニペット）を返します。
  • Perplexity: リアルタイム Web 検索に基づく、引用付きの AI 合成回答を返します。
• 結果はクエリごとに 15 分間キャッシュされます（設定可能）。
• web_fetch は通常の HTTP GET を行い、可読なコンテンツを抽出します （HTML → markdown / text）。JavaScript は 実行しません。 JavaScriptは実行されません。 JavaScriptは実行されません。
• web_fetch は、明示的に無効化されない限りデフォルトで有効です。

​

検索プロバイダーの選択

{
  tools: {
    web: {
      search: {
        provider: "brave", // or "perplexity"
      },
    },
  },
}

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
          model: "perplexity/sonar-pro",
        },
      },
    },
  },
}

​

Brave API キーの取得

1. https://brave.com/search/api/ で Brave Search API アカウントを作成します。
2. ダッシュボードで Data for Search プラン（「Data for AI」ではありません）を選択し、API キーを生成します。
3. openclaw configure --section web を実行してキーを設定に保存する（推奨）か、環境変数に BRAVE_API_KEY を設定します。

​

キーの設定場所（推奨）

​

Perplexity の使用（直接または OpenRouter 経由）

​

OpenRouter API キーの取得

1. https://openrouter.ai/ でアカウントを作成します。
2. クレジットを追加します（暗号資産、プリペイド、クレジットカード対応）。
3. アカウント設定で API キーを生成します。

​

Perplexity 検索のセットアップ

{
  tools: {
    web: {
      search: {
        enabled: true,
        provider: "perplexity",
        perplexity: {
          // API key (optional if OPENROUTER_API_KEY or PERPLEXITY_API_KEY is set)
          apiKey: "sk-or-v1-...",
          // Base URL (key-aware default if omitted)
          baseUrl: "https://openrouter.ai/api/v1",
          // Model (defaults to perplexity/sonar-pro)
          model: "perplexity/sonar-pro",
        },
      },
    },
  },
}

• PERPLEXITY_API_KEY または pplx-... → https://api.perplexity.ai
• OPENROUTER_API_KEY または sk-or-... → https://openrouter.ai/api/v1
• 不明なキー形式 → OpenRouter（安全なフォールバック）

​

利用可能な Perplexity モデル

​

web_search

​

要件

• tools.web.search.enabled が false でないこと（デフォルト: 有効）
• 選択したプロバイダーの API キー:
  • Brave: BRAVE_API_KEY または tools.web.search.apiKey
  • Perplexity: OPENROUTER_API_KEY、PERPLEXITY_API_KEY、または tools.web.search.perplexity.apiKey

​

設定

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE", // optional if BRAVE_API_KEY is set
        maxResults: 5,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
      },
    },
  },
}

​

ツールパラメーター

• query（必須）
• count（1–10、デフォルトは設定から取得）
• country（任意）: 地域別結果のための 2 文字の国コード（例: 「DE」「US」「ALL」）。省略時は Brave のデフォルト地域が使用されます。 省略された場合、Braveはデフォルトの領域を選択します。 省略された場合、Braveはデフォルトの領域を選択します。
• search_lang（任意）: 検索結果の ISO 言語コード（例: 「de」「en」「fr」）
• ui_lang（任意）: UI 要素の ISO 言語コード
• freshness（任意、Brave のみ）: 発見時刻によるフィルタ（pd、pw、pm、py、または YYYY-MM-DDtoYYYY-MM-DD）
  • Brave: pd、pw、pm、py、または YYYY-MM-DDtoYYYY-MM-DD
  • Perplexity: pd、pw、pm、py

// German-specific search
await web_search({
  query: "TV online schauen",
  count: 10,
  country: "DE",
  search_lang: "de",
});

// French search with French UI
await web_search({
  query: "actualités",
  country: "FR",
  search_lang: "fr",
  ui_lang: "fr",
});

// Recent results (past week)
await web_search({
  query: "TMBG interview",
  freshness: "pw",
});

​

web_fetch

​

web_fetch の要件

• tools.web.fetch.enabled が false でないこと（デフォルト: 有効）
• 任意の Firecrawl フォールバック: tools.web.fetch.firecrawl.apiKey または FIRECRAWL_API_KEY を設定します。

​

web_fetch の設定

{
  tools: {
    web: {
      fetch: {
        enabled: true,
        maxChars: 50000,
        maxCharsCap: 50000,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
        maxRedirects: 3,
        userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36",
        readability: true,
        firecrawl: {
          enabled: true,
          apiKey: "FIRECRAWL_API_KEY_HERE", // optional if FIRECRAWL_API_KEY is set
          baseUrl: "https://api.firecrawl.dev",
          onlyMainContent: true,
          maxAgeMs: 86400000, // ms (1 day)
          timeoutSeconds: 60,
        },
      },
    },
  },
}

​

web_fetch ツールパラメーター

• url（必須、http / https のみ）
• extractMode（markdown | text）
• maxChars（長いページを切り詰めます）

• web_fetch は、まず Readability（メインコンテンツ抽出）を使用し、次に Firecrawl（設定されている場合）を使用します。両方が失敗した場合、ツールはエラーを返します。 両方とも失敗した場合、ツールはエラーを返します。 両方とも失敗した場合、ツールはエラーを返します。
• Firecrawl のリクエストはボット回避モードを使用し、デフォルトで結果をキャッシュします。
• web_fetch は Chrome 風の User-Agent と Accept-Language をデフォルトで送信します。必要に応じて userAgent を上書きしてください。
• web_fetch はプライベート / 内部ホスト名をブロックし、リダイレクトを再チェックします（maxRedirects で制限）。
• maxChars は tools.web.fetch.maxCharsCap にクランプされます。
• web_fetch はベストエフォートの抽出です。一部のサイトでは Browser tool が必要になります。
• キーの設定やサービスの詳細については Firecrawl を参照してください。
• レスポンスは（デフォルト 15 分間）キャッシュされ、繰り返しのフェッチを削減します。
• ツールプロファイル / 許可リストを使用している場合は、web_search/web_fetch または group:web を追加してください。
• Brave キーがない場合、web_search はドキュメントへのリンク付きの短いセットアップヒントを返します。