設定ガイド

OpenClaw はコア設定に JSON ファイルを使います。既定の場所は ~/.openclaw/openclaw.json です。

設定ファイル

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-5"
      }
    }
  }
}

OpenClaw は幅広い AI モデルに対応しています。最良の体験のために、いくつか推奨があります。

対応サブスクリプション（OAuth）

• Anthropic（Claude Pro/Max）
• OpenAI（ChatGPT/Codex）

どのモデルでも利用できますが、Anthropic Pro/Max + Opus 4.5 を強く推奨します。モデルのフェイルオーバーや、認証プロファイル（OAuth と API キー）のローテーションをフォールバック付きで設定できます。

モデル設定でできること

• 複数のモデルプロバイダー（Anthropic、OpenAI、Gemini、ローカルモデルなど）
• 信頼性向上のためのモデルフェイルオーバー
• サブスクリプション向け OAuth 認証
• API キー認証
• プロファイルローテーションとフォールバック

OpenClaw はすべてのデータを専用のワークスペースディレクトリに保存します。

• ワークスペースルート： ~/.openclaw/workspace（agents.defaults.workspace で変更可）
• 注入されるプロンプトファイル： AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md
• Skills: ~/.openclaw/workspace/skills/<skill>/SKILL.md
• メモリファイル： OpenClaw が自動生成する Markdown 形式の日次ノート（例：memory/2025-01-01.md）

デフォルトの挙動

• デフォルト： main セッションではツールがホスト上で動くため、自分だけで使う場合はエージェントにフルアクセスがあります。
• グループ/チャンネルの安全： agents.defaults.sandbox.mode: "non-main" を設定すると、non-main セッション（グループ/チャンネル）をセッションごとの Docker サンドボックス内で実行します。その場合 bash も Docker 内で実行されます。

サンドボックス設定

危険/誤設定の DM ポリシーを洗い出すには openclaw doctor を実行してください。

デフォルトの DM アクセス（セキュリティ）

Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack におけるデフォルト挙動：

• DM ペアリング：（dmPolicy="pairing"）不明な送信者には短いペアリングコードを返し、メッセージは処理しません。
• Approve with: openclaw pairing approve <channel> <code> (then the sender is added to a local allowlist store).
• 公開 DM の受信： 明示的なオプトインが必要です。dmPolicy="open" を設定し、チャンネル allowlist に "*" を含めてください。

Gateway は OpenClaw のコントロールプレーンです。主な設定項目：

• ポート： 既定は 18789。gateway.port で変更可
• バインドアドレス： 既定は 127.0.0.1（ループバック）。gateway.bind で変更可
• Tailscale： Serve/Funnel アクセスのため gateway.tailscale.mode を設定
• 認証： パスワード/トークン認証のため gateway.auth.mode を設定

エージェントの挙動とデフォルトを設定します：

• モデル： agents.defaults.model.primary でデフォルトモデルを設定
• 思考レベル： 対応モデルでは thinkingDefault を設定
• 詳細モード： 詳細出力が必要なら verboseDefault を有効化
• セッション管理： session.scope、リセットポリシー、mainKey を設定