OpenClaw 配置教程

Claw 接入龙虾接口平台配置教程

这次不是在后台点按钮，而是直接改 OpenClaw 的配置文件。只要地址、Key、模型名、JSON 格式任意一项写错，都可能导致当前 Claw 无法正常工作。所以这版单页重点讲清楚 3 件事：改哪个文件、改哪 3 个对象、怎么复制配置片段。页面中的接入域名已经统一改成当前正式地址 api.yaps.cn。

主配置文件

/root/.openclaw/openclaw.json

开始前先做两件事

1）先备注并备份当前配置因为这次是直接改 Claw 模型配置文件，不是简单在后台填表。只要 JSON 写错，当前 Claw 就可能起不来。

2）准备好平台提供的 3 个值Base URL、API Key、模型名。如果平台没特别说明，模型先用 gpt-5.4。

开始前至少准备：Base URL、API Key、模型名。并记住两条规则：api 推荐写 openai-responses，baseUrl 一般直接写到 /v1。

这次主要改哪个文件

主配置文件

/root/.openclaw/openclaw.json

有些环境还会有单独模型文件

/root/.openclaw/agents/main/agent/models.json

优先修改 openclaw.json。只有在特殊环境里，才再去看单独模型文件。

这次重点只改 3 处

1）models.providers新增一个 provider，告诉 OpenClaw：新的模型从哪里来。

2）agents.defaults.model.primary把默认主模型切到新的 provider/model。

3）agents.defaults.models把这个模型声明为当前 agent 可用模型，否则可能不可选或行为异常。

如果你只改了 primary，没有补 agents.defaults.models，后面很容易出现模型不可选、行为异常、切换失败等问题。

直接复制区

下面是你最需要直接复制的内容：provider 配置、primary 切换、defaults.models 补充条目，以及一条最稳的备份命令。

1）备份原配置

cp /root/.openclaw/openclaw.json /root/.openclaw/openclaw.json.bak-$(date +%F-%H%M%S)

2）新增 provider 的参考片段

"token-forward-local": {
  "baseUrl": "https://api.yaps.cn/v1",
  "apiKey": "你的sk-proj-xxxx",
  "api": "openai-responses",
  "models": [
    {
      "id": "gpt-5.4",
      "name": "GPT-5.4 via token_forward",
      "reasoning": false,
      "input": ["text"],
      "cost": {
        "input": 0,
        "output": 0,
        "cacheRead": 0,
        "cacheWrite": 0
      },
      "contextWindow": 272000,
      "maxTokens": 8192,
      "api": "openai-responses"
    }
  ]
}

3）切默认主模型

"primary": "token-forward-local/gpt-5.4"

4）补 defaults.models 条目

"token-forward-local/gpt-5.4": {}

5）最短填写规则

Base URL：https://api.yaps.cn/v1
API Key：平台给你的 sk-proj-...
Model：gpt-5.4
api：openai-responses

按对象解释，每个参数怎么填

对象 / 字段	作用	推荐填写
models.providers	声明模型来源集合	新增一个 provider，例如 token-forward-local
baseUrl	接口根地址	https://api.yaps.cn/v1
apiKey	访问凭证	平台给你的真实 sk-proj-...
api	协议类型	openai-responses
id	模型真实 ID	gpt-5.4
name	显示名称	自己能认出来就行，例如 GPT-5.4 via token_forward
reasoning	是否启用 reasoning 标记	false
input	输入类型	["text"]
cost	本地成本展示字段	当前不做价格统计可全部填 0
contextWindow	上下文窗口	272000
maxTokens	单次最大输出 token	8192
agents.defaults.model.primary	默认主模型	token-forward-local/gpt-5.4
agents.defaults.models	声明 agent 可用模型	"token-forward-local/gpt-5.4": {}

如果你把 provider 名改成了别的，比如 longxia-provider，那么后面的 primary 和 defaults.models 也要同步改成同一个名字。

Windows 修改步骤

第 1 步：备份先把 openclaw.json 复制为 openclaw.json.bak。如果有 agents\main\agent\models.json，也一并备份。

第 2 步：打开文件用 VS Code / Notepad++ 打开 openclaw.json。

第 3 步：改 3 处新增 provider、切 primary、补 defaults.models。

第 4 步：保存并检查格式重点检查花括号、逗号、引号是否正确。

第 5 步：重启并验证重启 OpenClaw / Gateway，确认能正常启动、能正常回复。

这版教程的核心不是“告诉你概念”，而是让你能直接照抄配置片段和步骤，所以前面的复制区可以直接用。