OpenClaw 配置文件详解

配置文件位于 ~/.openclaw/openclaw.json，以下是一份完整的参考模板，附带每个字段的说明。

完整配置参考

{
  "meta": {
    "lastTouchedVersion": "2026.3.7",
    "lastTouchedAt": "2026-03-08T18:02:22.355Z"
  },

  "wizard": {
    "lastRunAt": "2026-03-08T07:14:06.984Z",
    "lastRunVersion": "2026.3.2",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },

  "browser": {
    "enabled": true,
    "executablePath": "/usr/bin/google-chrome-stable",
    "headless": true,
    "noSandbox": true
  },

  "auth": {
    "profiles": {
      "anthropic:default": {
        "provider": "anthropic",
        "mode": "api_key"
      }
    }
  },

  "models": {
    "mode": "merge",
    "providers": {
      "custom-proxy": {
        "baseUrl": "https://code.aipor.cc",
        "apiKey": "anthropic兼容的接口",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "claude-opus-4-6",
            "api": "anthropic-messages",
            "reasoning": true,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 180000,
            "maxTokens": 32000
          },
          {
            "id": "claude-sonnet-4-6",
            "name": "claude-sonnet-4-6",
            "api": "anthropic-messages",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      },
      "custom-openai": {
        "baseUrl": "https://code.aipor.cc/v1",
        "apiKey": "codex分组key",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.4",
            "name": "gpt-5.4",
            "api": "openai-responses",
            "reasoning": true,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  },

  "agents": {
    "defaults": {
      "model": {
        "primary": "custom-openai/gpt-5.4"
      },
      "models": {
        "custom-proxy/claude-opus-4-6": {},
        "custom-openai/gpt-5.4": {
          "params": {
            "reasoning": {
              "effort": "xhigh"
            }
          }
        }
      },
      "workspace": "/workspace",
      "contextPruning": {
        "mode": "cache-ttl",
        "ttl": "1h"
      },
      "compaction": {
        "mode": "safeguard"
      },
      "thinkingDefault": "xhigh",
      "verboseDefault": "on",
      "heartbeat": {
        "every": "30m"
      }
    },
    "list": [
      {
        "id": "main",
        "model": "custom-proxy/claude-opus-4-6"
      }
    ]
  },

  "tools": {
    "profile": "full",
    "web": {
      "search": {
        "provider": "brave",
        "apiKey": "你的Brave搜索API密钥"
      }
    }
  },

  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },

  "session": {
    "dmScope": "per-channel-peer"
  },

  "channels": {
    "feishu": {
      "enabled": true,
      "domain": "feishu",
      "accounts": {
        "main": {
          "appId": "你的飞书AppID",
          "appSecret": "你的飞书AppSecret"
        }
      },
      "dmPolicy": "open"
    }
  },

  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "allowedOrigins": [
        "http://localhost:18789",
        "http://127.0.0.1:18789",
        "http://你的服务器IP:18789"
      ],
      "dangerouslyDisableDeviceAuth": false
    },
    "auth": {
      "mode": "token",
      "token": "你的网关认证Token"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },

  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
    }
  }
}

字段说明

models — 模型配置

agents — Agent 配置

agents.list — Agent 列表

{
  "id": "main",
  "model": "custom-proxy/claude-opus-4-6"
}

每个 Agent 可以指定不同的模型。main 是默认的主 Agent。

gateway — 网关配置

channels — 消息平台

目前支持：feishu、telegram、discord、whatsapp、signal、slack、line

飞书配置需要：
- appId — 飞书开放平台的应用 ID
- appSecret — 应用密钥
- dmPolicy — open 允许所有人私聊

tools — 工具配置

browser — 浏览器配置

{
  "enabled": true,
  "executablePath": "/usr/bin/google-chrome-stable",
  "headless": true,
  "noSandbox": true
}

服务器环境建议开启 headless 和 noSandbox。

小贴士

1. cost 全设 0：如果用自建代理，费用设为 0 避免误报
2. reasoning: true：开启后支持 Claude 的扩展思考功能
3. heartbeat：建议 30 分钟，太频繁会浪费 token
4. 多模型切换：可以在 agents.list 中配置多个 Agent 使用不同模型
5. 修改后重启：openclaw gateway restart

有配置问题欢迎回帖讨论！