企业官网建设流程全解析

1. 为什么我要在 Windows 上折腾 OpenClaw 和飞书

OpenClaw 是一个可以跑在自己电脑上的 AI 助手网关，它能把你常用的聊天工具（比如飞书）和背后的大模型 API 连起来，让你在飞书里直接跟 AI 对话、让它帮你处理消息。适合谁？适合想拥有一个「私人 AI 助理」但又不想买服务器、不想写太多代码的普通用户，尤其是 Windows 用户。我这次的目标很明确：在 Windows 上把 OpenClaw 本地部署跑起来，然后接入飞书机器人，最后用 TaoToken 的统一 Key 把模型通道配好，实现飞书里发消息、AI 正常回复。

整个过程我踩了不少坑，最典型的就是「之前装过旧版，结果新版装不上」，还有「飞书长连接没配对好，消息发出去石沉大海」。所以这篇记录会按真实操作顺序来：先清理旧环境，再装 Node.js/npm，然后装 OpenClaw，接着配飞书机器人，最后把 TaoToken 的 Key 填进 settings.json 并验证连通性。每一步我都会给出可复制的命令和配置片段，你照着做基本能一次跑通。

需要提前说明的是，OpenClaw 的安装脚本和飞书后台的页面会来回跳，第一次操作容易晕。我的建议是：先把飞书机器人建好但先别急着设订阅方式，等 OpenClaw 这边通道配好了再回去设，这样能少走弯路。下面正式开始。

2. 前置准备：TaoToken 统一 Key 与 API 通道

在配 OpenClaw 之前，先把模型通道准备好。我用的是 TaoToken 的统一 Key，好处是一个 Key 可以走多个模型，不用在 OpenClaw 里来回换配置。你需要先拿到两样东西：API Key 和 API 地址。

API 地址是https://taotoken.net/api，这个地址在 OpenClaw 的 settings.json 里会用到。API Key 的获取入口在控制台的 API Keys 页面，登录后新建一个 Key 复制出来就行。如果你还没注册，可以从官网进：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。注册完进控制台，找到 API Keys 菜单，点新建，把生成的 Key 存到记事本里，后面配置要用。

这里有个细节：TaoToken 的 Key 是统一通道，也就是说你不需要为每个模型单独申请 Key。OpenClaw 里配置模型时，只要把 base_url 指向 TaoToken 的 API 地址，把 api_key 填成你刚复制的 Key，模型名按 TaoToken 支持的写就行。这样后面你想换模型，只改模型名，不用动 Key。

如果你更想先验证模型能不能通，可以先用模型对话页面发一条测试消息，确认 Key 有效再往下走。入口在模型对话，登录后直接选模型发消息即可。确认没问题后，我们再进 OpenClaw 的配置环节。

3. 可复制配置：Windows 环境、OpenClaw 安装与 settings.json

3.1 清理旧版 OpenClaw 和 Node.js

如果你之前装过 OpenClaw，一定要先卸干净，否则二次安装会直接复用旧配置，跳过重新配置流程。我当时的报错就是装完发现还是老配置，根本没让我重新填。

先在管理员模式的 PowerShell 里执行卸载命令（如果还记得安装方式）：

npm uninstall -g openclaw

然后手动删掉残留目录。打开文件资源管理器，进入你的用户目录，找到.openclaw文件夹整个删除。再去 npm 的全局目录里找openclaw和openclaw.cmd两个文件删掉。npm 全局目录可以用下面命令查：

npm root -g

把输出的路径复制到资源管理器地址栏，进去后删掉 openclaw 相关文件。Node.js 和 npm 如果也要重装，去控制面板卸载 Node.js，然后手动删掉C:\Program Files\nodejs和用户目录下的.npmrc、node_modules残留。

3.2 安装 Node.js 与 npm

Node.js 是 JavaScript 的运行环境，npm 是包管理工具，OpenClaw 依赖它们。去 Node.js 官网下载 Windows 的 LTS 版本安装包，双击一路下一步即可，安装时勾选「Add to PATH」。装完后 npm 会自动带上。

验证安装：

node -v npm -v

两条命令都能输出版本号就说明环境 OK。如果node -v报「不是内部或外部命令」，说明 PATH 没配好，重新装一遍并确认勾选 Add to PATH。

3.3 安装 OpenClaw

用管理员模式打开 PowerShell，执行官方安装脚本：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装完成后，OpenClaw 会引导你进入配置流程。这里先配一个能跑通的模型，我建议直接用 TaoToken 的统一 Key。配置时它会问你 API 地址和 Key，分别填：

base_url: https://taotoken.net/api api_key: 你的 TaoToken Key model: 按 TaoToken 支持的模型名填写

配置完成后重启网关：

openclaw gateway restart

