OpenClaw 安装步骤

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. 自定义接口怎么填

按向导出现的顺序填。

  1. 密钥保存方式选 Paste API key now ,再提交。
    Use external secret provider 是给环境变量或外部密钥库用的,这次不用。
  1. API Key 填 cc-switch 里 Token Plan 那把密钥,开头是 sk-sp-。
    普通 sk- 开头的百炼按量密钥不能用。其他中转站的密钥也不能用。
  1. Endpoint compatibility 选 OpenAI-compatible (走 /chat/completions)。
    不要选 Anthropic-compatible,也不要选 OpenAI Responses-compatible。
  1. Model ID 填 qwen3.7-max。这是 cc-switch 里实际请求的模型名,不要加 qwen/ 或 qwen-token-plan/ 前缀。
  1. Endpoint ID 保持自动生成的名字。这次是 custom-token-plan-cn-beijing-maas-aliyuncs-com。这只是本地名字,不是请求地址。
  1. 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 不要提交这个弹窗。这次最终也没有依赖这个插件完成连接。

相关推荐
Seiran12 分钟前
用Grok 4.7在ZEEKEAI啃长文档的提效实战
人工智能
Bacon15 分钟前
给项目做一次"全身 CT":Agent Skills 生态里的代码体检全链路
前端·人工智能·后端
培培说证17 分钟前
大专商务数据分析与应用可以报考哪些职业证书?
人工智能·数据挖掘·数据分析
pursuit_c20 分钟前
关于 Personal Agent 的思考碎片
人工智能
龙腾AI白云26 分钟前
具身智能的空间导航与未知环境探索
大数据·数据库·人工智能·机器学习·知识图谱
snakeshe101034 分钟前
大模型 Function Call 实战入门:原理、环境搭建与多轮调用完整教程
人工智能
用户3600555790035 分钟前
Kestrel_VLLM - 43 · 默认化前的一次解耦:一个遮蔽 bug 与一次口径污染
人工智能
狒狒AI42 分钟前
DeepSeek Harness 插件生态拆解:31,259 个仓库与 93% 装不上的口径差
人工智能
AI前端工程狮43 分钟前
我把 MCP 长任务拆成三个工具,token 账单涨了 7 倍
javascript·人工智能·程序员