OpenClaw 設定リファレンス：openclaw.json の全設定を解説

OpenClaw のすべての設定を1ヶ所に。openclaw.json の設定や openclaw config set コマンドの実行時のリファレンスとしてご利用ください。

設定ファイルの場所

openclaw config path

デフォルトの場所：~/.openclaw/openclaw.json

Dockerコンテナ内：/app/data/openclaw.json

ゲートウェイ設定

ゲートウェイは OpenClaw のコアプロセスで、すべてのクライアント（ブラウザ、Telegram、API）からの接続を処理します。

gateway.mode

必須。 ゲートウェイが接続を受け入れる方法を制御します。

openclaw config set gateway.mode "local"

この設定がないと、ゲートウェイは gateway start blocked で起動を拒否します。

gateway.host

ゲートウェイがバインドするホスト名またはIP。

openclaw config set gateway.host "localhost"

デフォルト：localhost。他のマシンからアクセスする必要がある場合は 0.0.0.0 に設定。

gateway.port

ゲートウェイがリッスンするポート。

openclaw config set gateway.port 3001

デフォルト：3001。ポート競合がある場合に変更してください。

gateway.token

ゲートウェイ認証の固定トークン。再起動時のトークン再生成を防止します。

openclaw config set gateway.token "your-stable-token"

設定しない場合、OpenClaw は再起動のたびに新しいトークンを生成し、接続中のすべてのデバイスが無効になります。

代替： 環境変数 OPENCLAW_GATEWAY_TOKEN で設定。

gateway.trustedProxies

OpenClaw が転送ヘッダーを信頼するリバースプロキシのIPアドレス。

openclaw config set gateway.trustedProxies '["127.0.0.1"]'

リバースプロキシ（Caddy、Nginx、Traefik）使用時は必須。 これがないと、プロキシ経由で転送される接続が実際にlocalhostから来ていることを OpenClaw が検証できません。

gateway.bind

バインドするネットワークインターフェース。

openclaw config set gateway.bind "127.0.0.1"

デフォルト：127.0.0.1（ループバックのみ）。外部アクセスには 0.0.0.0 に設定。

AIプロバイダー設定

ai.model

応答に使用するAIモデル。

openclaw config set ai.model "claude-sonnet-4-6"

一般的な値：claude-sonnet-4-6、claude-opus-4-6、claude-haiku-4-5、gpt-4o、deepseek-chat。

ai.apiKey

AIプロバイダーのAPIキー。

openclaw config set ai.apiKey "sk-ant-..."

代替： 環境変数 ANTHROPIC_API_KEY または OPENAI_API_KEY で設定。

ai.provider

使用するAIプロバイダー。

openclaw config set ai.provider "anthropic"

値：anthropic、openai、deepseek、ollama。

ai.maxTokens

応答あたりの最大トークン数。

openclaw config set ai.maxTokens 4096

高い値はより長い応答を許可しますが、コストが増加します。

Telegram設定

telegram.token

BotFatherから取得したTelegramボットトークン。

openclaw config set telegram.token "123456:ABC-DEF..."

telegram.allowedUsers

ボットとインタラクションを許可されたTelegramユーザーIDのリスト。

openclaw config set telegram.allowedUsers '[12345678]'

未設定の場合、ボットを見つけた誰でも使用できます。

MCPサーバー設定

mcpServers

Model Context Protocolサーバー（プラグイン）の設定。

# GitHub統合
openclaw config set mcpServers.github.env.GITHUB_TOKEN "ghp_..."

# Google統合
openclaw config set mcpServers.google.env.CLIENT_ID "..."

各MCPサーバーは mcpServers.<名前> の下に独自のサブ設定を持ちます。

メモリ設定

memory.enabled

永続メモリの有効化・無効化。

openclaw config set memory.enabled true

memory.provider

使用するメモリバックエンド。

openclaw config set memory.provider "supermemory"

値：built-in、supermemory。

ツール＆権限

tools.elevated

昇格ツールアクセス（ファイルシステム、シェルコマンド）の有効化。

openclaw config set tools.elevated true

tools.browser

ブラウザ自動化機能の有効化。

openclaw config set tools.browser true

設定管理コマンド

# すべての設定を表示
openclaw config list

# 特定の設定を取得
openclaw config get gateway.mode

# 値を設定
openclaw config set gateway.mode "local"

# 設定を削除
openclaw config unset gateway.token

# 設定全体を検証
openclaw config validate

# デフォルトにリセット
openclaw config reset

# 設定ファイルのパスを表示
openclaw config path

環境変数によるオーバーライド

一部の設定は環境変数で設定可能で、openclaw.json より優先されます：

よくある設定パターン

最小セットアップ

{
  "ai": {
    "model": "claude-sonnet-4-6",
    "apiKey": "sk-ant-..."
  },
  "gateway": {
    "mode": "local"
  }
}

Telegram付き

{
  "ai": {
    "model": "claude-sonnet-4-6",
    "apiKey": "sk-ant-..."
  },
  "gateway": {
    "mode": "local",
    "token": "fixed-token-here"
  },
  "telegram": {
    "token": "123456:ABC-DEF...",
    "allowedUsers": [12345678]
  }
}

リバースプロキシの背後

{
  "ai": {
    "model": "claude-sonnet-4-6",
    "apiKey": "sk-ant-..."
  },
  "gateway": {
    "mode": "local",
    "token": "fixed-token-here",
    "trustedProxies": ["127.0.0.1"]
  }
}

変更後は検証を

編集後は必ず検証してください：

openclaw config validate

またはdoctorで問題を検出：

openclaw doctor

設定不要のセットアップ

ClawTank はこれらの設定をすべて自動的にプリ設定します。openclaw.json の編集不要 ─ デプロイして、Telegramを接続して、AIエージェントの使用を開始するだけです。