1. 为什么 Windows 小白也需要一个能“动手干活”的 AI 助手
很多人对 AI 的印象还停留在“网页里聊天、帮我写两段文案”。但真正能改变办公效率的,是那种能直接在你电脑上读文件、改表格、跑脚本、发消息的 AI 助手。OpenClaw 就是这样一个开源的个人 AI 助手网关,它把大模型能力和你的 Windows 电脑连在一起,让 AI 从“只会说”变成“能动手”。
我第一次接触 OpenClaw 的时候,最直观的感受是:它不像一个软件,更像一个住在你电脑里的数字员工。你在飞书、钉钉、Telegram 里发一句话,它在后台调用大模型理解意图,然后通过模拟键鼠、执行命令、读写文件来完成任务。比如让它找一份桌面上的文档并发到微信文件传输助手,或者写一个 HTML 简历页面并自动在本地跑起来,这些都不是演示视频里的特效,而是可以真实复现的操作。
但问题也很明显:对零基础用户来说,Windows 上装环境、配模型、做内网穿透,每一步都可能卡住。Node.js 版本不对、PowerShell 禁止脚本、API Key 填错、cpolar 域名 24 小时变一次、公网访问提示 origin not allowed……这些坑我几乎全踩过。所以这篇文章不打算讲原理,而是直接给你一条从零到跑通的路径:装好 OpenClaw、接上 TaoToken 统一 Key、用 cpolar 穿透到公网、最后验证 AI 对话和办公任务是否真的跑通。
适合谁看?如果你用的是 Windows 10 或 Windows 11,没写过代码,但愿意复制粘贴命令,想拥有一个能远程指挥的 AI 办公助手,那这篇就是为你写的。整个过程不需要你理解大模型推理机制,也不需要买云服务器,跟着步骤走就行。
核心检索词先明确:Windows 一键部署 OpenClaw、TaoToken 接入 AI 办公、cpolar 内网穿透远程访问。这三个词贯穿全文,你可以在每一步里找到对应的可复制操作。
2. TaoToken 前置准备:统一 Key 与模型接入配置
OpenClaw 本身只是一个网关,它需要一个大模型来当“大脑”。你可以把它理解成一台没有装 SIM 卡的手机,硬件都在,但打不了电话。TaoToken 在这里扮演的角色,就是给你一张能通多个模型的“统一 SIM 卡”:一个 API Key,一套 Base URL,就能调用多种模型,不用在多个平台之间来回注册、充值、复制密钥。
我试过在 OpenClaw 里分别接不同厂商的 API,最大的麻烦是每换一个模型就要改一次配置,而且有些平台的 Key 格式、接口路径还不一样。TaoToken 的好处是它兼容 OpenAI 风格的接口,OpenClaw 的自定义 Provider 可以直接填。你只需要拿到三样东西:Base URL、API Key、Model ID。这三件套在后面配置 OpenClaw 和排查错误时都会反复用到。
先访问 TaoToken 官网注册账号:https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。注册完成后进入控制台,找到 API Keys 页面创建一个新的 Key。创建时建议起一个能识别的名字,比如 openclaw-win,方便以后区分。复制出来的 Key 通常以 sk- 开头,只显示一次,先粘贴到记事本里备用。
接下来确认 Base URL。TaoToken 的 API 地址是 https://taotoken.net/api ,注意这里不要加任何多余路径,OpenClaw 的 OpenAI-compatible 模式会自动拼接 /v1/chat/completions。如果你填成 https://taotoken.net/api/v1 反而可能重复,导致 404。这一点我在第一次配置时就搞错了,后面排障章节会详细说。
Model ID 需要根据你实际想用的模型来填。进入模型对话页面可以查看当前可用的模型列表:https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。选一个适合日常办公和代码任务的模型,把它的完整 ID 复制下来。注意 Model ID 是区分大小写的,复制时不要多带空格。
如果你打算长期用 OpenClaw 做编码和 Agent 任务,可以了解一下 Coding Plan:https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。它更适合高频调用场景,比按量计费更可控。不过对于第一次跑通流程来说,先用普通 API Key 验证即可。
这里给一个配置对照表,后面写 openclaw.json 时会直接用到:
| 配置项 | 填写内容 | 说明 |
|---|---|---|
| Base URL | https://taotoken.net/api | 不要加 /v1 |
| API Key | sk- 开头的字符串 | 从控制台复制 |
| Model ID | 模型列表中的完整 ID | 区分大小写 |
| 接口类型 | OpenAI-compatible | OpenClaw 默认支持 |
注意:API Key 等同于你的账户凭证,不要写进公开的代码仓库,也不要发给别人。后面 cpolar 穿透到公网后,网关令牌同样要保管好。
拿到这三件套之后,先别急着装 OpenClaw。你可以打开 TaoToken 的模型对话页面,发一条“你好,请用一句话介绍你自己”,确认 Key 本身是有效的。如果这里就报 401,那说明 Key 复制错了或者账户没激活,先解决这一步,再去折腾 OpenClaw,能省掉很多无效排查。
3. Windows 一键部署 OpenClaw 与可复制配置
这一章是全文的核心操作部分。我会按“装环境 → 跑脚本 → 改配置 → 接 TaoToken”的顺序来写,每一步都给出可复制的命令和配置文件片段。你不需要理解每条命令背后的原理,照着做就行。
3.1 安装 Node.js 和 Git
OpenClaw 依赖 Node.js 22 及以上版本,同时需要 Git 来拉取源码。官方一键脚本虽然能自动装,但网络不稳定时容易卡住,所以我建议手动装。
先装 nvm-windows,它是 Node.js 的版本管理器。打开 https://github.com/coreybutler/nvm-windows/releases ,下载 nvm-setup.exe,双击安装。安装路径建议选 D:\nvm,Node.js 下载位置也放在 D:\nvm 下。一路 Next 到 Install 即可。
安装完成后,打开 D:\nvm\settings.txt,粘贴以下两行,然后 Ctrl+S 保存:
node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/这两行是国内镜像源,能明显加快下载速度。接着按 Win+R 输入 cmd,执行:
nvm -v nvm install 22 nvm use 22.20.0 node -v npm -v如果 node -v 输出 v22.x.x,说明环境好了。Git 安装更简单,打开 https://cn-git.com/downloads/ 下载安装包,一路 Next,最后用 git --version 验证。
3.2 解决 PowerShell 脚本限制并一键安装
按 Win+X 选择“终端”或“PowerShell”。如果提示“在此系统上禁止运行脚本”,先执行:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser然后执行官方一键脚本:
iwr -useb https://openclaw.ai/install.ps1 | iex安装过程中会进入交互式配置。按左右键选择 Yes 同意风险,选择 QuickStart 快速开始。到了选择 AI 大脑供应商的页面,不要选内置平台,直接选 Custom Provider,这样才能填 TaoToken 的地址。
3.3 写入 openclaw.json 接入 TaoToken
配置向导走完后,OpenClaw 会生成配置文件,路径通常是:
C:\Users\你的用户名\.openclaw\openclaw.json用记事本打开它,找到模型配置部分,改成下面这样。注意把 apiKey 换成你自己的,model 换成你要用的 Model ID:
{ "models": { "providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "api": "openai-completions", "models": [ { "id": "你的Model ID", "name": "taotoken-model", "contextWindow": 200000, "maxTokens": 8192 } ] } } }, "gateway": { "controlUi": { "allowedOrigins": [] } } }这里有两个参数特别关键:contextWindow 和 maxTokens。默认值往往只有 4096,导致你问稍微长一点的问题就报上下文超限。改成 200000 和 8192 之后,日常办公对话和代码任务基本够用。改完保存,重启 OpenClaw 网关。
如果你用的是 Claude Code 或类似工具,配置逻辑是一样的三件套:Base URL 填 https://taotoken.net/api ,Key 填 TaoToken 的 Key,Model ID 填模型列表里的完整 ID。不要只填一半,否则会出现 OAuth 或 401 类错误。
3.4 验证配置是否生效
回到 OpenClaw 的 Web UI,发一条测试消息:
你好,你是谁?你当前运行在什么操作系统上?接入你的大模型是什么?请详细回答。如果它能正确说出运行在 Windows、并且能识别你配置的模型,说明 TaoToken 接入成功。如果报错,先看下一章的排查对照表。
4. cpolar 内网穿透:让 OpenClaw 公网可访问
本地跑通之后,OpenClaw 默认只能在局域网访问。你出门在外,手机连的是 4G/5G,就和家里的电脑不在同一个内网,直接访问 127.0.0.1:18789 是打不开的。cpolar 的作用就是把你本地的 18789 端口映射到一个公网 HTTPS 地址,让你随时随地都能连回来。
4.1 安装并登录 cpolar
打开 https://www.cpolar.com/download 下载 64-bit 安装包,解压后一路默认安装。安装完成后在 cmd 里执行:
cpolar version能看到版本号就说明装好了。接着去 cpolar 官网注册账号,然后在浏览器访问 http://127.0.0.1:9200 ,用刚注册的账号登录 Web UI。
4.2 创建隧道映射 18789 端口
登录后点击左侧“隧道管理 → 隧道列表”,编辑默认的 website 隧道,或者新建一条。关键参数如下:
| 参数 | 填写值 |
|---|---|
| 隧道名称 | openclaw |
| 协议 | http |
| 本地地址 | 18789 |
| 地区 | China Top |
保存后进入“状态 → 在线隧道列表”,你会看到一条 https 开头的公网地址,类似 https://xxxx.r3.cpolar.cn 。复制这个地址,在浏览器打开。
4.3 解决 origin not allowed 报错
第一次访问公网地址,大概率会看到:
origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)这是因为 OpenClaw 默认只允许本地来源访问控制界面。解决办法是回到本地 OpenClaw 聊天窗口,直接对它说:
我将 OpenClaw 的 WebUI 18789 端口通过 cpolar 穿透到公网了,域名是 https://你的cpolar地址,访问提示 origin not allowed,请帮我修改 openclaw.json 中的 gateway.controlUi.allowedOrigins,把这个域名加进去,然后重启网关。它会自动改配置并重启。你也可以手动改 openclaw.json:
"gateway": { "controlUi": { "allowedOrigins": [ "https://你的cpolar地址" ] } }改完后刷新公网页面,origin 错误会消失,但会出现新的提示:pairing required。这是设备配对机制,需要你在本机终端执行:
openclaw devices list openclaw devices approve <requestId>把 list 里显示的 requestId 替换进去。执行完再回到公网页面,填入网关令牌,健康状态就会变成“正常”,对话也能正常用了。
4.4 固定二级子域名(可选)
免费版 cpolar 的域名大约每 24 小时变一次,长期用不方便。你可以在 cpolar 后台“预留”页面保留一个二级子域名,比如 openclaw,然后把隧道编辑为“二级子域名”类型,填入保留的名称。更新后公网地址就变成 https://openclaw.cpolar.top 这种固定形式。记得同样要把新域名加进 allowedOrigins,否则又会报 origin not allowed。
5. 常见报错排查:401、local proxy failed、reading choices、OAuth
这一章按真实报错来写,你遇到问题时可以直接对照。每个错误我都给出原因和可复制的修复动作。
5.1 401 Unauthorized
报错长这样:
401 Unauthorized: invalid api key原因通常是 API Key 复制错了、多了空格、或者账户没有可用额度。先回到 TaoToken 控制台重新复制一次 Key,确认以 sk- 开头。然后检查 openclaw.json 里的 apiKey 字段有没有被引号包住、有没有换行。改完重启网关。如果还是 401,去模型对话页面发一条消息,确认 Key 本身有效。
5.2 local proxy failed / connection refused
报错:
local proxy failed: dial tcp 127.0.0.1:18789: connect: connection refused这说明 OpenClaw 网关没启动,或者端口不是 18789。先在 PowerShell 执行:
openclaw gateway status如果没有运行,执行 openclaw gateway start。如果端口被占用,检查 openclaw.json 里的 gateway.port 配置,并同步修改 cpolar 隧道的本地地址。
5.3 reading choices / unexpected end of JSON
报错:
error reading choices: unexpected end of JSON input这通常是因为 Base URL 填错了。很多人会填成 https://taotoken.net/api/v1 ,导致实际请求路径变成 /api/v1/v1/chat/completions,返回的不是标准 JSON。正确写法是 https://taotoken.net/api ,让 OpenClaw 自己拼接。改完保存重启。
5.4 OAuth / authentication failed
报错:
OAuth authentication failed如果你用的是 Claude Code 或类似工具,出现 OAuth 错误往往是因为只填了 Key 没填 Base URL,或者 Model ID 写错。记住三件套必须同时正确:
| 配置项 | 正确值 |
|---|---|
| Base URL | https://taotoken.net/api |
| API Key | sk- 开头 |
| Model ID | 模型列表完整 ID |
三个都填对之后,OAuth 类错误基本不会再出现。如果还报错,检查配置文件路径是否正确,Windows 下是 C:\Users\你的用户名.openclaw\openclaw.json,注意不要写成 admin.openclaw 这种少了反斜杠的路径。
5.5 上下文超限 / context length exceeded
报错:
context length exceeded, max tokens 4096这就是前面提到的默认配置问题。打开 openclaw.json,把 contextWindow 改成 200000,maxTokens 改成 8192,保存重启。如果模型本身支持更长上下文,可以再调大,但不要超过模型上限。
6. 验证 AI 对话与办公任务是否跑通
配置改完不算跑通,真正要验证的是两件事:AI 能不能正常对话,以及它能不能真的操作你的电脑完成任务。
先做对话验证。在 OpenClaw Web UI 或公网地址里发:
你好,请告诉我你当前运行在什么系统,接入的是哪个模型,并帮我列出当前桌面上的前五个文件。如果它能正确回答系统信息,并且真的列出桌面文件,说明模型接入和本地文件读取都正常。这一步很关键,因为很多配置错误在纯聊天时看不出来,一旦涉及文件操作就会暴露。
再做办公任务验证。给它一个具体指令:
帮我在 D 盘新建一个 resume 文件夹,写一个个人简历的 HTML 页面放进去,然后用本地服务器跑起来,给我一个能访问的地址。观察它是否依次完成:创建目录、写文件、启动服务、返回地址。如果中间某一步失败,它会告诉你原因,你根据报错回到第 5 章排查。
最后做公网验证。用手机断开 WiFi,只用流量,打开 cpolar 生成的 https 地址,输入网关令牌,发一条消息。如果能正常收到回复,说明内网穿透和远程访问都通了。这时候你就拥有了一个真正随时随地可用的 AI 办公助手。
注意:OpenClaw 拥有读取文件和模拟键鼠的权限,穿透到公网后务必保管好网关令牌,不要发到公开群组。如果只是自己用,建议定期更换 Token。
走到这一步,你已经完成了从 Windows 一键部署 OpenClaw、TaoToken 统一 Key 接入、cpolar 内网穿透到公网访问的完整链路。后面想扩展能力,可以在 OpenClaw 里继续配置飞书、钉钉等消息平台,或者接入更多模型。遇到新报错时,优先检查三件套:Base URL、API Key、Model ID,这三个对了,大部分问题都能解决。