外观

OpenClaw 接入 ​

把 MoaCode 的模型接入 OpenClaw。本文以 GPT 模型（Codex 渠道，/v1/responses 协议）为例。

要点速览

  • Base URL：https://moacode.org/v1（末尾必须带 /v1）
  • 接口格式：openai-responses
  • 模型 ID 以模型目录实际显示为准

一、创建 API-Key ​

  1. 打开 Moacode 官网 注册账号完成订阅充值后，进入接口管理，点击创建。 image.png

  2. 选择提供商以及模型，完成后点击创建，API-KEY 创建完成（注意：请妥善保管你的 API-Key！！） image.png

二、确认信息 ​

在开始配置前，先把以下 3 个信息确认齐全，后续步骤会逐一用到。

名称示例说明
API-Key示例：cr-121231313...接口鉴权凭证，用于身份验证，请替换为自己的真实 api-key
Base URLhttps://moacode.org/v1接口请求的基础地址，不用修改
Model IDgpt-5.3-codex你要调用的具体模型标识

注意：

  • Base URL 末尾必须带 /v1，这是配置时常见的漏填问题。
  • 模型 ID 可以在 Moacode 网站的模型目录中查看，请务必以真实 ID 为基准，不区分大小写将会报错！ image.png

三、找到本机的配置文件 ​

1. 不同系统默认路径如下 ​

image.png

Windows 示例如下：image.png

2. 文件不存在怎么处理 ​

如果找不到 .openclaw 目录，说明 OpenClaw 还没有完成初始化。

处理方法： 在终端中执行一次 OpenClaw 启动命令，程序会自动创建默认配置目录和配置文件，之后再回来继续下面的步骤。

四、修改 OpenClaw 配置文件 ​

用 VS Code、记事本或任意文本编辑器打开 openclaw.json，找到 models 字段中的 "providers" 和 "agents" 进行修改（Ctrl+F 快速查找定位）。注意根据自己需求修改配置，修改完成之后，直接将该代码块复制到 "providers" 和 "agents" 相应文段中即可。

1. 具体示例 ​

配置 Moacode 中的 gpt-5.3-codex 模型：

json
"custom-moacode-org": {
  "baseUrl": "https://moacode.org/v1",
  "apiKey": "你自己的API-KEY",
  "api": "openai-responses",
  "models": [
    {
      "id": "gpt-5.3-codex",
      "name": "gpt-5.3-codex (Moacode)",
      "reasoning": false,
      "input": ["text"],
      "cost": {
        "input": 0,
        "output": 0,
        "cacheRead": 0,
        "cacheWrite": 0
      },
      "contextWindow": 32000,
      "maxTokens": 4096
    }
  ]
},

2. 字段解释 ​

字段说明
custom-moacode-org配置的标识名称，可以自行更改
baseUrl接口请求地址，固定为 https://moacode.org/v1，不用修改
apiKey你的身份密钥，需要填写在 Moacode 平台获取的真实 API Key，用于鉴权
api使用的接口格式，openai-responses 表示采用 OpenAI 新版 Responses 接口规范，可以固定不修改，也可以尝试 openai-completions
models模型配置列表，可配置一个或多个模型
id模型调用名称，软件实际传给接口的模型名，需要替换为平台支持的真实模型
name模型显示名称，只在软件界面展示，可自定义修改
reasoning是否开启推理模式，false 为普通模型，true 适用于带思考能力的模型
input支持的输入类型，["text"] 代表仅支持文本输入
cost计费相关配置，各项为 0 代表不统计、不显示调用费用
contextWindow上下文窗口大小，代表模型能记住的最大上下文 token 数
maxTokens单次回复最大生成 token 数，限制单次回答的长度上限

3. 配置 agents 字段 ​

下滑找到 agents 字段，添加模型信息：

  • primary：默认模型，格式为 标识名称/模型名称
  • fallback：备用模型，格式同样为 标识名称/模型名称
  • models：所有配置的模型列表

⚠️ 一定注意标点符号，末尾的逗号，最后一个模型信息结尾没有逗号。

