OpenClaw 設定參考：每個 openclaw.json 設定項完整說明

所有 OpenClaw 設定項集中在一處。當你配置 openclaw.json 或執行 openclaw config set 指令時，可以用這篇文章作為參考。

設定檔在哪裡？

openclaw config path

預設位置：~/.openclaw/openclaw.json

Docker 容器中：/app/data/openclaw.json

Gateway 設定

Gateway 是 OpenClaw 的核心程序，處理來自所有用戶端（瀏覽器、Telegram、API）的連線。

gateway.mode

必填。 控制 gateway 如何接受連線。

openclaw config set gateway.mode "local"

若未設定此項，gateway 將拒絕啟動並顯示 gateway start blocked。

gateway.host

Gateway 綁定的主機名稱或 IP。

openclaw config set gateway.host "localhost"

預設值：localhost。如果需要從其他機器存取 gateway，請設為 0.0.0.0。

gateway.port

Gateway 監聽的連接埠。

openclaw config set gateway.port 3001

預設值：3001。如果有連接埠衝突，請更改此值。

gateway.token

用於 gateway 驗證的固定 token。防止重啟時重新產生 token。

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

如果未設定，OpenClaw 每次重啟都會產生新的 token——這會使所有已連線的裝置失效。

替代方式： 透過環境變數 OPENCLAW_GATEWAY_TOKEN 設定。

gateway.trustedProxies

OpenClaw 應信任的反向代理 IP 位址，用於處理轉發的標頭。

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

使用反向代理時必填（Caddy、Nginx、Traefik）。若未設定，當連線經由代理轉發時，OpenClaw 無法驗證連線是否確實來自 localhost。

gateway.bind

要綁定的網路介面。

openclaw config set gateway.bind "127.0.0.1"

預設值：127.0.0.1（僅 loopback）。設為 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

每次回應的最大 token 數。

openclaw config set ai.maxTokens 4096

較高的值允許更長的回應，但費用也更高。

Telegram 設定

telegram.token

你從 BotFather 取得的 Telegram bot token。

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

telegram.allowedUsers

允許與 bot 互動的 Telegram 使用者 ID 清單。

openclaw config set telegram.allowedUsers '[12345678]'

如果未設定，任何找到你 bot 的人都可以使用它。

MCP Server 設定

mcpServers

Model Context Protocol server（外掛）的設定。

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

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

每個 MCP server 在 mcpServers.<name> 下都有自己的子設定。

記憶設定

memory.enabled

啟用或停用持久記憶。

openclaw config set memory.enabled true

memory.provider

要使用哪個記憶後端。

openclaw config set memory.provider "supermemory"

可用值：built-in、supermemory。

工具與權限

tools.elevated

啟用進階工具存取（檔案系統、shell 指令）。

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 助手。