OpenClaw 多模型接入与优化配置指南

1. 准备工作：获取核心凭证

在修改配置文件之前，请确保你已经从模型供应商后台获取了正确的凭证：

• API Key：你的个人调用秘钥（例如火山引擎和 Moonshot 的 Key）。

2. 配置文件拆解与标准写法

为了保证系统的安全性和整洁度，OpenClaw 推荐采用**“凭据与模型参数分离”**的架构。

2.1 凭据管理：auth-profiles.json

作用：集中统一存放所有敏感的 API Key，防止泄露。 路径：通常与你的 agent 配置在同级目录。 标准写法：

2.2 模型参数定义：models.json (或 openclaw.json 中的 models 模块)

作用：定义模型的技术规格。这里不应包含任何 API Key。 标准写法示例：

2.3 设置主模型与别名：openclaw.json

作用：在主配置文件中，告诉系统默认使用哪个模型，并为它们起个好记的名字。 标准写法示例：

3. 常见报错与排查手册

4. 关键参数科普备忘录

• api: "openai-completions"：告诉 OpenClaw 用 OpenAI 的通用数据格式与这些国产大模型进行通信。

• reasoning: true / false：控制系统是否要在界面上专门折叠/处理 AI 的“内部思考过程”。仅对自带 <think> 标签的模型（如 DeepSeek-R1）开启。

• contextWindow：模型的最大记忆容量，数值越大，能一次性吃透的超长文档越多（但超过限制系统会自动遗忘最早的对话）。

• maxTokens：限制模型单次开口说话的最大字数，防止 AI 陷入死循环乱花钱。

配置修改完毕后，请使用 openclaw gateway restart 重启服务。