OpenClaw 接入自定义模型并通过 WebUI 配置

关键参数说明

重要提示：providers 配置完成后，必须同步配置 agents.defaults.model.primary 字段，否则 OpenClaw 无法知道应该使用哪个模型作为默认主模型。

providers 内部参数说明

接入模型 LongCat

LongCat 平台介绍

LongCat 是一个美团开发的大语言模型，同时提供了 API 开放平台，提供高性能的通用对话模型和深度思考模型。目前平台支持以下模型：

账号注册与 API Key 获取

1. 访问 LongCat 开放平台 注册账号
2. 新用户注册后可获得 500 万 Token 的免费使用额度
3. 进入 API Keys 页面 创建并获取 API Key
4. 在 用量信息页面 可随时查看 Token 消耗情况

完整配置示例

以下配置参考自 LongCat OpenClaw 配置文档，展示了如何完整接入 LongCat 模型：

{"agents":{"defaults":{"model":{"primary":"longCat/LongCat-Flash-Chat"}},"models":{"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"}}]}}}}

配置说明：

• 将 YOUR_API_KEY_HERE 替换为从 LongCat 官网申请的实际 API Key
• contextWindow: 200000 表示支持 20 万 Token 的上下文窗口
• maxTokens: 8192 表示单次响应最大 Token 数
• 修改保存后配置立即生效，无需重启服务

GUI 界面配置方式

除了直接修改配置文件，也可以通过 Web 控制页面进行可视化配置：

1. 访问 http://127.0.0.1:18789 打开 OpenClaw Web 控制页面
2. 进入 Config → Models → Providers
3. 添加以下配置项：

注意事项

1. 配置文件位置：OpenClaw 的配置文件位于 ~/.openclaw/openclaw.json
2. WebUI 访问地址：默认访问地址为 http://127.0.0.1:18789
3. 通信协议：OpenClaw 使用 WebSocket 进行全双工通信。如需通过 Chrome 开发者工具调试接口，可连接 ws://127.0.0.1:18789/
4. 配置生效：修改 openclaw.json 后保存即可立即生效，无需重启 Gateway 服务

参考

• OpenClaw 模型提供商快速入门
• OpenClaw 模型提供商配置文档
• LongCat 开放平台
• LongCat OpenClaw 配置指南
• LongCat API Keys 管理页面