OpenClaw 框架支持通过配置文件或 GUI 界面灵活配置 LLM 模型。详细说明如何修改 openclaw.json 接入第三方模型，以 LongCat 为例展示 baseUrl、apiKey 及 models 参数设置方法。提供 WebUI 可视化配置路径及效果验证步骤，帮助用户快速完成智能代理的模型切换与本地文件操作测试。
OpenClaw（原 Clawdbot）是一个开源的 AI 代理框架，支持通过配置文件或 GUI 界面进行灵活配置。安装 OpenClaw 后，用户可以通过修改工作目录下的配置文件 openclaw.json 来接入不同的 LLM 模型提供商。
OpenClaw 支持众多主流模型提供商，包括 OpenAI、Anthropic、Moonshot AI（Kimi）、OpenRouter、Vercel AI Gateway、Amazon Bedrock 等。完整的提供商目录可参考官方文档 模型提供商快速入门。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
要使用自定义的提供商，需要通过 models.providers 配置进行设置。这种方式允许用户接入官方支持列表之外的其他兼容 OpenAI API 或 Anthropic 格式的模型服务。
OpenClaw 的模型配置主要分为两个部分：models 字段用于定义提供商和模型信息，agents.defaults 用于设置默认使用的模型。
以 Kimi（Moonshot AI）为例，完整的 JSON 配置如下：
{"agents":{"defaults":{"model":{"primary":"moonshot/kimi-k2.5"}}},"models":{"mode":"merge","providers":{"moonshot":{"baseUrl":"https://api.moonshot.ai/v1","apiKey":"${MOONSHOT_API_KEY}","api":"openai-completions","models":[{"id":"kimi-k2.5","name":"Kimi K2.5"}]}}}}
| 参数 | 位置 | 说明 |
|---|---|---|
primary | agents.defaults.model | 必填。指定默认使用的主模型，格式为 提供商/模型 ID。必须与 providers 中配置的提供商名称和模型 ID 对应 |
mode | models | 配置模式，merge 表示合并到现有配置，replace 表示完全替换 |
providers | models | 定义模型提供商的配置集合，每个键值对代表一个提供商 |
重要提示：providers 配置完成后，必须同步配置 agents.defaults.model.primary 字段，否则 OpenClaw 无法知道应该使用哪个模型作为默认主模型。
| 参数 | 说明 |
|---|---|
baseUrl | 模型 API 的基础 URL 地址 |
apiKey | 认证密钥，支持环境变量引用格式 ${ENV_NAME} 或直接填写 |
api | API 类型，通常为 openai-completions 表示兼容 OpenAI 格式 |
models | 该提供商支持的模型列表，包含模型的 id 和 name |
LongCat 是一个美团开发的大语言模型，同时提供了 API 开放平台，提供高性能的通用对话模型和深度思考模型。目前平台支持以下模型：
| 模型名称 | API 格式 | 描述 |
|---|---|---|
| LongCat-Flash-Chat | OpenAI/Anthropic | 高性能通用对话模型 |
| LongCat-Flash-Thinking | OpenAI/Anthropic | 深度思考模型 |
| LongCat-Flash-Thinking-2601 | OpenAI/Anthropic | 升级版深度思考模型 |
| LongCat-Flash-Lite | OpenAI/Anthropic | 高效轻量化 MoE 模型 |
以下配置参考自 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 KeycontextWindow: 200000 表示支持 20 万 Token 的上下文窗口maxTokens: 8192 表示单次响应最大 Token 数除了直接修改配置文件，也可以通过 Web 控制页面进行可视化配置：
http://127.0.0.1:18789 打开 OpenClaw Web 控制页面| 配置项 | 值 |
|---|---|
| Api | openai-completions |
| Api Key | 你的 LongCat API Key |
| Base Url | https://api.longcat.chat/openai |
| models - id | LongCat-Flash-Chat |
| models - name | LongCat-Flash-Chat |
~/.openclaw/openclaw.jsonhttp://127.0.0.1:18789ws://127.0.0.1:18789/openclaw.json 后保存即可立即生效，无需重启 Gateway 服务