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

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

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

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

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

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

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

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

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

1.2 备份配置文件

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

1.3 确保容器正常运行

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

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

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

查找方法：

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

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

3.1 手动添加模型（推荐）

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

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

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

输出类似：

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

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

验证模型是否成功添加：

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

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 的世界里玩得开心！