AI精品店

Appearance

OpenClaw 手动配置（Codex） ​

手动编辑配置文件，适合已经熟悉 OpenClaw 基本用法、或者需要精确控制配置内容的用户。

还没装过 OpenClaw？

先运行官方一键安装，再回来配置：

bash
curl -fsSL https://openclaw.ai/install.sh | bash

你需要有 root 账号权限，如果没有权限可使用 sudo dseditgroup -o edit -a 【用户名】 -t user admin 后在执行安装脚本

配置文件在哪里？ ​

  • macOS / Linux：~/.openclaw/openclaw.json
  • Windows：C:\Users\你的用户名\.openclaw\openclaw.json （把 你的用户名 换成你实际的 Windows 登录名，例如 C:\Users\wuwen\.openclaw\openclaw.json）

如果文件不存在，先启动一次 OpenClaw 让它自动生成，或者手动创建这个名为openclaw.json的空文件

openclaw.json 完整结构说明 ​

配置文件是一个 JSON 对象，最多有以下 6 个顶层字段。你不需要全部写，按需填写即可。

json
{
  "models": {
    "mode": "merge",
    "providers": {
      "服务商名称": {
        "baseUrl": "API地址",
        "apiKey": "你的密钥",
        "api": "协议类型",
        "models": []
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "服务商名称/模型id",
        "fallbacks": ["备用服务商名称/模型id"]
      },
      "models": {
        "服务商名称/模型id": { "alias": "别名" }
      },
      "imageModel": {
        "primary": "服务商名称/模型id"
      },
      "thinkingDefault": "low",
      "verboseDefault": "off",
      "elevatedDefault": "on",
      "timeoutSeconds": 600,
      "contextTokens": 200000
    }
  },
  "gateway": {
    "mode": "local",
    "port": 18789,
    "auth": {
      "mode": "token",
      "token": "123456"
    }
  },
  "telegram": {
    "enabled": true,
    "botToken": "你的BotToken"
  },
  "memory": {},
  "session": {}
}

顶层字段说明 ​

models — 模型配置（最核心的部分）

  • mode：merge 表示和已有配置合并，replace 表示完全替换
  • providers：服务商列表，可以同时配置多个服务商
  • 每个服务商下：
    • baseUrl：API 地址
    • apiKey：你的密钥
    • api：调用协议，OpenAI GPT 模型必须用 openai-responses，Claude 用 anthropic-messages
    • models：该服务商下可用的模型列表

⚠️ GPT 模型必须使用 openai-responses 协议

这是高频问题！配置 codexzh（GPT 系列模型）时，api 字段必须填 openai-responses，不能填 openai。

  • openai-responses → 使用 OpenAI 新版 Responses API（POST /v1/responses）✅
  • openai → 使用旧版 Chat Completions（POST /v1/chat/completions）❌ GPT 模型不推荐

OpenAI 官方已推荐所有 GPT 模型迁移到 Responses API，性能更好、成本更低。

agents — 代理设置

  • defaults.model.primary：默认使用的模型，格式为 服务商名称/模型id
  • defaults.model.fallbacks：主模型不可用时的备用模型列表
  • defaults.models：为特定模型设置别名，方便在对话中切换（如 @gpt）
  • defaults.imageModel.primary：图像任务使用的模型（可与 primary 相同）
  • defaults.thinkingDefault：思维深度默认值，可选 "low" / "medium" / "high" / "auto"
  • defaults.verboseDefault：是否开启详细输出，"off" 关闭 / "on" 开启
  • defaults.elevatedDefault：提权模式（允许更高权限操作），"on" 开启 / "off" 关闭
  • defaults.timeoutSeconds：单次请求超时秒数，默认 600
  • defaults.contextTokens：上下文窗口大小（token 数），默认 200000

gateway — 网关设置

  • mode：local 表示本机运行
  • port：访问端口，默认 18789，一般不需要改
  • auth.token：访问令牌，自己设一个字符串

