1. 为什么要在 Windows 上养一只 openclawopenclaw 是一个可以在本地跑起来的 AI 助手框架简单说就是给你的电脑装一个能对话、能接渠道、能挂技能的“小龙虾”。它本身不绑定某一家模型你可以把它理解成一个空壳子模型接口、消息渠道、技能插件都靠配置往里塞。适合谁适合那些不想把数据全丢到云端、想在自己机器上折腾一个私人助理的个人开发者。尤其是你手里已经有 API Key想找个能长期挂着、随时喊一声就回话的本地入口openclaw 是个不错的选择。但 Windows 下的坑比 Linux 多。node.js、git、npm、PowerShell 四样东西的安装顺序和权限设置稍微错一步后面就是连环报错。我试过在一台干净的 Win11 上从零装起光是 PowerShell 执行策略和 git 的 SSH 绕行就卡了两次。这篇记录就是把这套流程拆开每一步都给可复制的命令最后再把模型请求的 endpoint 统一改到 TaoToken 通道方便你以后换模型不用动代码。核心检索词先摆出来openclaw 是什么它是一个本地 AI 助手运行框架能做什么能接飞书、Telegram、Discord 等渠道能挂 skills能通过统一 endpoint 调模型。适合谁想在 Windows 本地跑个人助理、又不想被单一模型绑死的开发者。装之前先确认一件事你的网络能正常访问 npm 和 GitHub。openclaw 的安装包和依赖大多从这两个地方拉如果 npm 装到一半卡住八成是源的问题后面排障章节会讲怎么换源。另外提醒一句openclaw 默认是个人使用配置共享或多用户场景需要额外锁定权限。安装过程中它会弹风险提示选 yes 继续就行但心里要有数这东西跑起来后是能读你本地消息、能发消息的别在多人共用的机器上随便开。下面按顺序来先装 node.js 和 git再配 PowerShell 权限然后 npm 全局装 openclaw跑 onboard 初始化最后改 endpoint 到 TaoToken。每一步都有验证命令装完一样确认一样别跳步。2. 前置环境node.js、git、npm 与 PowerShell 的安装顺序这一章是整篇的地基。顺序错了后面 npm 装 openclaw 时会报各种找不到命令或者权限拒绝。正确顺序是node.js → git → 验证 npm → PowerShell 执行策略。先装 node.js。去 nodejs.org 下 LTS 版本Windows 选 .msi 安装包一路下一步。装完打开 PowerShell敲node -v正常会输出类似v20.11.0。如果提示“无法将 node 项识别为 cmdlet”说明 PATH 没生效关掉 PowerShell 重开一次或者重启电脑。node.js 装好后 npm 是自带的再验证npm -v输出10.x.x就对了。npm 是 node 的包管理器openclaw 就是通过它全局安装的。接着装 git。去 git-scm.com 下 Windows 版安装时注意一个选项Adjusting your PATH environment选 “Git from the command line and also from 3rd-party software”这样 PowerShell 里能直接用 git。装完验证git -v输出git version 2.4x.x即可。git 的作用是 openclaw 安装时要从 GitHub 拉依赖没有 git 会直接失败。现在到了 Windows 特有的坑PowerShell 执行策略。默认情况下 PowerShell 禁止运行脚本而 npm 全局安装和 openclaw 的 onboard 脚本都需要执行权限。先看当前策略Get-ExecutionPolicy如果输出Restricted就需要改。执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser然后输入 Y 确认。RemoteSigned 的意思是本地脚本可以跑远程下载的脚本需要签名对个人开发够用。改完再查一次确认变成 RemoteSigned。这里有个细节-Scope CurrentUser 只影响当前用户不需要管理员权限也不会动系统全局策略相对安全。如果你在公司机器上改之前最好确认下 IT 政策。四样都齐了之后建议把 npm 源换成国内镜像不然装 openclaw 时拉包会慢到怀疑人生npm config set registry https://registry.npmmirror.com验证一下npm config get registry输出https://registry.npmmirror.com/就对了。这一步不是必须但能省很多等待时间。如果你后面要发布包或者用私有源记得换回来。环境变量方面node.js 和 git 安装时一般会自动写入 PATH。如果node -v和git -v都能输出说明 PATH 没问题。万一某个命令找不到手动加右键此电脑 → 属性 → 高级系统设置 → 环境变量 → 用户变量里的 Path → 新建把 node 和 git 的安装目录加进去。node 默认在C:\Program Files\nodejs\git 默认在C:\Program Files\Git\cmd\。这一章做完你应该有四个能用的命令node、npm、git、以及一个允许跑脚本的 PowerShell。下一章开始装 openclaw 本体。3. 可复制配置npm 全局安装 openclaw 与 onboard 初始化环境齐了现在装 openclaw。打开 PowerShell执行npm i -g openclaw-g是全局安装装完后 openclaw 命令在任何目录都能用。安装过程中如果卡在 git 拉取阶段报类似ssh://gitgithub.com/连接失败这是 git 默认走 SSH 但你没配 SSH Key 导致的。临时绕过办法是让 git 把 SSH 地址重写成 HTTPSgit config --global url.https://github.com/.insteadOf ssh://gitgithub.com/这条命令的意思是以后所有ssh://gitgithub.com/开头的地址git 自动替换成https://github.com/。配完重新跑npm i -g openclaw就能过。装完验证openclaw -v能输出版本号就说明装上了。接下来初始化openclaw onboard这个命令会引导你完成基础配置。第一步是风险提示大意是“默认个人使用共享/多用户需要锁定继续吗”选 yes。然后选模型提供方会看到.cn和.ai两个选项.cn是国内节点.ai是国际节点。按你的网络情况选国内用户选.cn延迟低。接着粘贴 API Key。这里先随便填一个你手头有的或者先跳过因为后面我们要把 endpoint 统一改到 TaoTokenKey 也用 TaoToken 的。onboard 走完后会问网页打开方式选默认即可安装完成。现在改模型请求的 endpoint。openclaw 的配置文件一般在用户目录下的.openclaw文件夹里。先找到它ls $env:USERPROFILE\.openclaw里面会有config.json或settings.json之类的文件。用记事本或 VS Code 打开找到模型配置段。不同版本字段名可能略有差异但核心是三个Base URL、API Key、Model ID。把 Base URL 改成 TaoToken 的统一通道{ model: { baseUrl: https://taotoken.net/api, apiKey: 你的TaoToken密钥, modelId: claude-3-5-sonnet-20241022 } }注意 API 地址是https://taotoken.net/api不带任何多余路径。Key 去 TaoToken 控制台生成Model ID 填你要用的模型标识。这样配的好处是以后换模型只改 modelId 一个字段baseUrl 和 key 都不用动代码里也不用硬编码。如果你用的是 Claude Code 或者 Cline 这类工具配置逻辑一样都是 Base URL Key Model ID 三件套。openclaw 的 config.json 里如果字段名不是 baseUrl可能是endpoint或apiBase按实际文件里的键名改。改完保存重启 gateway 让配置生效openclaw gateway restart到这里openclaw 已经指向 TaoToken 通道了。下一章验证请求能不能通。4. 验证请求从 gateway 启动到模型对话成功配置改完得确认 openclaw 真能拉起模型。先启动 gatewayopenclaw gateway start正常会输出类似gateway started on port 3000的日志。如果报端口占用换一个端口或者先openclaw gateway stop再 start。启动后用 openclaw 自带的对话命令测试openclaw chat 你好介绍一下你自己如果配置正确会返回模型的回复。第一次调用可能稍慢因为要建立连接。看到正常文字回复说明 endpoint 改到 TaoToken 成功了。再验证一下模型标识对不对。有时候 baseUrl 通了但 modelId 写错会报model not found。这时候去 TaoToken 的模型对话页面确认可用模型列表把 modelId 换成列表里的准确名称。TaoToken 的模型对话入口在控制台里能找到点进去可以直接试对话确认模型可用再回填到 config.json。如果你想更直观地看请求过程可以开 gateway 的日志openclaw gateway start --verbose这样每次请求的 URL、状态码、耗时都会打出来。看到200 OK和返回的 choices 字段就说明链路通了。如果看到401是 Key 不对看到local proxy failed是 baseUrl 写错或者网络不通看到reading choices报错通常是返回体格式不对检查 modelId 是否匹配。验证通过后你可以把 openclaw 挂到飞书或其他渠道。添加渠道命令openclaw channels add按提示选飞书然后它会让你去飞书开放平台建机器人把 App ID 和 Secret 填回来。建机器人时需要开权限获取与上传图片或文件资源、获取用户基本信息、获取群组信息、获取与发送单聊群组消息、接收群聊中机器人消息事件、读取用户发给机器人的单聊消息、查看消息表情回复、以应用身份发消息、更新消息。其中“获取群组中所有消息”是敏感权限个人用可以不勾。渠道加完后直接跟机器人对话如果报错复制最后一行错误信息粘贴到 PowerShell 里执行通常是让你补装某个依赖或重新授权。常用命令记一下openclaw gateway start # 启动 openclaw gateway stop # 停止 openclaw gateway restart # 重启 openclaw channels login # WhatsApp QR 配对登录 openclaw channels add # 添加 Telegram/Discord/Slack 机器人到这一步你的小龙虾已经能跑起来并回话了。下一章讲安装过程中最容易撞上的几个报错。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth装 openclaw 的过程里报错基本集中在几个地方。这一章按真实报错逐条拆。报错一401 Unauthorized。这个最直接Key 不对或者没传。检查 config.json 里的 apiKey 是不是 TaoToken 控制台生成的完整密钥有没有多余空格。另外确认 baseUrl 是https://taotoken.net/api如果写成https://taotoken.net/api/v1可能会 404 而不是 401但有些版本会返回 401 混淆。改完记得openclaw gateway restart。报错二local proxy failed。这个通常出现在 gateway 启动阶段意思是本地代理起不来。原因可能是端口被占或者 baseUrl 指向了一个不可达的地址。先openclaw gateway stop再 start如果还报换端口openclaw gateway start --port 3001然后确认 config.json 里的 baseUrl 没有拼写错误。TaoToken 的 API 地址是https://taotoken.net/api注意是 https 不是 http。报错三reading choices 相关。完整报错可能是Cannot read properties of undefined (reading choices)。这是返回体里没有 choices 字段说明模型返回的不是标准 OpenAI 格式。原因一般是 modelId 写错或者 baseUrl 指向了非兼容端点。去 TaoToken 模型对话页面确认模型名回填正确的 modelId。如果用的是 Claude 系列确认 TaoToken 通道支持该模型的 OpenAI 兼容格式。报错四OAuth 相关。如果你在 channels add 时选了一些需要 OAuth 的渠道可能会卡在授权回调。Windows 下常见的是回调地址 localhost 被占用或防火墙拦截。解决办法是换一个回调端口或者在防火墙里放行。如果是飞书确认 App ID 和 Secret 填对权限勾选完整。报错五npm 安装时 SSH 失败。前面提过用git config --global url.https://github.com/.insteadOf ssh://gitgithub.com/绕过。如果还失败检查 git 是否装好git -v能不能输出。报错六PowerShell 禁止脚本。报错关键词cannot be loaded because running scripts is disabled。执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y。报错七缺少 UV 工具。安装 skills 时可能报缺少底层工具 UV。装它powershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iex装完重启 gatewayopenclaw gateway restart然后再装 skills 就能过。注意内置 skills 是全局安装不建议因为后续 openclaw 升级会造成依赖冲突。建议只装你需要的自定义 skills。排障的核心思路是先看报错最后一行它通常直接告诉你缺什么。然后对照上面几条改配置、重启、再验证。每次改完 config.json 都要 restart gateway不然不生效。6. 把模型请求统一到 TaoToken 通道的长期用法openclaw 跑起来之后真正省心的地方在于 endpoint 统一。你把 baseUrl 指向 TaoToken 的https://taotoken.net/apiKey 用 TaoToken 生成的Model ID 按需切换。这样做的价值是以后想换模型只改 config.json 里一个字段不用动任何代码也不用重新配 Key。具体操作上TaoToken 控制台里可以生成和管理 API Key建议给 openclaw 单独建一个 Key方便追踪用量。模型对话页面可以直接测试哪个模型可用、响应快测好了再把 modelId 填回配置。如果你要长期跑 coding 或 Agent 类任务Coding Plan 更适合额度和稳定性比按次调用好。接入文档里有各语言的示例openclaw 这种走 OpenAI 兼容格式的直接照抄 baseUrl 和 header 就行。核心三件套再强调一遍Base URL 填https://taotoken.net/apiKey 填 TaoToken 的Model ID 填你要用的模型标识。这三样在 config.json、Cline、Claude Code 里都是同一个逻辑。日常维护上openclaw 的 gateway 建议设成开机自启或者用计划任务拉起来。常用命令就那几条start、stop、restart记熟就行。渠道方面飞书机器人配好后手机和电脑都能对话等于你有了一个跨端的私人助理。最后说个实际经验装完第一次跑通后把 config.json 备份一份。以后升级 openclaw 或者换机器直接拷过去改 Key 就能用省得重新 onboard。skills 按需装别贪多全局装的那批升级时容易打架。小龙虾养起来不难难的是环境那几步按这篇的顺序走基本能一次过。