json
"agents": {
  "defaults": {
    "model": {
      "primary": "custom-moacode-org4/gpt-5.4-mini",
      "fallbacks": [
        "custom-open-bigmodel-cn/glm-5",
        "glm-4-5-air/glm-4.5-air",
        "custom-moacode-org/gpt-5.3-codex",
        "custom-moacode-org3/gpt-5",
        "custom-moacode-org2/gpt-5.4"
      ]
    }
  },
  "models": {
    "custom-open-bigmodel-cn/glm-5": 0,
    "glm-4-5-air/glm-4.5-air": 0,
    "custom-moacode-org/gpt-5.3-codex": 0,
    "custom-moacode-org2/gpt-5.4": 0,
    "custom-moacode-org3/gpt-5": 0,
    "custom-moacode-org4/gpt-5.4-mini": 0
  },
  "compaction": {
    "mode": "safeguard"
  },
  "maxConcurrent": 4,
  "subagents": {
    "maxConcurrent": 8
  }
}

4. 修改完成后，保存前逐项检查 ​

  • [ ] API Key 已填写完整，无多余空格
  • [ ] Base URL 末尾包含 /v1
  • [ ] Model ID 完全填写正确
  • [ ] 确保文件格式完整，没有漏掉引号、逗号或括号

💡 可以把修改好的内容粘贴到 jsonlint.com 进行格式校验，排除 JSON 语法错误导致的配置不生效问题。

五、重启服务并验证配置生效 ​

1. 重启步骤 ​

配置文件保存后，必须重启 OpenClaw 服务，修改才会生效。
在终端中依次执行 openclaw gateway 命令，确认服务正常运行。

2. 验证方式 ​

方式 A： 在 OpenClaw 页面直接发一条消息
发一句简单的问题，例如「你好，请介绍你自己」，能正常返回内容则链路完全可用。

方式 B： 查看调用日志
查看近期的使用日志，出现模型调用记录即代表接口通畅。

六、常见报错速查 ​

一般错误为接口格式配置有误，注意接口格式，如果是 openai-completions，可改为 openai-responses。

❌ 401 Unauthorized（鉴权失败） ​

API Key 无效或已过期。

处理方法： 检查 API Key 是否正确填写，确认没有多余空格，重新复制粘贴后重启服务。

❌ insufficient_quota（配额不足） ​

当前账户余额或模型调用配额已耗尽。

处理方法： 登录控制台检查余额，充值后重试。如果只是验证链路是否正常，也可以先切换到轻量模型进行测试。

❌ model not found（模型未找到） ​

模型 ID 填写有误，或当前账号没有该模型的调用权限。

处理方法： 回到控制台，重新复制 Model ID，粘贴替换配置文件中的内容，保存后重启服务。

❌ 改完配置，但没有任何变化 ​

按以下顺序逐项排查：

  1. 确认修改的是 OpenClaw 当前读取的配置文件，路径是否正确
  2. 确认已执行重启命令，不能只保存文件
  3. 检查 JSON 格式是否正确，特别是逗号、引号、括号的完整性
  4. 查看启动日志，确认是否有报错信息

七、配置完成后的稳定性建议 ​

跑通之后，养成以下几个小 tips 可以有效降低后续使用风险：

1. 防护方面 ​

  • 不要把含有 API Key 的配置文件上传到公开平台
  • 测试环境和生产环境分别使用独立的 Key，出问题时方便单独处理
  • 日志记录时对 Key 做隐私处理，只显示前几位加星号，避免信息泄露

2. 稳定性方面 ​

  • 配置一个备用模型，主模型不可用时自动切换，减少停机影响
  • 定期检查 Key 有效期和账户余额，避免在关键节点突然断服

八、常用命令速查 ​

命令说明
openclaw onboard初始化配置向导
openclaw gateway前台启动网关
openclaw gateway start启动网关守护进程
openclaw dashboard打开 Web 控制面板
openclaw status查看运行状态
openclaw doctor诊断系统环境
openclaw configure修改配置（API Key、渠道等）
openclaw update更新到最新版本
openclaw logs查看运行日志
openclaw hooks list查看所有 Hooks
openclaw hooks enable <name>启用指定 Hook
openclaw hooks disable <name>禁用指定 Hook
openclaw security audit --deep深度安全审计
openclaw daemon install安装后台守护进程
openclaw daemon uninstall卸载后台守护进程

如果完成以上配置且无误，那么恭喜你成功迈出最重要的一步，下面请开始你的养虾之旅吧！

MoaCode — One key. Every coding agent.

© 2026 MoaCode