OpenClawでWeb検索とデータ取得を自動化する

最新の情報をAIに読み込ませるために、ブラウザで検索して結果をコピペする作業を繰り返していませんか？これは多くの開発者が共通して抱える面倒な作業です。OpenClawを使えば、AIが直接Webを検索し、必要なコンテンツを取得できるようになります。

OpenClawには、軽量な2つのWebツールが付属しています。

• web_search: PerplexityやBraveなどのAPIを使用してWebを検索します。
• web_fetch: URLからコンテンツを取得し、読みやすいMarkdownやテキストに変換します。

これらはブラウザの自動化ツールではありません。JavaScriptを多用するサイトやログインが必要なサイトには、Browser toolを使用してください。

必要なもの

作業を始める前に、以下の準備ができているか確認してください。

• OpenClawがインストールされた環境
• 使用する検索プロバイダーの API Key（Brave, Perplexity, Gemini, Grok, Kimiのいずれか）

クイックスタート

わずか数分でWeb検索機能を有効にできます。以下の手順で進めてください。

1. API Keyを取得する: 利用したいプロバイダー（例：PerplexityやBrave）の管理画面から API Key を発行します。
2. 設定を実行する: ターミナルで openclaw configure --section web を実行し、ガイドに従って API Key を入力します。
3. プロバイダーを選択する: 必要に応じて使用するプロバイダーを明示的に指定します。
4. 動作を確認する: 設定が完了すると、AIは自動的に web_search や web_fetch を利用できるようになります。

設定例（Perplexity Search）

{
  tools: {
    web: {
      search: {
        enabled: true,
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...", // PERPLEXITY_API_KEY 環境変数でも設定可能
        },
      },
    },
  },
}

検索プロバイダーの選び方

OpenClawは複数のプロバイダーに対応しています。おすすめは、高速で構造化された結果が得られる Perplexity Search API です。

Provider	メリット	デメリット	API Key
Perplexity Search API	高速、構造化された結果、フィルタリング（ドメイン、言語、地域など）、コンテンツ抽出	—	PERPLEXITY_API_KEY
Brave Search API	高速、構造化された結果	フィルタリングオプションが少ない、AI利用規約が適用される	BRAVE_API_KEY
Gemini	Google Search grounding、AIによる要約	Gemini API keyが必要	GEMINI_API_KEY
Grok	xAIによるWebグラウンディング回答	xAI API keyが必要	XAI_API_KEY
Kimi	MoonshotのWeb検索能力	Moonshot API keyが必要	KIMI_API_KEY / MOONSHOT_API_KEY

API Keyが設定されていない場合、OpenClawは以下の順序で自動検出を試みます。

1. Brave
2. Gemini
3. Kimi
4. Perplexity
5. Grok

Google Search groundingの活用

Geminiモデルを使用している場合、Google検索の結果を引用元付きで回答に組み込む「Google Search grounding」を利用できます。

{
  tools: {
    web: {
      search: {
        provider: "gemini",
        gemini: {
          apiKey: "AIza...", // GEMINI_API_KEY 環境変数でも設定可能
          model: "gemini-2.5-flash", // デフォルト
        },
      },
    },
  },
}

web_search の詳細パラメータ

検索をより細かく制御するために、以下のパラメータを使用できます。

Parameter	Description
query	検索クエリ（必須）
count	取得する結果数 (1-10, デフォルト: 5)
country	2文字のISO国コード (例: “JP”, “US”)
language	ISO 639-1言語コード (例: “ja”, “en”)
freshness	期間フィルター: day, week, month, year
domain_filter	ドメインの許可/拒否リスト (Perplexityのみ)

使用例（特定ドメインの除外）:

await web_search({
  query: "product reviews",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

web_fetch によるコンテンツ取得

web_fetch は、指定されたURLからメインコンテンツを抽出します。デフォルトで有効になっており、Readabilityによる解析を最初に行い、失敗した場合は Firecrawl（設定されている場合）をフォールバックとして使用します。

設定例:

{
  tools: {
    web: {
      fetch: {
        enabled: true,
        maxChars: 50000,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
        firecrawl: {
          enabled: true,
          apiKey: "YOUR_FIRECRAWL_API_KEY",
        },
      },
    },
  },
}

トラブルシューティング

よくある問題と解決策です。

• API Keyエラーが出る: openclaw configure --section web を実行して、正しいキーが保存されているか確認してください。環境変数（PERPLEXITY_API_KEY など）が Gateway プロセスに正しく渡されているかも重要です。
• ページの内容が取得できない: web_fetch はJavaScriptを実行しません。SPA（シングルページアプリケーション）やログインが必要なサイトの場合は、Browser toolに切り替えてください。
• リダイレクトでエラーになる: web_fetch はセキュリティのため、プライベート/内部ホスト名へのリダイレクトをブロックします。

さらに詳しい設定については、AI Setup Assistant で質問してみてください。

次のステップ

• Perplexity Search setup
• Brave Search setup
• Browser tool
• Firecrawl tool