模型是 OpenClaw 的心脏，这颗心脏是可换的。这篇记录我真实换过一次心脏、踩过一次鉴权坑、测明白多模态边界的经过。

为什么换：一笔账

我原来默认 DeepSeek。8/17 起它峰谷定价大涨，V4-Flash 高峰输出到 9 元/百万 token，比原来 2 元翻了 3.5 倍。9 月 3 日我把默认切到阿里云百炼的 qwen3.8-flash：输入约 ¥1.09、输出约 ¥3.43 每百万 token，全天一口价，高峰时段比 DeepSeek 便宜约 3 倍。这种"按账换模型"的事，OpenClaw 里就是改配置+重启网关的十分钟工作量。

接一个新 provider 的正确姿势（含大坑）

先说坑，这是我付出过整份配置挂掉的坑：我试图把 API key 明文写进 openclaw.json 的 auth.profiles——schema 校验直接 invalid，整个配置加载失败，网关起不来。

正确姿势是走 CLI 注册，key 不进配置文件正文：

echo <你的key> | openclaw models auth paste-api-key --provider qwen --profile-id qwen:default

注册完随时可回退：聊天里 /model DeepSeek 一句话切回旧主力，旧 provider 配置我原样保留没动。改配置前的备份（openclaw.json.bak-20260903）是惯例。

接百炼注意 baseURL 走 compatible-mode（OpenAI 兼容端点）。还有个时效坑：DashScope 专属域名迁移公告里旧接入点 9/30 起不支持新特性，我在 9/24 就把 baseURL 换成专属 MaaS 域名、重启网关，9/30 抽查确认无恙。国产模型的坑往往不在 OpenClaw，在服务商的域名和鉴权策略上。

盘点：openclaw models list

9/3 实测输出很有意思：我手动配置的只有 2 providers / 3 模型（qwen3.8-flash 默认、deepseek-chat、deepseek-reasoner），但列表总共显示 10 个——deepseek 插件带出 2 个，claude-cli 系带出 5 个（需要 Claude Code 登录态才能真正用）。插件和内置会往模型池里加东西，看得见不等于使得动，排查模型问题先看这张表。

多模态边界：图片能看，视频要曲线

  • 图片：原生能看。 模型直连后，我发截图它能直接解析（实测解析过一段 Python 调用代码截图）。
  • 视频：官方通道没打通，但我有土办法。 模型原生直喂需要公网 URL，本地文件走不通。我的流程：Python OpenCV 均匀抽 7 帧 → image 工具逐帧分析，实测把一段 31.7 秒竖屏视频完整还原了内容（画面里小孩干了什么都有）。另外我在模型定义里声明 input: video，models list 依然只显示 text+image——说明 OpenClaw 原生大概率不吃这个声明，声明了也无害但无用。土办法比假配置可靠。

收尾：把 thinking 关掉省钱

切到 flash 档模型后，9/25 我把 agents.defaults.thinkingDefault 设为 off（改完重启网关生效），再配合输出上限 8192 tokens——日常消息不该有的长思考一秒都不多烧。模型选择的本质是给不同的活配不同的价，这跟第六篇的降本是一套账。

「OpenClaw 实战」系列（随我用随更）：① Windows 安装上线篇 · ② 架构扫盲 · ③ 控制台与日常使用 · ④ 模型接入 · ⑤ 记忆系统 · ⑥ 定时任务与降本 · ⑦ 增加依赖