OpenClaw 接入自定义模型并通过 WebUI 实现智能操作

这里有几个关键点需要注意：

1. primary 字段是必填的，格式必须是 提供商名称/模型 ID，且必须与下方 providers 里定义的键名对应。
2. mode 设为 merge 表示在现有配置上追加，replace 则是完全覆盖。通常建议用 merge 避免误删其他配置。
3. 配置完 providers 后，千万别漏掉同步修改 agents.defaults.model.primary，否则系统不知道该调用哪个模型。

实战：接入 LongCat 模型

LongCat 是美团开发的大模型，提供了高性能的通用对话和深度思考能力。目前平台支持 Flash 系列和 Lite 系列等多种模型，均兼容 OpenAI/Anthropic 格式。

准备工作

首先需要在 LongCat 开放平台注册账号。新用户通常有免费额度，记得去 API Keys 页面生成密钥。

配置文件编写

下面是接入 LongCat 的具体配置示例。将 YOUR_API_KEY_HERE 替换为你实际申请的 Key 即可：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "longCat/LongCat-Flash-Chat"
      },
      "workspace": "/Users/user/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "longCat": {
        "baseUrl": "https://api.longcat.chat/openai",
        "apiKey": "YOUR_API_KEY_HERE",
        "api": "openai-completions",
        "authHeader": true,
        "models": [
          {
            "id": "LongCat-Flash-Chat",
            "name": "LongCat-Flash-Chat",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "compat": {
              "maxTokensField": "max_tokens"
            }
          }
        ]
      }
    }
  }
}

这里特别留意一下 contextWindow 和 maxTokens 的设置，这决定了上下文长度和单次响应的上限。保存文件后配置会立即生效，不需要重启 Gateway 服务。

使用 WebUI 可视化配置

如果你不想直接改 JSON，也可以通过 Web 界面操作。启动服务后访问 http://127.0.0.1:18789，进入 Config → Models → Providers 菜单。

按照以下对应关系填写表单：

• Api: openai-completions
• Api Key: 你的 LongCat 密钥
• Base Url: https://api.longcat.chat/openai
• models - id / name: LongCat-Flash-Chat

填完后保存，刷新页面就能看到 AgentModel 显示为你设置的 LongCat 模型。你可以试着问它具备哪些能力，或者让它帮你查找本地文件，验证连接是否正常。

调试与注意事项

在实际使用中，有几个细节容易踩坑：

1. 配置文件路径：通常在 ~/.openclaw/openclaw.json，不同系统可能略有差异。
2. 通信协议：OpenClaw 底层使用 WebSocket 全双工通信。如果需要抓包调试接口，可以连接 ws://127.0.0.1:18789/。
3. 权限问题：确保你有权限读取工作目录下的文件，否则 Agent 无法执行本地任务。

参考资料

• OpenClaw 模型提供商快速入门
• OpenClaw 模型提供商配置文档
• LongCat 开放平台
• LongCat OpenClaw 配置指南