telegram — Telegram 通知（可选）

  • enabled：true 或 false
  • botToken：通过 @BotFather 创建获取
  • 不需要此功能可以删掉整个 telegram 块

memory / session — 记忆与会话配置（可选，留空或不写均可）

配置 codexzh（GPT 模型包月服务） ​

购买地址：codexzh

将以下内容写入（或合并到）你的 openclaw.json：

json
{
  "models": {
    "mode": "merge",
    "providers": {
      "codexzh": {
        "baseUrl": "https://api.codexzh.com/v1",
        "apiKey": "sk-你的密钥",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.3-codex",
            "name": "gpt-5.3-codex",
            "reasoning": true,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "gpt-5.4",
            "name": "gpt-5.4",
            "reasoning": true,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "codexzh/gpt-5.4",
        "fallbacks": ["codexzh/gpt-5.3-codex"]
      },
      "models": {
        "codexzh/gpt-5.4": { "alias": "gpt" }
      },
      "imageModel": { "primary": "codexzh/gpt-5.4" },
      "thinkingDefault": "low",
      "verboseDefault": "off",
      "elevatedDefault": "on",
      "timeoutSeconds": 600,
      "contextTokens": 200000
    }
  },
  "gateway": {
    "mode": "local",
    "port": 18789,
    "auth": {
      "mode": "token",
      "token": "123456"
    }
  },
  "telegram": {
    "enabled": true,
    "botToken": "你的BotToken"
  },
  "memory": {},
  "session": {}
}

字段说明：

  • codexzh：服务商自定义名称，建议和网站一致，后面引用模型时会用到（格式：codexzh/gpt-5.4）
  • baseUrl：https://api.codexzh.com/v1，末尾带 /v1
  • apiKey：登录 codexzh 控制台 后复制你的 API Key
  • api：填 openai-responses，这是 codexzh 使用的协议类型
  • models：列出你要用的模型，id 和 name 填一样的模型名即可
  • cost：全填 0，因为包月套餐不按 token 计费
  • agents.defaults.model.primary：设置默认模型，格式为 服务商名/模型id

写入步骤：

  1. 用文本编辑器打开 openclaw.json
  2. 如果文件为空（{}），直接粘贴上面完整内容
  3. 如果文件已有内容，将 providers 下的 codexzh 块合并进去，并更新 agents.defaults
  4. 保存文件
  5. 重启 gateway（见下方"修改配置后重启生效"）

字段说明：

  • ccodezh：服务商自定义名称
  • baseUrl：https://api.ccodezh.com，注意末尾没有 /v1
  • apiKey：登录 ccodezh 控制台 后复制你的 API Key
  • api：填 anthropic-messages，这是 Claude 系列使用的协议类型
  • models：推荐配置 -n 系列模型，价格更便宜且支持第三方调用
  • telegram.enabled：不需要 Telegram 通知时设为 false，或删掉整个 telegram 块

写入步骤：

  1. 用文本编辑器打开 openclaw.json
  2. 如果文件为空（{}），直接粘贴上面完整内容
  3. 如果文件已有内容，将 providers 下的 ccodezh 块合并进去，并更新 agents.defaults
  4. 保存文件
  5. 重启 gateway

服务商说明

  • codexzh 仅可使用 gpt 系列模型，详情查看 codexzh
  • ccodezh 仅可使用 claude 系列模型，详情查看 ccodezh
  • 两个站点的 key 无法共用，需要单独在各自站点购买后使用

修改配置后重启生效 ​

bash
# macOS / Linux / Windows（CMD）
openclaw gateway stop
openclaw gateway --port 18789

常用命令 ​

  • 启动 Web 服务（含管理界面）：
bash
openclaw gateway --port 18789
  • 启动纯 API 网关（不带 Web 界面）：
bash
openclaw gateway
  • 关闭 Web 服务：
bash
openclaw gateway stop
  • 清空配置：
bash
openclaw reset
  • 校验配置：
bash
openclaw doctor --fix