OpenClaw 模型更换实战指南：从 DeepSeek 到 Kimi 再到 GLM-5 的真实记录

本文基于我在 macOS 上通过 Docker 部署 OpenClaw 的真实经历撰写，记录了多次更换模型的完整过程，包括遇到的坑和解决方案。无论你是想换用更新的模型，还是切换不同的提供商，这篇文章都能帮你少走弯路。

智谱 AI GLM 教程

OpenClaw 作为一个强大的 AI 智能体框架，支持多种模型提供商（如硅基流动、智谱官方、OpenAI 兼容等）。在实际使用中，我们可能因为模型性能、成本或新模型发布而需要更换默认模型。然而，直接修改配置往往不够，因为 OpenClaw 的模型管理涉及配置文件结构、权限、安全策略等多方面因素。本文将以我最近将默认模型从硅基流动的 DeepSeek-V3 切换为智谱 GLM-5 的过程为例，详细拆解每一步操作，并附上真实遇到问题的解决方法。

在动手更换模型前，建议先确认当前环境，并做好备份。

1.1 查看当前版本和模型列表

进入容器（注意：以下命令均在宿主机执行，除非特别说明）：

记录当前默认模型（通常是标记为 的那个）：

1.2 备份配置文件

配置文件位于数据卷 下的 。建议将其备份到宿主机：

1.3 确保容器正常运行

如果容器当前未运行，先启动：

无论你选择哪个新模型，都需要明确以下三点：

• 提供商 ID：例如 （硅基流动）、（智谱官方）、 等。
• API 基础地址：例如硅基流动为 ，智谱官方为 。
• 模型 ID：必须与提供商平台上的 ID 一致。例如硅基流动上 GLM-5 的 ID 为 ，智谱官方上可能为 。

查找方法：

• 如果是通过硅基流动使用，可登录 硅基流动控制台，在“模型广场”找到目标模型的 ID。
• 如果是智谱官方，参考其文档或平台上的模型名称。

添加模型有两种方式：手动编辑配置或通过向导添加。根据我的经验，手动编辑更灵活，不易出错，尤其当你要将模型加入已有提供商时。

3.1 手动添加模型（推荐）

假设你要将 GLM-5 添加到现有的 提供商中（共用同一套 API 密钥和基础地址）。

1. 进入容器（以 root 用户，便于后续修改权限）：

1. 查看当前 的配置（确认已有模型列表）：

输出类似：

1. 更新 数组，追加新模型。将原配置的 列表复制出来，加上新模型的对象，然后用 写回。例如添加 GLM-5（注意模型 ID 为 ）：

注意：这里的 和 可根据模型文档填写，即使不精确也不影响基本使用。

1. 验证模型是否成功添加：

应该能看到新模型出现，例如 。

3.2 通过向导添加（适合新提供商）

如果你想添加一个全新的提供商（例如直接使用智谱官方 API），可以运行：

按提示输入：

• Token provider：选择 或 。
• Provider id：输入标识符，如 。
• Base URL：输入对应 API 地址。
• API Key：粘贴你的密钥。
• Default model：输入模型 ID（如 ）。

添加后，模型会出现在列表中，但需要留意：新提供商的模型 ID 格式为 ，例如 。

添加完成后，将默认模型指向新模型：

验证默认模型已更改：

应输出 或类似。

5.1 重启 OpenClaw

5.2 查看启动日志，确认新模型加载

应显示 。

5.3 在 UI 中测试

打开浏览器访问 ，进入 Chat 界面发送消息，观察是否正常回复。

6.1 更新模型后容器无法启动，报错 “non-loopback Control UI requires gateway.controlUi.allowedOrigins”

原因：新版 OpenClaw 加强了安全策略，当通过局域网 IP 访问时，需要明确配置允许的来源。
解决：

6.2 配置文件权限错误（EACCES）

现象：容器启动日志提示 。
原因：之前以 root 用户修改过文件，导致文件所有者变为 root，而 OpenClaw 进程以 UID 10001 运行。
解决：

然后重启原容器。

6.3 添加模型时提示 “Config validation failed: models.providers.siliconflow.models: expected array”

原因：手动设置时 JSON 格式不正确，或遗漏了 数组。
解决：严格按照已有配置的结构编写，确保 是数组，且每个元素包含必要字段（如 、、、、）。

6.4 模型调用时返回 500 或 “API rate limit reached”

原因：

• 提供商账户余额不足或免费额度耗尽。
• API 密钥无效或权限不足。
  解决：
  
• 登录对应平台检查余额和密钥状态。
• 更换有效密钥并更新配置：

6.5 升级 OpenClaw 时因 SSH 客户端缺失失败

现象：执行 报错 。
原因：某个依赖包通过 SSH 协议从 GitHub 拉取，容器内缺少 SSH 客户端。
解决：

更新后重启容器。

6.6 安全提醒：密钥泄露风险

在配置过程中，API 密钥可能通过命令行历史、日志或屏幕截图泄露。务必：

• 定期更换密钥。
• 使用 而非直接编辑 JSON 文件。
• 备份后删除含密钥的终端历史。

更换 OpenClaw 的默认模型并不复杂，但涉及配置文件、权限、安全策略等多个细节。通过本文的步骤，你应该能够顺利地将模型切换到心仪的新版本。记住，每一次操作前备份配置、操作后验证日志，是避免问题的关键。

如果你在更换模型时遇到其他未列出的问题，欢迎查阅官方文档或在社区中提问。祝你在 OpenClaw 的世界里玩得开心！