OpenClaw · 手动配置​

配置文件与格式​

默认文件为 ~/.openclaw/openclaw.json，格式是 JSON5，支持注释与尾逗号。OPENCLAW_CONFIG_PATH 可指向其他真实文件；官方文档不建议把配置路径做成符号链接，因为 OpenClaw 的原子写入可能替换链接本身。

OpenAI 兼容 custom provider​

只有网关明确支持对应协议时才添加 custom provider。下面使用 OpenClaw 官方文档记录的 openai-completions schema；foropencode.com 是第三方网关：

// ~/.openclaw/openclaw.json
{
  models: {
    mode: "merge",
    providers: {
      foropencode: {
        baseUrl: "https://foropencode.com/v1",
        apiKey: "${FOROPENCODE_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gateway-model-id", name: "gateway-model-id" },
        ],
      },
    },
  },
  agents: {
    defaults: {
      model: { primary: "foropencode/gateway-model-id" },
    },
  },
}

export FOROPENCODE_API_KEY="sk-xxx"

如果网关只支持 Responses 或其他协议，必须使用 OpenClaw 与网关双方当前文档共同支持的 api 值；不要把协议名称当成可随意互换的标签。

Anthropic 兼容 custom provider​

OpenClaw 官方 custom provider schema也支持 anthropic-messages。只有第三方端点明确实现当前 Anthropic Messages 行为时才使用：

{
  models: {
    mode: "merge",
    providers: {
      gatewayClaude: {
        baseUrl: "https://foropencode.com",
        apiKey: "${FOROPENCODE_ANTHROPIC_KEY}",
        api: "anthropic-messages",
        models: [
          { id: "gateway-model-id", name: "gateway-model-id" },
        ],
      },
    },
  },
  agents: {
    defaults: {
      model: { primary: "gatewayClaude/gateway-model-id" },
    },
  },
}

模型元数据​

contextWindow、contextTokens、maxTokens、input 和兼容性字段均可影响运行行为。OpenClaw 官方文档允许 custom provider 省略部分元数据并使用默认值；只有得到模型或网关正式资料时才手写，不要从截图或其他 provider 复制。

OpenAI 当前 OpenClaw fresh setup 可使用 openai/gpt-5.6，Anthropic 官方 provider 示例包括 anthropic/claude-opus-5，但这些官方 provider 事实不证明第三方网关提供同名模型。可用 openclaw models list --provider <provider> 核对当前账户和安装的实际列表。

热重载​

OpenClaw Gateway 会监视 ~/.openclaw/openclaw.json。默认 hybrid 模式会立即应用安全变更，并为需要重启的关键变更自动重启；大多数设置无需手工杀进程。

{
  gateway: {
    reload: { mode: "hybrid", debounceMs: 300 },
  },
}

如果日志出现 config reload skipped (invalid config)，当前运行时会保留最后一次有效配置。先修复 JSON5 或 schema，再用官方命令/服务管理方式重启；不要用 pkill -f 或 Stop-Process -Force 作为默认配置步骤。

验证​

1. 运行 openclaw models list --provider <provider> 查看实际模型
2. 查看 Gateway 日志是否接受新配置
3. 从不含敏感数据的最小请求开始
4. 401 检查环境变量；403 向网关确认鉴权；400 检查协议兼容性
5. Dashboard 默认只应绑定在预期接口；向外网暴露前阅读官方 Gateway 安全文档

资料来源：OpenClaw Configuration↗ · Model providers↗ · openclaw/openclaw↗（2026-07-26 核对）