3.4 settings.json 配置片段

OpenClaw 的配置文件在用户目录下的.openclaw文件夹里，文件名是settings.json。你可以直接用记事本打开编辑，重点是模型通道和飞书通道两块。模型部分参考下面这段：

{ "models": { "default": { "baseUrl": "https://taotoken.net/api", "apiKey": "你的 TaoToken Key", "model": "你的模型名" } } }

飞书通道部分需要填 App ID 和 App Secret，这两个值来自飞书开放平台，下一节会讲怎么拿。先留好位置：

{ "channels": { "feishu": { "appId": "cli_xxxxxxxx", "appSecret": "xxxxxxxxxxxxxxxx" } } }

改完 settings.json 后，一定要重启网关让配置生效：

openclaw gateway restart

4. 飞书机器人接入与连通性验证

4.1 创建飞书机器人并拿凭证

去飞书开放平台创建一个企业自建应用，进入应用后找到「凭证与基础信息」，里面就有 App ID 和 App Secret。把这两个值复制到上面 settings.json 的 feishu 通道里。同时在这个页面把能配的基础信息先配好，比如应用名称、图标，然后先发布一个测试版本。

注意：先不要急着设订阅方式，等 OpenClaw 这边通道配好再回来设，否则长连接容易对不上。

4.2 添加飞书插件并检查通道

在 PowerShell 里执行下面三条命令，重启网关、刷新飞书通道、查看通道列表：

openclaw gateway start openclaw channels restart feishu openclaw channels list

看最后一条命令的输出里有没有feishu。如果有，说明通道已经加载成功，可以继续。如果没有，检查 settings.json 里的 appId 和 appSecret 是否填对，以及有没有重启网关。

4.3 设置长连接与事件订阅

这一步是重中之重，我前几次失败都卡在这里。回到飞书开放平台，进入「事件订阅」页面，选择「使用长连接接收事件」。然后把「消息与群组」相关的事件都勾上，为了方便我全选了。确认添加后，再次申请发布应用。

长连接的作用是让飞书主动把消息推给本地 OpenClaw，不需要公网地址。如果你这里选的是 Webhook 而不是长连接，本地服务收不到消息，就会一直没反应。

4.4 配对码匹配与消息验证

发布通过后，在飞书 App 里搜索你刚发布的机器人，进入对话，随便发一条消息。首次发送时，机器人会返回一个配对码。把这个配对码复制到 PowerShell 里执行配对命令（按 OpenClaw 提示操作即可）。配对成功后，再发消息，机器人就能正常回复了。

验证连通性时，你可以发一句「你好」，看是否返回 AI 回复。如果返回的是模型错误，说明 TaoToken 的 Key 或模型名有问题；如果完全没反应，说明长连接或事件订阅没配好。

5. 本篇常见错排查

问题一：二次安装跳过配置流程。原因是旧版 OpenClaw 没卸干净，.openclaw文件夹或 npm 全局目录里的 openclaw 文件还在。解决方法是按 3.1 节彻底删除，再重新安装。

问题二：openclaw channels list里没有 feishu。检查 settings.json 里 feishu 通道的 appId 和 appSecret 是否填对，以及有没有执行openclaw gateway restart。如果配置文件名或路径不对，OpenClaw 读不到也不会报错。

问题三：飞书发消息没反应。九成是长连接没设。回飞书开放平台确认事件订阅选的是「长连接接收事件」，并且消息与群组事件已勾选、应用已重新发布。另外确认配对码已经完成匹配。

问题四：模型返回鉴权失败。检查 TaoToken 的 Key 是否复制完整，base_url 是否是https://taotoken.net/api。如果 Key 没问题，去模型对话页面发一条消息确认 Key 本身有效。

问题五：node -v或npm -v报错。Node.js 没装好或 PATH 没配。重装 Node.js 并勾选 Add to PATH，装完重启 PowerShell。

问题六：想重新配置 OpenClaw。直接执行openclaw onboard可以重新进入配置流程。想打开网页控制台用openclaw dashboard。

6. 配好之后怎么继续用

整套跑通后，你其实已经拥有了一个本地 AI 网关：飞书负责收发消息，OpenClaw 负责调度，TaoToken 负责模型通道。后面想换模型，只改 settings.json 里的模型名，Key 和地址不用动。想加别的聊天通道，也是同样的思路，在 channels 里加配置再重启网关。

如果你打算长期在本地跑编码或 Agent 类任务，可以考虑用 Coding Plan 把额度固定下来，比每次单独申请更省事。配置过程中如果遇到通道或 Key 的问题，直接去 API Keys 页面重新生成一个 Key 替换，再对照接入文档检查参数格式。模型本身的行为想快速验证，用模型对话页面最直接，不用每次都走飞书绕一圈。