OpenClaw 安装步骤

0 阅读4分钟

OpenClaw 安装步骤(Windows + 千问 Token Plan)

这份说明按实际安装时走过的流程整理。系统是 Windows x64,模型是阿里云百炼 Token Plan(中国区),密钥和 cc-switch 里用的是同一把。

文档里没有写入 API 密钥。密钥截图里只保留了圆点。报错截图里的配置片段在原图中已是 [REDACTED]。

1. 安装桌面版

在 PowerShell 里安装官方 Windows 配套应用 OpenClaw Companion:

winget install --id OpenClaw.OpenClawCompanion -e --accept-package-agreements --accept-source-agreements --disable-interactivity

这次装的是 2026.11.3。装完后开始菜单里有 OpenClaw Companion。程序目录在:

%LOCALAPPDATA%\OpenClawTray

第一次打开会进入 OpenClaw Setup。

2. 选择电脑工具

第一步是「你的助手能用这台电脑上的哪些功能」。

01-选择电脑工具.png

选 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 的配置,密钥要再贴一次。

02-连接AI登录项.png

下面这些都不要选,它们不是千问:

  • Codex login
  • OpenRouter OAuth
  • xAI OAuth
  • Anthropic Claude CLI

Qwen Token Plan (China) 和 Qwen Token Plan (Global/Intl) 这次也不要选。

05-Token-Plan-China.png

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

03-安装千问插件.png

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

Unknown model: qwen-token-plan/qwen3.7-plus

07-未知模型报错.png

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

04-供应商无法激活.png

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

08-已保存登录.png

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

09-再次报错.png

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

10-自定义接口入口.png

5. 自定义接口怎么填

按向导出现的顺序填。

  1. 密钥保存方式选 Paste API key now,再提交。
    Use external secret provider 是给环境变量或外部密钥库用的,这次不用。

11-密钥保存方式.png

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

12-填写密钥.png

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

13-接口协议.png

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

14-模型ID.png

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

15-接口ID.png

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

16-模型别名.png

对应的请求地址是:

https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

向导在选 OpenAI-compatible 之后会带上这个地址。如果某一页要求手填 Base URL,就填上面这一条,末尾不要加斜杠。

6. 和 cc-switch 的地址区别

cc-switch 当前接口格式是 Anthropic Messages。只写域名时,会提示找不到模型列表端点。

06-cc-switch地址.png

Anthropic 地址要带 Claude 兼容路径:

https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic

这个地址经常不提供模型目录,「获取模型列表」失败也可以直接保存。cc-switch 里已经手填了 qwen3.7-max。

两套地址不能混用:

用在哪协议地址
cc-switchAnthropichttps://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic
OpenClaw 自定义接口OpenAIhttps://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 不要提交这个弹窗。这次最终也没有依赖这个插件完成连接。