ブラウザ自動化をマスター

{
  browser: {
    enabled: true,
    headless: false,
    defaultProfile: "openclaw",
  },
}

ブラウザが動く様子を見るのが、「エージェントが動かないと判断した」のか「ブラウザサービスが起動していない」のかを見分ける最短の方法です。信頼できたら `headless` を有効にしてください。

openclaw config patch --file ./browser.json5
openclaw gateway restart

コントロールサービスはゲートウェイと同時に起動します。browser 設定の変更は再起動するまで反映されません。「変えたのに何も起きない」の相当部分がこれです。

# Then ask for something that requires a real page load, e.g.
#   "open example.com and tell me the heading"
#
# Watch the window. If nothing opens, the service did not start —
# check the gateway log before changing any other setting.

モデルが自分の知識だけでは答えられないことを尋ねてください。閲覧せずに答えられる質問は閲覧せずに答えられてしまい、ツールが動くかどうかは何も分かりません。

{
  browser: {
    evaluateEnabled: false,
    ssrfPolicy: "strict",
  },
}

`evaluateEnabled` はページ内で任意のJSを実行することを許可します。扱いにくいサイトのスクレイピングには実際に有用ですが、同時にブラウザツールで最も広い権限でもあります。切ってみて、実際の用途で本当に壊れるものがあるか確認してください。`ssrfPolicy` は遷移先を信頼できるホストに制限します。ページの内容がエージェントの次の遷移先に影響し得る場合、これが最も効きます。

{
  browser: {
    profiles: {
      work: { cdpPort: 9222 },
    },
  },
}

独自の `cdpPort` を持つ名前付きプロファイルなら、たまたま開いている任意のChromeウィンドウではなく、意図的に起動したインスタンスにアタッチ範囲を限定できます。