1. 为什么要在 Windows 上折腾 OpenClaw 电脑端部署OpenClaw 是最近在开发者圈子里被频繁提到的一个本地智能体运行框架它能让你在电脑上跑一个带工具调用能力的对话入口通过浏览器界面完成文件整理、命令执行、简单任务编排这类操作。和纯网页版对话不同OpenClaw 跑在你自己的机器上能直接读写本地目录、调用系统命令所以对 node.js、git、powershell 这些环境有硬性依赖。适合谁适合想在自己 Windows 电脑上体验本地 Agent、又不想一上来就买云服务器的人也适合已经有一堆 API Key、想找个统一入口管理模型调用的开发者。但真正动手时坑往往不在 OpenClaw 本身而在环境准备node.js 版本不对、git 没装导致依赖拉不下来、powershell 脚本执行策略被拦、openclaw-cn 配置时模型通道填错。我试过在一台干净的 Windows 11 上从零走一遍最耗时间的不是安装而是把模型通道统一到一个 Key 上。这篇就按“环境准备 → 安装 → 配置 → 启动验证 → 排错”的顺序把每一步的可复制命令和配置片段给全最后用 TaoToken 的统一 Key 把模型通道接上省得你在多个平台之间来回切。核心检索词先明确OpenClaw 电脑端部署、node.js 环境、git 安装、powershell 执行策略、openclaw-cn 配置、TaoToken 统一 Key。这几个词会贯穿全文你照着做就能在本地跑通一次完整启动。先说清楚整体链路OpenClaw 本体负责本地 Agent 调度模型调用走 OpenAI 兼容的 API 通道。TaoToken 提供的就是这个兼容通道一个 Key 可以调不同模型Base URL 固定Model ID 按需换。这样你就不用为每个模型单独配一套环境变量。下面进入实操。2. 前置准备node.js、git、powershell 环境一次装齐这一章把三个依赖装好顺序建议 node.js → git → powershell 策略调整。别跳步git 缺失会在 openclaw-cn 安装阶段报依赖拉取失败。2.1 node.js 安装与版本确认去 nodejs.org 下载 LTS 版本Windows 选.msi安装包一路下一步即可。安装完成后必须验证很多人装完没进 PATH 就直接跑 openclaw-cn结果报node 不是内部或外部命令。打开一个新的 powershell 窗口普通权限即可输入node -v npm -v正常输出类似v20.11.1和10.2.4。如果提示找不到命令说明安装时没勾选 “Add to PATH”重新运行安装包修复一下或者手动把 nodejs 安装目录加进系统环境变量。版本建议 node.js 18 以上OpenClaw 的部分依赖用了较新的 ESM 特性16 及以下容易在安装阶段报语法错误。npm 会随 node.js 一起装好不用单独处理。2.2 git 安装与验证git 的作用是让 openclaw-cn 在安装和更新时能拉取仓库依赖。去 git-scm.com 的 Windows 下载页拿安装包下载慢是常态多试几次或者换个时间段。安装时保持默认选项即可其中 “Adjusting your PATH environment” 选默认的 “Git from the command line and also from 3rd-party software”。装完同样开新窗口验证git --version输出git version 2.44.0.windows.1这类信息就对了。如果报错检查是否装到了非默认路径且没加 PATH。2.3 powershell 执行策略调整OpenClaw 的安装脚本是.ps1文件Windows 默认执行策略会拦截。手动搜索 “powershell”右键选择“以管理员身份运行”在打开的终端里输入Set-ExecutionPolicy Unrestricted回车后如果弹出确认提示输入Y再回车。如果没有任何提示说明之前已经改过直接继续。这一步只影响脚本执行权限不改系统其他设置。注意执行策略调整后建议只在当前用户范围生效。如果你在意安全可以用Set-ExecutionPolicy -Scope CurrentUser Unrestricted效果一样但作用域更小。三个依赖装完可以用一条命令快速自检node -v; npm -v; git --version三条版本信息都出来环境就算齐了。接下来装 OpenClaw 本体。3. 安装 openclaw-cn 并接入 TaoToken 统一 Key 配置这一章是核心分两步先装 openclaw-cn再写配置文件把模型通道指向 TaoToken。3.1 安装 openclaw-cn保持管理员 powershell 窗口输入官方安装脚本iwr -useb https://clawd.org.cn/install.ps1 | iex这条命令会下载并执行安装脚本过程中会拉取 npm 包和 git 依赖耐心等它跑完。看到安装完成提示后连续按两次CtrlC退出当前会话然后新开一个 powershell 窗口这次普通权限就行输入openclaw-cn onboard这是初始化配置向导方向键上下选择回车确认。向导会问你运行模式、端口、模型通道等。模型通道这一步先随便选一个占位我们下一步用配置文件覆盖成 TaoToken。3.2 写入 TaoToken 统一 Key 配置OpenClaw 的模型通道配置支持 OpenAI 兼容格式。TaoToken 的 API 地址是https://taotoken.net/apiKey 在控制台创建。配置文件通常位于用户目录下的.openclaw文件夹文件名可能是config.json或settings.json以你安装版本实际生成的为准。下面给一份可复制的 JSON 片段路径和字段名按你本地实际文件对齐{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, modelId: claude-3-5-sonnet, timeout: 60000 }, gateway: { port: 18789, host: 127.0.0.1 } }三个关键字段必须写全缺一个都会在启动时报错字段作用示例值baseUrlAPI 通道地址https://taotoken.net/apiapiKey统一 Keysk-xxxxmodelId模型标识claude-3-5-sonnet如果你用的是 Cline MCP 或 Codex 的auth.json体系逻辑一样Base URL 填https://taotoken.net/apiKey 填 TaoToken 控制台生成的Model ID 按你要调的模型填。三件套齐了通道就通了。提示Key 不要写进会提交到 git 的文件里。本地配置文件加进.gitignore或者用环境变量TAOTOKEN_API_KEY引用OpenClaw 支持从环境变量读取。配置写完保存回到 powershell 准备启动验证。4. 启动 gateway 与 dashboard 完成一次完整验证这一章演示从启动到看到 Web 界面的完整过程并验证模型通道是否真的通了。4.1 启动 gatewaygateway 是 OpenClaw 的后台服务负责接收请求、调度模型。开一个管理员 powershell 窗口输入openclaw-cn gateway这个窗口全程不能关关了服务就断。正常启动会输出监听地址类似Gateway listening on 127.0.0.1:18789。如果卡住不动或者报端口占用换一个端口改配置文件里的gateway.port即可。4.2 打开 dashboard再开一个新的 powershell 窗口普通权限输入openclaw-cn dashboard它会自动打开浏览器跳转到 Web 界面地址通常是http://127.0.0.1:18789。如果没自动跳手动复制终端里输出的 URL 到浏览器。4.3 发一条验证请求在 Web 界面输入框里发一句简单的话比如“你好帮我列一下当前目录的文件”。如果模型通道配置正确你会看到回复正常返回并且可能触发一次工具调用列目录。这一步成功说明 node.js、git、powershell、openclaw-cn、TaoToken 通道全部打通。验证模型通道是否走的是 TaoToken可以看 gateway 窗口的日志正常会打印请求的 baseUrl 和 modelId。如果日志里出现401或invalid api key回到第 3 章检查 Key 和 baseUrl。想单独验证模型对话是否可用可以直接用 TaoToken 的模型对话页面发一条测试消息确认 Key 本身有效再回来排查 OpenClaw 配置。这一步能快速区分是 Key 问题还是配置问题。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一章按真实报错对照排查都是我在部署过程中实际遇到或社区里高频出现的。5.1 401 Unauthorized报错原文通常是401 Unauthorized或invalid api key。原因就三类Key 写错、Key 过期、baseUrl 写错。检查配置文件里的apiKey是否完整复制有没有多余空格baseUrl必须是https://taotoken.net/api结尾不要多加/v1或斜杠。改完重启 gateway。5.2 local proxy failed报错local proxy failed或connect ECONNREFUSED一般是 gateway 没启动或者 dashboard 连的端口和 gateway 监听端口不一致。确认 gateway 窗口还在运行且配置文件里gateway.port和 dashboard 实际访问的端口一致。如果改了端口两个地方都要改。5.3 reading choices 报错报错里出现reading choices或Cannot read properties of undefined (reading choices)说明模型返回的响应结构不符合 OpenAI 兼容格式。常见原因是 modelId 填错或者 baseUrl 指向了一个不兼容的端点。确认 modelId 是 TaoToken 支持的模型标识baseUrl 用https://taotoken.net/api。5.4 OAuth 相关报错如果报错提到OAuth或token refresh failed说明你误用了需要 OAuth 的通道配置。OpenClaw 接 TaoToken 用的是 API Key 模式不需要 OAuth。检查配置文件里有没有残留的 OAuth 字段删掉只保留 baseUrl、apiKey、modelId 三件套。5.5 安装阶段依赖拉取失败npm install或 git clone 阶段报网络错误先确认 git 已装且能访问外网。如果公司网络有限制配置 npm 镜像和 git 代理设置这里指正常的网络配置不是绕过限制。重试安装脚本即可。排查完记得每次改配置后重启 gateway配置不会热加载。6. 把统一 Key 用顺后续维护与接入入口跑通一次之后日常使用就是两个窗口一个跑openclaw-cn gateway不关一个用openclaw-cn dashboard打开界面。模型想换只改配置文件里的modelIdbaseUrl 和 Key 不用动这就是统一 Key 的好处。如果你要长期跑编码类任务或 Agent 工作流建议把 Key 管理集中起来用 Coding Plan 这类方案控制额度避免单个 Key 被多项目共用导致超额。接入文档里有完整的字段说明和示例遇到配置字段不确定时直接查文档比猜快。创建和管理 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档与字段说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite单独验证模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite长期编码与 Agent 额度方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite最后给一个实用技巧把 gateway 启动命令写成一个.bat文件双击就能跑省得每次开管理员终端。配置文件备份一份换机器时直接复制.openclaw目录改一下 Key 就能用。环境变量TAOTOKEN_API_KEY建议设成系统级这样配置文件里可以不写明文 Key更安全。