Web ツール
Web 検索 + フェッチツール（Brave Search API、Perplexity 直接/OpenRouter）
OpenClaw には2つの軽量 Web ツールが組み込まれています：
- ''web_search'' — Brave Search API（デフォルト）または Perplexity Sonar（直接または OpenRouter 経由）でウェブ検索。
- ''web_fetch'' — HTTP フェッチ + 可読コンテンツ抽出（HTML → markdown/text）。
これらはブラウザ自動化ではありません。JS 多用サイトやログインが必要な場合は、
''ブラウザツール''を使用してください。
仕組み
- ''web_search'' は設定されたプロバイダーを呼び出し、結果を返します。
- Brave（デフォルト）：構造化された結果（タイトル、URL、スニペット）を返します。
- Perplexity：リアルタイム Web 検索からの引用付きで AI が統合した回答を返します。
- 結果はクエリごとに15分間キャッシュされます（設定可能）。
- ''web_fetch'' はプレーン HTTP GET を実行し、可読コンテンツを抽出
（HTML → markdown/text）。JavaScript は実行しません。
- ''web_fetch'' はデフォルトで有効です（明示的に無効化しない限り）。
検索プロバイダーの選択
| プロバイダー | 利点 | 欠点 | API Key |
| - | -- | -- |
| ''perplexity/sonar'' | Web 検索付きの高速 Q&A | クイック検索 |
| ''perplexity/sonar-pro''（デフォルト） | Web 検索付きのマルチステップ推論 | 複雑な質問 |
| ''perplexity/sonar-reasoning-pro'' | 思考チェーン分析 | 深い研究 |
web_search
設定されたプロバイダーを使用して Web を検索します。
Requirements
- ''tools.web.search.enabled'' が ''false'' でないこと（デフォルト：有効）
- 選択したプロバイダーの API key：
- ''Brave''：''BRAVE_API_KEY'' または ''tools.web.search.apiKey''
- ''Perplexity''：''OPENROUTER_API_KEY''、''PERPLEXITY_API_KEY'' または ''tools.web.search.perplexity.apiKey''
Config
'{'
tools: '{'
web: '{'
search: '{'
enabled: true,
apiKey: "BRAVE_API_KEY_HERE", // BRAVE_API_KEY が設定されている場合はオプション
maxResults: 5,
timeoutSeconds: 30,
cacheTtlMinutes: 15,
'}',
'}',
'}',
'}'ツールパラメータ
- ''query'' (required)
- ''count''（1–10；デフォルトは設定から）
- ''country''（オプション）：地域固有の結果のための2文字国コード（例："DE"、"US"、"ALL"）。省略時は Brave がデフォルト地域を選択。
- ''search_lang''（オプション）：検索結果の ISO 言語コード（例："de"、"en"、"fr"）
- ''ui_lang''（オプション）：UI 要素の ISO 言語コード
- ''freshness''（オプション、Brave のみ）：発見時間でフィルタ（''pd''、''pw''、''pm''、''py'' または ''YYYY-MM-DDtoYYYY-MM-DD''）
Examples:
// ドイツ固有の検索
await web_search('{'
query: "TV online schauen",
count: 10,
country: "DE",
search_lang: "de",
'}');
// フランス語 UI 付きフランス語検索
await web_search('{'
query: "actualités",
country: "FR",
search_lang: "fr",
ui_lang: "fr",
'}');
// 最近の結果（過去1週間）
await web_search('{'
query: "TMBG interview",
freshness: "pw",
'}');web_fetch
URL をフェッチし、可読コンテンツを抽出します。
Requirements
- ''tools.web.fetch.enabled'' が ''false'' でないこと（デフォルト：有効）
- オプションの Firecrawl フォールバック：''tools.web.fetch.firecrawl.apiKey'' または ''FIRECRAWL_API_KEY'' を設定。
Config
'{'
tools: '{'
web: '{'
fetch: '{'
enabled: true,
maxChars: 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", // FIRECRAWL_API_KEY が設定されている場合はオプション
baseUrl: "https://api.firecrawl.dev",
onlyMainContent: true,
maxAgeMs: 86400000, // ミリ秒（1日）
timeoutSeconds: 60,
'}',
'}',
'}',
'}',
'}'ツールパラメータ
- ''url''（必須、http/https のみ）
- ''extractMode''（''markdown'' | ''text''）
- ''maxChars''（長いページを切り捨て）
Notes:
- ''web_fetch'' はまず Readability（メインコンテンツ抽出）を使用し、次に Firecrawl（設定されている場合）を使用します。両方が失敗すると、ツールはエラーを返します。
- Firecrawl リクエストはデフォルトでボット回避モードを使用し、結果をキャッシュします。
- ''web_fetch'' はデフォルトで Chrome 類似の User-Agent と ''Accept-Language'' を送信；必要に応じて ''userAgent'' を上書き。
- ''web_fetch'' はプライベート/内部ホスト名をブロックし、リダイレクトを再チェックします（''maxRedirects'' で制限）。
- ''web_fetch'' はベストエフォートの抽出です；一部のサイトはブラウザツールが必要です。
- ''Firecrawl'' でキー設定とサービス詳細を確認。
- レスポンスはキャッシュされます（デフォルト15分）で、重複フェッチを削減。
- ツールプロファイル/許可リストを使用する場合、''web_search''/''web_fetch'' または ''group:web'' を追加。
- Brave キーがない場合、''web_search'' は短いセットアップヒントとドキュメントリンクを返します。