一、配置说明

本文描述了完成OpenClaw对接免费第三方API（api.rcouyi.com） 的完整配置，配置后可正常启动OpenClaw网关并使用自定义模型ouyi-openclaw，该模型无调用成本（输入输出费用均为0），满足日常AI助理使用需求。

二、API-Key 获取过程

此处补充api.rcouyi.com平台的注册、令牌创建、API-Key复制等完整步骤

1. 登录https://api.rcouyi.com/，点击右上角注册，使用邮箱完成账户注册；
2. 点击上方“控制台”，选择左侧“令牌管理”；
   
3. 会弹出窗口提示充值，直接取消即可；
4. 点击创建令牌KEY，令牌名称自定，令牌分组选默认，过期时间永不过期，授权额度点无限额度；
   
5. 高级设置中，模型授权选择"ouyi-openclaw"，务必注意之选这一个，其他的会收费;
   
6. 其他不填，提交保存；
7. 创建好的令牌会在页面中显示，点击ApiKey右侧的小图标，即可复制；
   > 8. 至此，令牌创建已经完成。

三、OpenClaw 完整配置文件

配置文件路径：~/.openclaw/openclaw.json
将以下内容完整替换原有文件，注意替换自身的API-Key和网关token（下述为示例配置，需保留格式）：

{
  "gateway": {
    "mode": "local"
    },
  "agents": {
    "defaults": {
      "model": { 
        "primary": "custom-proxy/ouyi-openclaw" 
      },
      "models": {
        "custom-proxy/ouyi-openclaw": {}
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "custom-proxy": {
        "baseUrl": "https://api.rcouyi.com/v1",
        "apiKey": "sk-xxx(写入上一步骤中获取的api-key)",
        "api": "openai-completions",
        "models": [
          {
            "id": "ouyi-openclaw",
            "name": "ouyi-openclaw",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 128000,
            "maxTokens": 32000
          }
        ]
      }
    }
  }
}

四、核心操作命令

1. 打开配置文件目录

终端执行命令，快速进入OpenClaw配置文件所在文件夹：

open ~/.openclaw

2. 重启OpenClaw网关

修改配置文件后，必须执行以下命令重启网关使配置生效：

openclaw gateway

3. 验证OpenClaw安装/运行状态

# 验证安装版本
openclaw --version
# 启动交互式配置向导（如需重新配置时使用）
openclaw onboard

五、配置生效验证

执行openclaw gateway启动网关后，OpenClaw会自动调用默认浏览器打开网关界面，验证以下两点即代表配置成功：

1. 网关界面显示Health OK；
2. 聊天窗口可正常发起对话，模型默认使用custom-proxy/ouyi-openclaw。

六、注意事项

1. 请妥善保存API-Key和网关token，避免泄露；
2. 若配置后网关无法启动，优先检查openclaw.json的JSON格式是否正确（无多余逗号、括号配对）；
3. 若API调用失败，检查API-Key是否有效、网络是否能正常访问https://api.rcouyi.com/v1；
4. 该配置为本地部署模式（gateway.mode: local），仅本机可访问网关，如需远程访问可修改网关配置。