OpenClaw (小龙虾) Windows全系列保姆级安装教程：从 Git、Node.js 到 TaoToken 配置一次跑通

1. Windows 上跑 OpenClaw 到底卡在哪OpenClaw 这个被社区叫成「小龙虾」的开源 Agent 工具最近在 Windows 上的讨论度很高。它能做什么简单说它把大模型能力接到你的本地终端里帮你读写文件、跑命令、做代码重构、批量处理任务适合想在自己电脑上折腾 AI 编码助手、又不想被某个编辑器绑死的开发者。但问题也出在这——它本质是个 Node.js 生态的 CLI 工具依赖 Git、Node.js、npm 全局路径、原生模块编译这几样在 Windows 上任何一环出问题安装就会卡住。我见过最多的三类报错一是EPERM: operation not permitted, rmdir二是npm error code 3221225477三是node-llama-cpp提示找不到预编译二进制、回退到 no GPU。这些看着吓人其实九成是历史安装残留、缓存进程没清干净、或者权限不足导致的。这篇就按 Windows 10/11 全系列x64 为主走一遍完整流程前置依赖检查、Git 与 Node.js 安装、OpenClaw 安装、TaoToken 统一 Key 配置、启动验证、报错排查。跟着做基本能一次跑通。需要先说明一点下面所有下载和安装都走官方渠道网络环境请使用你本地合规可用的方式本文不涉及任何网络工具的具体配置。2. 前置依赖Git 与 Node.js 的检查与安装2.1 先确认你机器上有没有打开 PowerShell普通权限即可后面装全局包再提权逐条敲git --version node -v npm -v正常会返回类似git version 2.53.0.windows.1、v20.18.0、10.8.2。如果提示「不是内部或外部命令」说明没装或没进 PATH继续往下。2.2 装 Git for Windows去 Git 官网下载页选Git for Windows/x64 Setup也就是那个.msi安装包。双击后一路 Next 即可中间有个选项叫「Adjusting your PATH environment」保持默认的「Git from the command line and also from 3rd-party software」这样 PowerShell 里才能直接调用git。装完重开一个 PowerShell 窗口再敲git --version验证。2.3 装 Node.js去 Node.js 官网下载 LTS 版本的Windows 安装程序(.msi)x64。安装时注意两点一是勾选「Add to PATH」二是如果弹出「Tools for Native Modules」的询问可以先不勾后面我们用环境变量跳过原生模块下载。装完同样重开窗口node -v和npm -v都要能出结果。注意Node.js 版本建议 18 或 20 的 LTS。太老的版本16 以下在装 OpenClaw 时容易在依赖解析阶段报错。2.4 配置 npm 镜像与 Git 协议替换国内直连 npm 官方源和 GitHub 的 ssh 协议经常超时先把这两处换掉。管理员身份运行 PowerShell右键开始菜单 → 终端(管理员)执行git config --global url.https://github.com/.insteadOf gitgithub.com: git config --global url.https://github.com/.insteadOf ssh://gitgithub.com/ npm config set registry https://registry.npmmirror.com npm cache clean --force第一、二条是把 git 的 ssh 地址重写成 https避免拉依赖时卡在 ssh 握手第三条把 npm 源指向国内镜像装包速度会明显不一样。3. 安装 OpenClaw 与 TaoToken 通道配置3.1 全局安装 OpenClaw还是在管理员 PowerShell 里npm install -g openclawlatest如果这一步顺利会看到added xx packages之类的输出。如果报下面这些EPERM: operation not permitted, rmdir ... npm error code 3221225477 npm error [node-llama-cpp] A prebuilt binary was not found, falling back to using no GPU别慌这基本是之前装过、有残留进程或缓存导致的。先重启电脑然后执行这套清理脚本taskkill /F /IM node.exe 2$null taskkill /F /IM openclaw.exe 2$null Remove-Item -Recurse -Force $env:APPDATA\npm\node_modules\openclaw -ErrorAction SilentlyContinue Remove-Item -Force $env:APPDATA\npm\openclaw* -ErrorAction SilentlyContinue Remove-Item -Recurse -Force $env:LOCALAPPDATA\npm-cache -ErrorAction SilentlyContinue Remove-Item -Recurse -Force $env:APPDATA\npm-cache -ErrorAction SilentlyContinue npm cache clean --force npm cache verify $env:NODE_LLAMA_CPP_SKIP_DOWNLOAD1 $env:npm_config_optionalfalse最后两行是关键NODE_LLAMA_CPP_SKIP_DOWNLOAD1让安装跳过那个容易失败的原生二进制下载npm_config_optionalfalse不装可选依赖。设完再跑一次npm install -g openclawlatest实测下来能解决绝大多数卡安装的问题。3.2 用 TaoToken 统一 Key 与 API 通道OpenClaw 要能对话、能跑 Agent得给它一个模型通道。TaoToken 提供统一的 Key 和 API 入口一个 Key 就能对接多种模型省得你到处申请。先去官网注册并拿到 Key官网地址https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content拿到 Key 后在控制台里可以创建和管理API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基础地址统一用https://taotoken.net/api这个地址不加 UTM 参数直接填进配置。3.3 config.toml 骨架OpenClaw 的配置走 TOML。在用户目录下建配置文件夹Windows 一般是C:\Users\你的用户名\.openclaw\新建config.toml填这个骨架# OpenClaw 主配置 [general] theme dark telemetry false # 模型通道指向 TaoToken 统一 API [provider] name taotoken base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model claude-sonnet-4-5 # Agent 行为 [agent] max_tokens 8192 temperature 0.3 auto_approve_read true auto_approve_write false # 网关 [gateway] host 127.0.0.1 port 8787几个参数说明base_url必须带/api后缀api_key换成你在 TaoToken 控制台生成的那串model填你想用的模型名具体可用列表可以在模型对话页里试。auto_approve_write建议先设 false让写文件操作需要你确认跑顺了再放开。提示如果你更习惯用 Claude Code 那套 Anthropic 协议接入TaoToken 也提供对应通道文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 配置字段换成对应的anthropic_base_url即可。4. 启动、验证与成功结果4.1 初始化向导配置写好后运行openclaw onboard向导会依次问你几个问题。按下面选是否继续选Yes启动模式选QuickStart模型 Key 配置选skip for now我们已经在 config.toml 里配好了第二个 Key 询问继续skip for now后续几个可选项一路跳过等它跑完会提示初始化成功并自动打开一个本地页面。这个页面就是 OpenClaw 的控制台后续改 API、换模型、看日志都能在这里操作。4.2 验证请求是否真的通了别急着关窗口。新开一个 PowerShell跑openclaw status正常会显示 gateway 运行中、端口 8787 监听、provider 为 taotoken。再发一条测试请求openclaw chat 用一句话说明你当前使用的模型如果返回了模型的自述内容说明 Key、base_url、模型名三者都对上了。这一步是整个流程里最关键的验证动作——很多人装完以为好了其实通道没通一用就报 401 或 404。4.3 网关打不开怎么办如果控制台页面打不开、或者提示 gateway 连接失败按顺序执行openclaw status openclaw logs --follow openclaw gateway restart openclaw gateway statuslogs --follow会实时打印日志看它报什么错。多数情况是端口被占换个 port 即可或者上一次进程没退干净gateway restart能解决。看到gateway status显示 running就说明成功了。注意运行 onboard 或 gateway 的那个窗口不要关它是常驻服务。想后台静默可以最小化或者用start /b openclaw gateway方式启动。5. 本篇常见报错排查5.1 EPERM / 3221225477 / node-llama-cpp这三个前面提过根因是残留。完整处理顺序重启电脑 → 跑 3.1 的清理脚本 → 设两个环境变量 → 重装。如果还不行检查是不是用普通权限装的全局包换成管理员 PowerShell 重来。5.2 npm 全局路径不在 PATH装完openclaw命令找不到多半是 npm 全局目录没进 PATH。查一下npm config get prefix返回的路径一般是C:\Users\你的用户名\AppData\Roaming\npm要出现在系统环境变量 Path 里。没有就手动加加完重开终端。5.3 401 / 403 鉴权失败Key 填错、Key 过期、或者 base_url 少了/api。回 TaoToken 控制台重新生成一个 Key确认base_url https://taotoken.net/api注意结尾不要多加斜杠。5.4 模型名不存在model字段填了平台不支持的名称会返回 404 或 model not found。去模型对话页确认可用模型列表复制准确的名字。模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content5.5 网关端口冲突8787 被别的程序占了改 config.toml 里的port比如换成 8899然后openclaw gateway restart。6. 长期编码与 Agent 场景的通道选择如果你只是偶尔用 OpenClaw 跑几条命令按上面的按量 Key 配置就够了。但如果你打算把它当成日常编码助手、长时间挂 Agent 任务频繁调用模型那按量计费可能不太划算这时候可以看下 TaoToken 的 Coding Plan它针对长期编码场景做了额度优化Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content配置方式一样把api_key换成 Coding Plan 对应的 Key 即可base_url不变。控制台里可以随时切换控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档里对 OpenClaw、Claude Code 等客户端的字段有详细对照遇到配置项不确定就翻文档接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后说个我踩过的坑Windows 上装这类 Node CLI最大的敌人不是工具本身而是「装了一半又重装」留下的缓存和僵尸进程。养成习惯——每次重装前先taskkill掉 node 进程、清 npm 缓存比事后排查省事得多。配置改完记得openclaw gateway restart让新配置生效别改完文件就直接用那样读的还是旧配置。