OpenClaw 安装步骤(Windows + 千问 Token Plan)
这份说明按实际安装时走过的流程整理。系统是 Windows x64,模型是阿里云百炼 Token Plan(中国区),密钥和 cc-switch 里用的是同一把。
文档里没有写入 API 密钥。密钥截图里只保留了圆点。报错截图里的配置片段在原图中已是 [REDACTED]。
1. 安装桌面版
在 PowerShell 里安装官方 Windows 配套应用 OpenClaw Companion:
powershell
winget install --id OpenClaw.OpenClawCompanion -e --accept-package-agreements --accept-source-agreements --disable-interactivity
这次装的是 2026.11.3。装完后开始菜单里有 OpenClaw Companion。程序目录在:
%LOCALAPPDATA%\OpenClawTray
第一次打开会进入 OpenClaw Setup。
2. 选择电脑工具
第一步是「你的助手能用这台电脑上的哪些功能」。

选 Balanced(推荐)。它包含:系统工具、画布、截屏、文字转语音、语音转文字。
另外两个开关:
- Node mode:保持打开。这台电脑的能力通过 Gateway 提供给助手。
- Local MCP Server:保持关闭。那是给 Claude Desktop 这类本机客户端用的,不经过 OpenClaw Gateway。
然后点 设置 Gateway。
权限档位以后可以改:
| 档位 | 能做什么 |
|---|---|
| Strict | 画布和截屏,不能执行命令 |
| Balanced | 命令、画布、截屏、语音 |
| Open | 上面全部,再加上摄像头、定位、浏览器控制 |
3. 设置 Gateway
这台电脑是第一次安装,没有已经在跑的 Gateway。窗口里 本机原生 Gateway 标成推荐时,选它。
| 选项 | 做什么 | 什么时候选 |
|---|---|---|
| 本机原生 Gateway | 直接在 Windows 里跑,不用 Linux | 这台电脑自己用,选项可用时选这个 |
| 本机 Gateway(WSL) | 新建一个名叫 OpenClawGateway 的 Linux 环境,不改原来的系统 |
原生选项是灰的,或明确要 Linux |
| 连接已有 Gateway | 这台电脑不再安装 Gateway | 已经在别的机器或云上跑着 Gateway |
这台电脑没有安装 WSL。原生选项可用时不要选 WSL。
4. 连接千问
OpenClaw 不会读取 cc-switch 的配置,密钥要再贴一次。

下面这些都不要选,它们不是千问:
- Codex login
- OpenRouter OAuth
- xAI OAuth
- Anthropic Claude CLI
Qwen Token Plan (China) 和 Qwen Token Plan (Global/Intl) 这次也不要选。

点 China 那一项后,向导会先要求安装插件。弹窗标题如果是国际版,不要提交。

随后向导会把默认模型设成 qwen-token-plan/qwen3.7-plus,但当前 Gateway 装不上新版千问插件,实际用的是 @openclaw/qwen-provider@2026.11.1。旧插件的模型目录里没有这个模型,于是报:
Unknown model: qwen-token-plan/qwen3.7-plus

列表里也可能直接退回供应商列表,并提示刷新后重选。

密钥会保存成功,列表里出现多条 Saved qwen-token-plan sign-in。那几条是同一把密钥重复保存的。

再点 使用此模型 还会同样失败。

改用 Custom OpenAI/Anthropic-compatible endpoint。不要用下面的 API 密钥下拉框。

5. 自定义接口怎么填
按向导出现的顺序填。
- 密钥保存方式选 Paste API key now ,再提交。
Use external secret provider 是给环境变量或外部密钥库用的,这次不用。

- API Key 填 cc-switch 里 Token Plan 那把密钥,开头是
sk-sp-。
普通sk-开头的百炼按量密钥不能用。其他中转站的密钥也不能用。

- Endpoint compatibility 选 OpenAI-compatible (走
/chat/completions)。
不要选 Anthropic-compatible,也不要选 OpenAI Responses-compatible。

- Model ID 填
qwen3.7-max。这是 cc-switch 里实际请求的模型名,不要加qwen/或qwen-token-plan/前缀。

- Endpoint ID 保持自动生成的名字。这次是
custom-token-plan-cn-beijing-maas-aliyuncs-com。这只是本地名字,不是请求地址。

- Model alias 可以留空。想在列表里好认,就填
qwen3.7-max。不要填示例里的local或ollama。

对应的请求地址是:
https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
向导在选 OpenAI-compatible 之后会带上这个地址。如果某一页要求手填 Base URL,就填上面这一条,末尾不要加斜杠。
6. 和 cc-switch 的地址区别
cc-switch 当前接口格式是 Anthropic Messages。只写域名时,会提示找不到模型列表端点。

Anthropic 地址要带 Claude 兼容路径:
https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic
这个地址经常不提供模型目录,「获取模型列表」失败也可以直接保存。cc-switch 里已经手填了 qwen3.7-max。
两套地址不能混用:
| 用在哪 | 协议 | 地址 |
|---|---|---|
| cc-switch | Anthropic | https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic |
| OpenClaw 自定义接口 | OpenAI | https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 |
密钥两边相同,都必须是 sk-sp- 开头的 Token Plan 专用密钥。Coding Plan、按量付费、Token Plan 的密钥和地址要成套使用,不能交叉。
如果要在 cc-switch 里自动拉模型列表,把 API 格式改成 OpenAI 兼容,地址用上面 OpenClaw 那条。
7. 这次遇到的报错
提供商无法激活此模型 / Unknown model: qwen-token-plan/qwen3.7-plus
原因是登录已保存,但供应商目录里没有 qwen3.7-plus。继续点已保存的登录解决不了。改走第 5 节的自定义接口,模型 ID 用 qwen3.7-max。
cc-switch:未找到可用的模型列表端点
原因是 Base URL 只有域名,而页面格式是 Anthropic。补上 /apps/anthropic。列表仍拉不下来时,保留手填的 qwen3.7-max 后保存。
安装插件弹窗 Qwen Token Plan (Global/Intl)
那是国际版套餐,地址不在北京。国内 Token Plan 不要提交这个弹窗。这次最终也没有依赖这个插件完成连接。