很多人把 OpenClaw 装好之后，第一件事是打开配置页面，然后愣在那里。
屏幕上列着一堆名字：Claude、GPT、DeepSeek、Gemini、Qwen……每一个都听说过，每一个都不知道该选哪个。随手填一个 API Key，跑起来发现响应很慢，或者任务老是执行到一半就断掉，然后开始怀疑是不是自己部署出了问题。
其实问题不在部署。问题在模型。
先理解一件事：OpenClaw 本身没有大脑
OpenClaw只是一个框架。它负责接收你的指令、拆解任务、调用工具、执行操作，但真正思考的那部分，完全依赖你配置的 AI 模型。
你可以把它想象成一辆车，模型是发动机。车架再好，装一台小摩托的发动机，跑不快，也爬不了坡。
所以模型选错了，会发生什么？
指令理解偏差，任务执行到一半走歪
长对话之后开始失忆，前面说过的事情忘了
遇到网页里的恶意内容，被注入了奇怪的指令
工具调用出错，发了一封不该发的邮件
这些不是小概率事件。OpenClaw 的 Agent 循环会持续运行，一个判断失误，后面的动作全部跟着跑偏。
模型配置的入口在哪里
在 OpenClaw 中配置接入的大模型，主要通过openclaw models 命令族完成。以下是完整流程（以 Qwen 为例，也适用于其他支持的提供商如 OpenAI、Anthropic、Gemini 等）：
1. 查看已支持的模型提供商
openclaw models list-providers
输出示例：
qwen-portal Qwen (Tongyi Qianwen) — requires OAuth
openai OpenAI GPT series
anthropic Claude series
google Gemini series
local Local LLMs (via Ollama, LM Studio, etc.)
提示：OpenClaw 支持插件式模型后端，可通过openclaw plugins list 查看是否安装了额外模型适配器。
2. 为某提供商登录认证（以 qwen-portal 为例）
openclaw models auth login --provider qwen-portal
会打开浏览器或提示输入Access Token / Refresh Token
Qwen 需要从DashScope 控制台 获取 API Key（注意：OpenClaw 使用的是 OAuth 流，部分版本也可能支持 API Key 模式，取决于 acp 配置）
若提示refresh token expired（如您当前遇到的），说明旧 token 失效，必须重新登录。
3. 验证认证状态
openclaw models auth status --provider qwen-portal
成功时应显示：
Provider: qwen-portal
Status: authenticated
Expires: 2026-03-20T08:00:00Z
4. 设置默认模型（可选）
编辑~/.openclaw/config.yaml 或运行：
openclaw config set model.default qwen-portal/coder-model
# 或
openclaw config set model.vision qwen-portal/vision-model
也可在单次调用中指定模型：
openclaw agent run --model qwen-portal/coder-model "写一个Python快速排序"
5. （高级）自定义模型路由 / 代理
若需通过本地代理（如localhost:8000/v1）接入私有模型，可配置：
~/.openclaw/models/qwen-portal.yaml
endpoint: http://localhost:8000/v1
api_key: sk-xxx
headers:
Authorization: Bearer sk-xxx
然后重启 OpenClaw Gateway（或重载配置）生效。
