1. Windows 上装 OpenClaw 前先把 Node.js、Git、pnpm 这三样理顺OpenClaw 是一个能在你 Windows 电脑上真正动手干活的开源个人 AI 助手它能读文件、建文件、跑命令、连聊天软件而这一切的地基就是 Node.js、Git、pnpm 三个环境。很多人第一次装 OpenClaw 失败不是 OpenClaw 本身的问题而是 Node.js 版本太老、Git 没进 PATH、pnpm 没装导致依赖树卡死。这篇就把 Windows 从零准备环境的顺序、版本选择、可复制命令、以及用 TaoToken 统一 Key/API 通道接入模型的配置一次讲清适合完全没有 Node 经验的小白跟着做。先说清楚三者的分工不然后面容易乱。Node.js 是运行时OpenClaw 的安装脚本、gateway 服务、CLI 全靠它跑Git 是拉取依赖的工具OpenClaw 部分模块要从 git 仓库取代码没有 Git 会在安装中途报错pnpm 是包管理器比 npm 更快更省磁盘OpenClaw 的依赖树用 npm 装容易卡死官方也推荐 pnpm。三者的安装顺序建议是Node.js → Git → pnpm因为 pnpm 是通过 npm 全局安装的而 npm 随 Node.js 一起来。版本选择上Node.js 最好在 v22.x 以上低于 v20 会在安装阶段直接报引擎不匹配。Git 用最新稳定版即可Windows 上推荐用 winget 装省去手动配 PATH 的麻烦。pnpm 装最新版就行它向下兼容性很好。我实测下来Node v22.14 Git 2.47 pnpm 9.x 这套组合在 Windows 11 上最稳Windows 10 也完全没问题。还有一个容易被忽略的点PowerShell 的执行策略。Windows 默认禁止运行下载的脚本而 OpenClaw 的一键安装脚本正是通过iwr | iex执行的如果不先放开权限会直接报ScriptContainedMaliciousContent。这个放到第 3 节一起处理。至于模型接入OpenClaw 本身不带模型它需要你填一个 API Key 和 Base URL。国外模型成本高、门槛也高用 TaoToken 这类统一通道可以把 Key 和地址收敛成一套后面换模型只改 Model ID不用动其他配置。下面从环境准备开始一步步来。2. 用 TaoToken 统一 Key 与 API 通道省掉反复换配置的麻烦OpenClaw 的配置向导里会让你填 API Key、Model ID、URL 三样东西。如果你只用一家模型直接填官方地址也行但实际用起来你会发现不同任务适合不同模型——写代码用推理强的整理文件用便宜的多模态任务又要换支持图片的。每换一次就要改一次配置还要记不同厂商的 Key 格式和地址很烦。TaoToken 在这里的作用就是把这件事收敛你只需要在 TaoToken 拿一个 KeyBase URL 统一填https://taotoken.net/api然后在 OpenClaw 里换 Model ID 就能切换背后的模型。对 OpenClaw 这种会 24 小时待命、反复调用模型的场景来说统一通道的好处是配置只维护一份出问题排查也只看一个地方。具体怎么拿 Key打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台里创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。Key 一般以sk-开头创建后只显示一次记得立刻复制存好别截图发群里。拿到 Key 之后OpenClaw 配置向导里那三栏这样填配置项填写内容API Key你在 TaoToken 创建的sk-xxxBase URLhttps://taotoken.net/apiModel ID按任务选比如deepseek-chat、glm-4.6等如果你在向导里没找到对应厂商就选Custom (OpenAI Compatible)因为 TaoToken 的接口是 OpenAI 兼容格式填上面三项就能通。Model ID 具体支持哪些可以在模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 里先试一下确认能正常返回再填进 OpenClaw避免配置完才发现模型名写错。有一点要提醒OpenClaw 比较费 token尤其是它自动规划任务、反复尝试的时候。所以 Key 一定要保管好不要写进会提交到 git 的配置文件里。后面第 5 节会讲怎么用环境变量或本地配置文件隔离 Key。如果你打算长期跑编码类、Agent 类任务可以考虑 TaoToken 的 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合高频调用的场景比按次计费更划算。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到参数不确定时对着查。3. 可复制的环境安装与 OpenClaw 配置片段这一节全是能直接粘贴的命令和配置按顺序执行即可。先装 Node.js推荐用 winget一条命令搞定winget install OpenJS.NodeJS.LTS装完关掉当前 PowerShell重新开一个窗口让 PATH 生效。然后验证node -v npm -v正常会输出类似v22.14.0和10.9.2。如果node -v报找不到命令说明 PATH 没刷新重启电脑或手动刷新环境变量$env:Path [System.Environment]::GetEnvironmentVariable(Path,Machine) ; [System.Environment]::GetEnvironmentVariable(Path,User)接着装 Git同样用 wingetwinget install Git.Git装完刷新 PATH 后验证git --version输出git version 2.47.x就对了。然后装 pnpmnpm install -g pnpm pnpm -vpnpm 装好后先放开 PowerShell 执行权限否则 OpenClaw 安装脚本会被拦。以管理员身份打开 PowerShell执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass这两条只影响当前用户和当前窗口不会动系统级安全设置。然后执行 OpenClaw 一键安装iwr -useb https://openclaw.ai/install.ps1 | iex安装脚本会自动检测环境、跳过已装的依赖、下载核心文件、配环境变量最后进入配置向导。向导里选 QuickStart到模型配置那一步按第 2 节的表格填 TaoToken 的 Key、Base URL 和 Model ID。如果你不想每次都在向导里手填也可以直接写配置文件。OpenClaw 的配置目录一般在C:\Users\你的用户名\.openclaw\里面有个config.json或类似文件可以写成这样{ provider: openai-compatible, apiKey: sk-你的TaoToken密钥, baseUrl: https://taotoken.net/api, model: deepseek-chat, gateway: { port: 18789 } }注意这个文件不要提交到任何公开仓库。更稳妥的做法是把 Key 放到系统环境变量里配置里只引用变量名[System.Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY,sk-你的密钥,User)然后配置里写apiKey: ${TAOTOKEN_API_KEY}。这样即使配置文件被同步或分享Key 也不会泄露。4. 验证安装成功从 health 检查到第一个文件创建环境装完、配置填完不代表就能用了得实际验证一遍。OpenClaw 安装完成后会自动启动 gateway 服务大约 30 秒后浏览器会自动打开 Web UI地址形如http://127.0.0.1:18789/#tokenxxxx。如果浏览器没自动打开先跑健康检查openclaw health正常会返回 gateway 状态、端口、模型连接情况。如果报gateway closed (1006 abnormal closure)说明服务没起来手动进目录启动cd C:\Users\你的用户名\.openclaw\ .\gateway.cmd这个窗口会持续输出日志别关它。观察有没有报错比如缺文件、权限拒绝、模型连接失败。启动大概需要几分钟等它稳定后再看 Web UI。Web UI 能打开后先确认模型通道是通的。在界面里发一句简单的话比如“你好”看有没有正常回复。如果报 401说明 Key 无效或没填对如果报 402说明账户余额或额度有问题如果报Model context window too small说明选的模型上下文太小换一个支持 16000 tokens 以上的。模型通了之后做一次真实任务验证。在交互界面输入请帮我在桌面上创建一个名为 hello_openclaw.txt 的文件并在里面写入你好OpenClaw。Agent 会自动规划步骤、调用文件系统、完成创建。你去桌面看应该多了这个文件打开内容也对。这一步能跑通说明 Node.js、Git、pnpm、模型通道、gateway 服务全链路都正常。顺便验证一下 pnpm 是否真的在参与依赖管理。进 OpenClaw 安装目录跑pnpm list --depth0能看到依赖列表就说明 pnpm 工作正常。如果这里报错多半是 pnpm 没装好或 PATH 没刷新回到第 3 节重装。最后记一下常用命令后面排障会用到openclaw status openclaw health openclaw gateway start openclaw gateway stop openclaw doctor openclaw updateopenclaw doctor是排障首选它会自动检查环境、配置、服务状态给出具体建议。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth装 OpenClaw 的过程中报错基本集中在几个固定位置。这一节按真实报错对照排查遇到哪个查哪个。401 Unauthorized模型调用被拒。原因通常是 API Key 无效、被禁用、或与 Base URL 不匹配。如果你用的是 TaoToken检查 Key 是不是复制完整、有没有多余空格Base URL 是不是https://taotoken.net/api。如果 Key 是对的还报 401去 TaoToken 控制台确认 Key 状态是否正常、额度是否充足。注意 401 有时会和 402 一起出现先看余额。local proxy failed本地代理连接失败。OpenClaw 的 gateway 在本地起服务如果端口被占用或防火墙拦截就会报这个。先查端口netstat -ano | findstr 18789如果有其他进程占用换端口启动openclaw gateway --port 18790然后检查 Windows 防火墙有没有拦 Node.js把 Node 加入允许列表。reading choices 相关报错通常是模型返回格式不符合预期OpenClaw 解析choices字段失败。原因可能是 Model ID 填错、Base URL 指向了不兼容的接口、或模型返回了非标准结构。先确认 Model ID 在 TaoToken 模型对话页能正常返回再检查 Base URL 是不是https://taotoken.net/api不要多加/v1或漏掉路径。OAuth 相关报错如果你在配置里选了需要 OAuth 的厂商但没完成授权流程就会卡住。用 TaoToken 的 OpenAI 兼容模式不涉及 OAuth选Custom (OpenAI Compatible)填 Key 即可绕过。如果之前选错了厂商跑openclaw onboard重新进向导改。ScriptContainedMaliciousContentPowerShell 执行策略拦截。回到第 3 节用管理员权限执行那两条Set-ExecutionPolicy命令。npm error code ENOENTnpm 找不到路径通常是 Node.js 安装不完整或 PATH 没刷新。重装 Node.js LTS重启 PowerShell再验证node -v。Health check failed: gateway closed (1006)gateway 没起来。手动跑.\gateway.cmd看日志常见原因是端口占用、配置文件语法错误、或模型连接超时。配置文件如果是 JSON检查有没有多余逗号。Model context window too small模型上下文太小。OpenClaw 要求至少 16000 tokens换一个上下文更大的 Model ID。排查顺序建议先openclaw doctor再openclaw health然后看 gateway 窗口日志最后查配置文件和 Key。大部分问题出在 Key、Base URL、Model ID 这三样对照第 2 节的表格核对一遍能解决八成报错。6. 环境就绪之后把 Key 管好把模型选对环境装完只是开始真正影响体验的是 Key 管理和模型选择。Key 方面别把sk-开头的密钥写进会分享的文件用环境变量引用如果怀疑泄露立刻去 TaoToken 控制台 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 吊销重建。OpenClaw 会反复调用模型Key 泄露的损失比普通聊天工具大得多。模型选择上日常整理文件、写简单脚本用便宜且上下文够的模型就行写代码、做复杂 Agent 任务换推理更强的 Model ID。切换时只改 OpenClaw 配置里的model字段Base URL 和 Key 不用动这就是统一通道的价值。想先试哪个模型合适去模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 快速对比确认效果再填进 OpenClaw。如果你准备长期跑编码类任务Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 比按次调用更适合高频场景。接入细节不确定时文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有完整的参数说明和示例。最后提醒一句OpenClaw 的 gateway 服务会常驻后台如果你不打算 24 小时用跑完任务记得openclaw gateway stop避免它在你不知情时反复尝试导致 token 消耗上涨。环境这关过了后面接飞书、钉钉、QQ 机器人就是纯配置活了慢慢来。