OpenClaw 接入自定义模型及 WebUI 智能操作实战

配置要点

注意：providers 配置完成后，必须同步配置 agents.defaults.model.primary 字段，否则 OpenClaw 无法识别默认主模型。

providers 内部参数说明

接入 LongCat 模型

平台介绍

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

账号注册与 API Key 获取

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

完整配置示例

以下配置展示了如何完整接入 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 数
• 修改保存后配置立即生效，无需重启服务

WebUI 可视化配置

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

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

运行效果

启动后 AgentModel 会显示为我们自定义的 LongCat-Flash。

询问具备的能力与使用的模型时，系统能正确识别当前接入的模型。

完成本地桌面文件查找任务，验证了模型在实际操作中的可用性。

注意事项

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 管理页面