1. Windows 上装 openclaw 到底卡在哪Node.js 与 Git 环境校验很多人第一次在 Windows 上装 openclaw卡住的地方其实不是 openclaw 本身而是它依赖的两个基础件Node.js 和 Git。openclaw 是一个跑在 Node 运行时上的命令行工具安装过程要用 npm 从远程仓库拉包而 npm 拉包时又经常调用 Git 去克隆依赖。所以只要这两个里有一个没装好或者版本太低后面npm i -g openclaw就会报一堆看不懂的错。我先把结论说清楚openclaw 在 Windows 上能跑但要求 Node.js 版本大于 22Git 建议用较新的稳定版。你不需要 Linux 经验也不需要懂什么编译原理只要按顺序把环境铺好剩下的就是复制粘贴命令。先做环境自检。按Win R输入cmd回车打开命令提示符依次执行node -v git -v如果两条命令都输出了版本号比如v24.14.1和git version 2.4x.x说明基础环境已经具备可以跳到下一节。如果提示「不是内部或外部命令」那就是没装或者没进 PATH继续往下看。Node.js 去官网下载 LTS 或 Current 都行重点是版本要大于 22。下载node-v24.x.x-x64.msi后双击第一步 Next勾选I accept the terms in the License Agreement然后一路 Next最后 Install等进度条走完点 Finish。装完必须重新开一个 cmd 窗口再执行node -v因为旧窗口读不到新的环境变量这是新手最容易忽略的一点。Git 的安装更简单官网下载后双击全部点 Next最后 InstallFinish。同样重开 cmd 验证git -v。如果你下载速度慢可以找国内镜像站但要注意甄别来源别下到捆绑软件。这里有个细节Node.js 装完后npm 会跟着一起装好你可以用npm -v再确认一次。三个版本号都出来了环境这一关就算过了。接下来才是真正装 openclaw 的环节而这一步在 Windows 上有个绕不开的坑——PowerShell 的脚本执行策略。Windows 默认禁止运行未签名的脚本而 npm 安装全局包时会触发.ps1脚本如果不放开权限你会看到无法加载文件因为在此系统上禁止运行脚本这类报错。解决办法是用管理员身份打开 PowerShell执行两条策略命令。注意这两条命令只影响脚本执行权限不涉及任何网络层面的操作纯粹是本地开发环境的常规配置。环境铺好之后你还需要一个能调用的大模型。openclaw 本身只是壳真正干活的是背后接的模型。这里我建议用 TaoToken 这类聚合平台来拿 Key因为它把多家模型的调用统一成一个入口配置起来省事。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。注册后在控制台生成 API Key后面初始化向导里会用到。这一节的核心就一句话先把 Node 和 Git 装对版本再把 PowerShell 策略放开最后准备好一个模型 Key。三件事做完你才有资格进入 openclaw 的安装流程否则后面每一步都会报错而且报错信息往往指向不到真正的原因。2. TaoToken 前置准备拿 Key、选套餐、配好 npm 镜像在装 openclaw 之前我建议先把模型侧的准备工作做完因为 openclaw 的初始化向导会直接让你选模型、填 Key如果那时候才去注册中途容易手忙脚乱。TaoToken 的定位是把多家大模型的调用聚合成一个兼容接口你拿一个 Key 就能切换不同模型对于 openclaw 这种需要反复试模型的任务来说比较友好。第一步打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。进入控制台后找到 API Keys 页面新建一个 Key复制保存好。这个 Key 只会完整显示一次丢了就得重新建。控制台地址是 https://taotoken.net/console API Keys 页面是 https://taotoken.net/api-keys 接入文档在 https://taotoken.net/doc 。第二步想清楚你要用哪种套餐。如果你只是想让 openclaw 跑起来、做点文件整理和对话按量付费的 API 就够。如果你打算长期用它写代码、跑 Agent 任务那 Coding Plan 更划算因为它是包月形式不用担心 token 烧太快。Coding Plan 的入口在 https://taotoken.net/coding-plan 。我自己的用法是日常问答和调试用 API长期挂着的编码任务用 Coding Plan两者不冲突。第三步回到 Windows 终端把 npm 的镜像和超时参数配好。这一步非常关键因为 openclaw 的依赖包体积不小直连官方源经常超时。用管理员 PowerShell 执行npm config set registry https://registry.npmmirror.com npm config delete fetch-retry-mintimeout npm config delete fetch-retry-maxtimeout npm config set fetch-timeout 120000 npm config set strict-ssl false npm config get fetch-timeout最后一条应该输出120000说明超时设置生效了。strict-ssl false是为了避免某些证书链问题导致安装中断属于本地开发环境的常见处理不影响你的账号安全。这里解释一下为什么先配镜像再装 openclaw。openclaw 安装时会拉取大量依赖其中不少托管在 GitHub 上国内直连经常卡在fetch阶段表现就是终端半天没反应最后报ETIMEDOUT或ECONNRESET。换成 npmmirror 之后大部分包能从国内镜像拿到速度会稳定很多。但要注意镜像只加速 npm 包如果某个依赖内部还要git cloneGitHub 仓库那还是可能慢这时候 Git 装好就显得很重要。关于模型选择TaoToken 支持多种模型你在 openclaw 初始化时选哪个取决于你买的套餐。如果你用的是 Coding Plan就在向导里选对应的套餐入口如果你用的是按量 API就选 API 方式并填入 Key。模型 ID 要填对比如claude-sonnet-4-5这类具体名称填错了会报model not found。还有一个容易被忽略的点TaoToken 的 Base URL 是https://taotoken.net/api注意结尾没有斜杠。有些工具对 URL 格式敏感多一个斜杠就 404。你在 openclaw 配置里填的时候直接复制这个地址不要自己加东西。准备工作做到这里你手里应该有三样东西一个可用的 API Key、一个明确的套餐选择、一个配好镜像的 npm 环境。这三样齐了下一节的安装和初始化才能顺畅。如果你还没拿 Key现在就去 https://taotoken.net/api-keys 建一个别等到向导跑到一半再回头找。3. 可复制配置openclaw 安装、初始化与飞书对接片段这一节是全文的核心操作区我把命令和配置片段都整理成可以直接复制的形式。你按顺序执行每一步都有对应的验证方式。先装 openclaw。官方不建议装最新版因为最新版可能引入未稳定的改动教程以2026.3.13为例npm i -g openclaw2026.3.13 --registryhttps://registry.npmmirror.com/ openclaw -v第二条命令应该输出2026.3.13。如果输出的是别的版本说明全局包里已经有旧版先npm uninstall -g openclaw再重装。接着跑初始化向导openclaw onboard向导是交互式的用方向键选择回车确认。流程大致是选 Yes 继续选 QuickStart然后选模型来源。如果你用 TaoToken就在模型列表里选对应的入口填入前面拿到的 API KeyBase URL 填https://taotoken.net/api模型 ID 按你套餐里的实际名称填。授权方式如果是 OAuth浏览器会自动弹出登录页登录后回到终端继续。向导里会问你要不要现在配飞书先选Skip for now等 openclaw 本体跑通再回来配。后面问是否启用某些高级功能也先跳过。最后它会问是否允许访问网络选允许。完成后浏览器会自动打开 openclaw 的聊天界面你在对话框里发一句话能收到回复就说明模型接通了。注意那个 PowerShell 终端窗口不能关关了 openclaw 就停了。你可以把它最小化但别点叉。如果你需要 openclaw 操作文件在网页界面点「配置」把 tools 里的 coding 改成 full保存。改完先别重启等飞书配好一起重启。现在配飞书。打开 https://open.feishu.cn 进开发者后台用个人飞书账号登录。点「创建企业自建应用」起个名字。创建后进入应用先加机器人能力在「添加应用能力」里找到机器人启用。然后配权限。进「权限管理」把下面这段 JSON 整体粘贴覆盖原来的内容{ scopes: { tenant: [ contact:contact.base:readonly, docx:document:readonly, im:chat:read, im:chat:update, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:message.pins:read, im:message.pins:write_only, im:message.reactions:read, im:message.reactions:write_only, im:message:readonly, im:message:recall, im:message:send_as_bot, im:message:send_multi_users, im:message:send_sys_msg, im:message:update, im:resource, application:application:self_manage, cardkit:card:write, cardkit:card:read ], user: [ contact:user.employee_id:readonly, offline_access, base:app:copy, base:field:create, base:field:delete, base:field:read, base:field:update, base:record:create, base:record:delete, base:record:retrieve, base:record:update, base:table:create, base:table:delete, base:table:read, base:table:update, base:view:read, base:view:write_only, base:app:create, base:app:update, base:app:read, sheets:spreadsheet.meta:read, sheets:spreadsheet:read, sheets:spreadsheet:create, sheets:spreadsheet:write_only, docs:document:export, docs:document.media:upload, board:whiteboard:node:create, board:whiteboard:node:read, calendar:calendar:read, calendar:calendar.event:create, calendar:calendar.event:delete, calendar:calendar.event:read, calendar:calendar.event:reply, calendar:calendar.event:update, calendar:calendar.free_busy:read, contact:contact.base:readonly, contact:user.base:readonly, contact:user:search, docs:document.comment:create, docs:document.comment:read, docs:document.comment:update, docs:document.media:download, docs:document:copy, docx:document:create, docx:document:readonly, docx:document:write_only, drive:drive.metadata:readonly, drive:file:download, drive:file:upload, im:chat.members:read, im:chat:read, im:message, im:message.group_msg:get_as_user, im:message.p2p_msg:get_as_user, im:message:readonly, search:docs:read, search:message, space:document:delete, space:document:move, space:document:retrieve, task:comment:read, task:comment:write, task:task:read, task:task:write, task:task:writeonly, task:tasklist:read, task:tasklist:write, wiki:node:copy, wiki:node:create, wiki:node:move, wiki:node:read, wiki:node:retrieve, wiki:space:read, wiki:space:retrieve, wiki:space:write_only, contact:user.basic_profile:readonly ] } }粘贴后保存。然后回到 PowerShell执行openclaw config用方向键选Channels回车选Configure/link回车选Feishu/Lark (飞书)回车选Download from npm (openclaw/feishu)回车。接着它会让你填 App Secret 和 App ID这两个都在飞书开放平台的「凭证与基础信息」页面里复制。填完后选WebSocket (default)再选Feishu (feishu.cn) - China然后选Open - respond in all groups (requires mention)选Finished (Done)选Yes选Open (public inbound DMs)最后Continue结束。回到飞书开放平台进「事件与回调」订阅方式选「长连接」保存。然后点「添加事件」搜索「接收消息」勾选添加。最后点「创建版本」并发布。发布后打开飞书搜索你创建的应用名称发一条消息测试。如果机器人能回复说明飞书对接成功。这时候回到 PowerShell执行openclaw gateway restart让之前的配置生效。至此openclaw 和飞书的链路就通了。4. 验证请求与成功结果一条消息触发全链路配置写完不代表真的通了必须做一次端到端验证。我习惯用一条消息把「openclaw 本体 → 模型 → 飞书」整条链路串起来测这样任何一环断了都能立刻定位。先在 openclaw 的网页聊天界面里发一句简单的话比如「你好报一下你当前使用的模型名称」。如果它能正常回复说明 openclaw 本体和模型之间的连接没问题。这一步失败的话问题基本在 API Key、Base URL 或模型 ID 上跟飞书无关。接着去飞书里测。打开飞书找到你创建的那个应用直接发一条私聊消息比如「测试一下收到请回复」。如果机器人回复了说明飞书的长连接和消息接收都正常。如果没回复先检查飞书开放平台里「事件与回调」的订阅方式是不是「长连接」以及「接收消息」事件有没有添加成功。再测群聊场景。把机器人拉进一个飞书群点群右上角三个点进设置找「群机器人」添加你创建的那个机器人。然后在群里 机器人 发一句话比如「机器人 你在吗」。机器人应该会在群里回复。群聊测通之后还有一个很实用的动作让 openclaw 自己找到群聊 ID 并记住。你可以在网页聊天界面里对它说我在飞书群聊里 你了你查看一下日志告诉我飞书群聊的 id然后记住这个群聊 id。以后我让你发飞书群里的消息用这个群聊 id 就默认发到这个群。找到之后发一条消息到群里。这段话的作用是让 openclaw 去读日志、提取群 ID、写入记忆然后主动往群里发消息。如果群里真的收到了它发的消息说明「openclaw 主动调用飞书 API 发消息」这条反向链路也通了。这一步比单纯收消息更有价值因为很多自动化场景都是让 openclaw 主动推送结果。验证过程中你可以观察 PowerShell 终端的输出。openclaw 会把请求日志打在终端里包括模型调用、飞书消息收发。如果某一步卡住日志里通常会有线索。比如看到401就是 Key 不对看到model not found就是模型 ID 填错看到WebSocket相关报错就是飞书长连接没建起来。成功的结果应该是这样的网页界面能对话飞书私聊能对话飞书群聊 能回复让 openclaw 主动发群消息也能发出去。四个场景全过才算真正部署完成。这里提醒一句openclaw 部署完只能操作电脑上部分格式的文件不是一上来就能操作所有软件。如果你想让它操作某个软件得先看那个软件有没有接口或者有没有对应的 skill 或 MCP。别一部署完就让它干重活先沟通、先装能力再下指令。沟通时话术里加限制比如「只进行查看没有我的操作指令严格禁止你私自操作告诉我查看结果和推荐即可」。这样能避免它误操作。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节我把安装和对接过程中最容易撞上的几个报错单独拎出来每个都给出原因和处置方式。你遇到问题时可以直接对照。401 Unauthorized。这个报错出现在模型调用阶段意思是 Key 无效或没带上。检查三件事API Key 有没有复制完整前后有没有多余空格Base URL 是不是https://taotoken.net/api结尾不要加斜杠模型 ID 是不是你套餐里真实存在的名称。如果用的是 Coding Plan确认套餐还在有效期内。改完配置后记得openclaw gateway restart。local proxy failed。这个通常出现在 npm 安装或 openclaw 启动阶段原因是网络请求被本地代理拦截或者 npm 的代理配置指向了一个不可用的地址。先执行npm config get proxy和npm config get https-proxy如果输出不是null用npm config delete proxy和npm config delete https-proxy清掉。然后确认镜像源是https://registry.npmmirror.com。如果你本机装了某些网络工具先关掉再试避免它劫持请求。reading choices。这个报错一般出现在 openclaw 初始化向导或配置读取阶段意思是配置文件格式不对程序读不到预期的选项。常见原因是手动改了配置文件但 JSON 语法错了比如多了逗号、少了引号。找到 openclaw 的配置目录把配置文件用 JSON 校验工具过一遍。如果你不确定改了什么最稳的办法是删掉配置文件重新跑openclaw onboard。OAuth 授权失败。在初始化向导里选 OAuth 登录时浏览器弹出授权页但回调失败或者终端一直卡在等待授权。先确认浏览器能正常打开授权页如果打不开检查默认浏览器设置。授权完成后如果终端没反应手动回车一下。如果反复失败改用 API Key 方式而不是 OAuth直接填 Key 更稳定。飞书消息发不出去。检查飞书开放平台里应用版本有没有发布权限有没有生效。权限改动后需要重新创建版本并发布否则新权限不生效。另外确认「事件与回调」的订阅方式是长连接且「接收消息」事件已添加。群聊里 机器人没反应检查机器人是否真的被拉进群以及群设置里机器人是否启用。openclaw 命令找不到。装完之后新开终端执行openclaw -v提示不是内部命令说明全局包的路径没进 PATH。执行npm config get prefix看全局路径把这个路径加到系统环境变量 Path 里然后重开终端。或者直接用npx openclaw -v临时调用。终端关了 openclaw 就停。这是正常行为openclaw 跑在前台。如果你希望它后台常驻可以用start /b openclaw gateway这类方式但更推荐保持一个终端窗口开着方便看日志。日志是排查问题的第一手资料别嫌它占地方。排查的核心思路是分层先确认 Node 和 Git 没问题再确认 npm 镜像和超时没问题然后确认 openclaw 本体能跑接着确认模型能调通最后确认飞书链路通。哪一层报错就修哪一层不要跳着改。6. 语义一致 CTA把 Key、文档和套餐入口放对位置走到这里你的 openclaw 应该已经能在 Windows 上跑起来并且和飞书打通了。如果你还没拿 Key或者想换一个更稳定的模型入口可以直接去 https://taotoken.net/api-keys 生成一个然后在 openclaw 配置里把 Base URL 填成https://taotoken.net/api模型 ID 按你选的填。接入过程中如果对参数有疑问比如某个字段该填什么、某个报错怎么解先翻接入文档 https://taotoken.net/doc 大部分配置项都有说明。文档里也会讲清楚不同模型的调用差异避免你填错模型 ID。如果你打算长期用 openclaw 做编码或 Agent 任务建议看一下 Coding Plan https://taotoken.net/coding-plan 。包月形式比按量付费更适合高频调用尤其是让 openclaw 反复读文件、跑任务的时候不用担心 token 消耗过快。我自己的用法是日常调试用 API长期挂着的任务用 Coding Plan两者按需切换。想先试试模型对话效果可以直接进 https://taotoken.net/chat 在网页里发几句话感受一下响应速度和输出质量再决定用哪个模型接进 openclaw。这一步能帮你少走弯路避免配好了才发现模型不适合自己的场景。最后给一个实用建议openclaw 装好之后别急着让它干复杂的活。先和它沟通明确你要做什么需要哪些 skill 或 MCP装好之后再下指令。常用的 skill 来源有几个openclaw 官方的 skills 站、GitHub 上的 awesome-openclaw-skills 项目以及 skills.sh 这类聚合站。装 skill 之前先看清楚它需要什么权限涉及文件操作和系统调用的话术里加上限制让它先报告再执行。这样用起来更稳也更安全。