企业官网建设流程全解析

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 版本大于 22，Git 建议用较新的稳定版。你不需要 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，最后 Install，Finish。同样重开 cmd 验证git -v。如果你下载速度慢，可以找国内镜像站，但要注意甄别来源，别下到捆绑软件。

这里有个细节：Node.js 装完后，npm 会跟着一起装好，你可以用npm -v再确认一次。三个版本号都出来了，环境这一关就算过了。接下来才是真正装 openclaw 的环节，而这一步在 Windows 上有个绕不开的坑——PowerShell 的脚本执行策略。

Windows 默认禁止运行未签名的脚本，而 npm 安装全局包时会触发.ps1脚本，如果不放开权限，你会看到无法加载文件，因为在此系统上禁止运行脚本这类报错。解决办法是用管理员身份打开 PowerShell，执行两条策略命令。注意，这两条命令只影响脚本执行权限，不涉及任何网络层面的操作，纯粹是本地开发环境的常规配置。

环境铺好之后，你还需要一个能调用的大模型。openclaw 本身只是壳，真正干活的是背后接的模型。这里我建议用 TaoToken 这类聚合平台来拿 Key，因为它把多家模型的调用统一成一个入口，配置起来省事。官网在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_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 openclaw@2026.3.13 --registry=https://registry.npmmirror.com/ openclaw -v

第二条命令应该输出2026.3.13。如果输出的是别的版本，说明全局包里已经有旧版，先npm uninstall -g openclaw再重装。

接着跑初始化向导：

openclaw onboard

向导是交互式的，用方向键选择，回车确认。流程大致是：选 Yes 继续，选 QuickStart，然后选模型来源。如果你用 TaoToken，就在模型列表里选对应的入口，填入前面拿到的 API Key，Base 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 之前先看清楚它需要什么权限，涉及文件操作和系统调用的，话术里加上限制，让它先报告再执行。这样用起来更稳，也更安全。