OpenClaw設定ガイド：JSON5でカスタマイズと認証を完結

新しいツールを導入したとき、設定ファイルの場所がわからなかったり、少し書き換えただけで動かなくなったりして困ったことはありませんか？OpenClaw の設定システムは柔軟ですが、スムーズに使いこなすためにはいくつか押さえておくべきポイントがあります。

効率的な開発環境を構築するために、OpenClaw の設定に関する基本をマスターしましょう。

Configuration Basics

OpenClaw の設定システムの仕組みについて解説します。

設定ファイルの形式と場所は？

OpenClaw は、$OPENCLAW_CONFIG_PATH（デフォルトは ~/.openclaw/openclaw.json）にある JSON5 形式の設定ファイルを読み込みます。

ファイルが存在しない場合は、安全なデフォルト値が使用されます（これには ~/.openclaw/workspace というデフォルトのワークスペースも含まれます）。

`gateway.bind: "lan"`（または `"tailnet"`）に設定したら、何も反応しない、あるいは UI で「unauthorized」と表示される

ループバック（localhost）以外でのバインドには 認証（auth）が必須 です。gateway.auth.mode と gateway.auth.token を設定するか、環境変数 OPENCLAW_GATEWAY_TOKEN を使用してください。

{
  gateway: {
    bind: "lan",
    auth: {
      mode: "token",
      token: "replace-me"
    }
  }
}

なぜ localhost でもトークンが必要なのですか？

セットアップウィザードは、デフォルトで Gateway トークンを生成します（ループバック接続であっても同様です）。これは ローカルの WS クライアントも認証が必要 であることを意味します。これにより、他のローカルプロセスが勝手に Gateway を呼び出すのを防いでいます。

もし どうしても 認証なしのオープンなループバックにしたい場合は、設定から gateway.auth を削除してください。

設定を変更した後に再起動は必要ですか？

Gateway は設定ファイルを監視しており、ホットリロード（hot-reload）をサポートしています。

gateway.reload.mode: "hybrid"（デフォルト）: 安全な変更は即座に適用し、重要な変更の場合は再起動します
hot、restart、off も選択可能です

Web 検索（および Web 取得）を有効にする方法は？

web_fetch は API キーなしで動作します。web_search には Brave Search の API キーが必要です。

おすすめの方法: openclaw configure --section web を実行して、tools.web.search.apiKey にキーを保存してください。

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5
      },
      fetch: { enabled: true }
    }
  }
}

`config.apply` で設定が消えてしまいました。復旧と防止策は？

config.apply は 設定全体を置き換えます。一部のオブジェクトだけを送信すると、それ以外の設定はすべて削除されてしまいます。

復旧方法:

バックアップから復元する
バックアップがない場合は、openclaw doctor を再実行して設定し直す

防止策:

小さな変更には openclaw config set を使う
対話的に編集するには openclaw configure を使う

デバイス間で専用のワーカーを持つ中央 Gateway を運用するには？

一般的なパターンは、1 つの Gateway に加えて、Node と Agent を組み合わせる構成です。

Gateway（中央）: チャネル、ルーティング、セッションを管理します
Node（デバイス）: Mac、iOS、Android などを周辺機器として接続し、ローカルツールを公開します
Agent（ワーカー）: 特定の役割のための独立した頭脳やワークスペースです
Sub-agent: メインの Agent からバックグラウンドタスクを生成します
TUI: Gateway に接続し、Agent やセッションを切り替えて操作します

OpenClaw のブラウザは headless で実行できますか？

はい、設定オプションで変更可能です。

{
  browser: { headless: true },
  agents: {
    defaults: {
      sandbox: { browser: { headless: true } }
    }
  }
}

デフォルトは false（通常起動）です。headless モードは、一部のサイトでアンチボット機能に検知されやすくなる可能性があるため注意してください。

ブラウザ操作に Brave を使うには？

browser.executablePath に Brave のバイナリ（または他の Chromium ベースのブラウザ）のパスを設定し、Gateway を再起動してください。

設定についてさらに詳しく知りたい場合や、セットアップで困ったときは、AI Setup Assistant を活用してください。

次のステップ

CLI Reference - コマンドラインツールの詳細
Advanced Networking - 高度なネットワーク設定

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。