企业官网建设流程全解析

1. 为什么要在 Windows 上把 OpenClaw 接进飞书

OpenClaw 是一个可以跑在你自己电脑上的本地 AI Agent，它和普通聊天机器人的最大区别在于：你丢给它一件事，它会自己拆步骤、读写本地文件、执行命令，最后把结果告诉你。而飞书接入的意义在于，你不需要坐在那台电脑前，在手机或任意设备的飞书里发条消息，本地的 OpenClaw 就能开始干活。这套组合特别适合想把 AI 助手嵌入团队协作流的开发者——比如让它在群里接收任务、整理文件、跑脚本，然后把结果直接发回飞书。

我第一次接触 OpenClaw 的时候，以为它就是个"高级点的聊天机器人"，真正跑起来才发现完全不是一回事。普通 ChatBot 是你问一句它回一句，对话结束就完了；OpenClaw 更像是你丢给它一个任务，它在你电脑上折腾一会儿，干完了再来敲你一声。它能直接读本地文件、改名、打包、整理目录，也能跑一些你懒得手动敲的命令。从这点来看，它更像是一个坐在你电脑里的工具人。

如果你也有下面这些想法，这篇教程大概率能帮到你：不太想每件事都手动来一遍、希望 AI 能直接操作自己的电脑、想把 AI 接进飞书用起来顺手一点、有些东西不太想全丢到云端服务器。整条链路走下来其实不复杂：Windows 本地部署 OpenClaw → 配置模型通道 → 创建飞书自建应用 → 配置事件订阅 → 端到端验证一条消息从飞书到本地 OpenClaw 的完整流转。

需要提前说清楚的是，OpenClaw 权限很大，它可以直接操作你的电脑文件系统。测试阶段不建议在主力工作机上折腾，或者部署之前先把重要文件备份好。另外本文聚焦 Windows 10/11 环境，macOS 上的安装流程大同小异，坑反而更少，所以这里只写 Windows 这条更容易卡住人的路径。

在模型调用这一层，我建议用 TaoToken 统一管理 Key 和 API 通道。原因很简单：OpenClaw 支持多种模型提供商，如果你后面要切换模型或者同时用多个模型，把 Key 散落在各个平台的配置文件里会非常难维护。TaoToken 提供一个统一的 API 入口，Base URL 和 Key 集中管理，切换模型时只改一个 Model ID 就行，不用到处翻配置文件。官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api 。

2. 前置准备：Node.js、Git 与 TaoToken Key 申请

在动手装 OpenClaw 之前，先把环境铺好。Windows 上需要的东西不多：Node.js（必需）、Git（拉取插件和依赖用）、一个可用的模型 API Key。下面一步步来。

2.1 安装 Node.js

前往 Node.js 官网下载 Windows 安装包，选择.msi版本，一路默认安装即可。安装过程中会弹出一个安装脚本说明页，按任意键确认就行。安装完成后打开 CMD 验证：

node -v npm -v

只要能看到版本号，就说明 Node.js 环境 OK。如果提示"不是内部或外部命令"，说明安装时没有勾选添加到 PATH，重新跑一遍安装包，确保勾选"Add to PATH"。

2.2 安装 Git

进入 Git 官网下载 Windows 安装包，同样一路默认安装。装完后在 CMD 里验证：

git --version

能看到版本号即可。Git 在后面安装飞书插件时会用到，因为 OpenClaw 的插件生态大多通过 Git 仓库分发。

2.3 申请 TaoToken API Key

打开 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册登录后进入控制台。在 API Keys 页面创建一个新的 Key，复制保存好。这个 Key 后面会填到 OpenClaw 的模型配置里。

TaoToken 的好处是它把多个模型的调用通道统一到一个 Base URL 下。你不需要为每个模型单独记一套地址和 Key，只要在配置里改 Model ID 就能切换。对于 OpenClaw 这种需要频繁试不同模型的场景，这一点省事很多。

创建完 Key 之后，记下两个东西：Base URL（https://taotoken.net/api）和你的 API Key。这两个值在下一步配置 OpenClaw 时会直接用到。

2.4 关于模型选择

OpenClaw 支持多种模型提供商。你可以用 TaoToken 统一通道，也可以接其他提供商的 API。本文以 TaoToken 为例，因为它的配置最简洁：一个 Base URL、一个 Key、一个 Model ID，三件套填完就能跑。如果你后面想换模型，只改 Model ID 那一行就行，不用动其他配置。

3. 安装 OpenClaw 并配置 TaoToken 模型通道

环境铺好之后，开始装 OpenClaw。这一步在 PowerShell 里操作，建议以管理员身份运行。

3.1 放开执行策略并运行安装脚本

在开始菜单搜索 PowerShell，右键以管理员身份运行。先临时放开执行策略（只对当前窗口生效）：

Set-ExecutionPolicy Bypass -Scope Process

输入 Y 回车确认。然后执行 OpenClaw 官方安装脚本：

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

看到免责声明时选择 YES。安装完成后会自动进入配置向导。

3.2 配置向导中的关键选择

配置模式选择 QuickStart。模型提供商这一步，如果你用 TaoToken 统一通道，选择自定义或对应的兼容选项（不同版本向导选项名称可能略有差异，核心是找到能填 Base URL 的那一项）。模型版本按你实际想用的填，比如 Claude 系列或 GPT 系列的 Model ID。

接下来填写 API Key，把刚才在 TaoToken 控制台创建的 Key 贴进去。填写完成后保持默认选项即可。

接入渠道（Channel）选择页先跳过，我们后面单独配飞书。提示是否注册 Skill 时选择第一个（注册 Skill 能力），具体 Skill 后面按需配置，这里可以先跳过。后面几个选项选默认的 NO。启动方式可以选 TUI 或 WEBUI，我选 WEBUI，设置完成后会自动打开浏览器页面，这就是 OpenClaw 的聊天与设置界面。

3.3 修改 openclaw.json 配置文件

安装完成后，OpenClaw 的配置文件在：

C:\Users\你的用户名\.openclaw\openclaw.json

用编辑器打开这个文件，找到 model 字段。如果你用的是 TaoToken 统一通道，配置大概长这样：

{ "model": { "provider": "custom", "baseUrl": "https://taotoken.net/api", "apiKey": "你的TaoToken API Key", "modelId": "claude-sonnet-4-20250514" } }

三个关键字段对照如下：

如果你之前用的是其他提供商的默认配置，把 baseUrl 改成 TaoToken 的地址，apiKey 换成 TaoToken 的 Key，modelId 填你想用的模型即可。改完保存文件。

3.4 重启网关使配置生效

配置改完后需要重启 OpenClaw 网关。打开 CMD 输入：

openclaw gateway restart

看到网关正常启动的提示后，回到 WEBUI 页面发一条测试消息。如果收到正常回复，说明模型通道已经打通。如果报错，先检查 baseUrl 和 apiKey 是否填对，再看 modelId 是否是 TaoToken 支持的模型。

4. 创建飞书自建应用并配置事件订阅

模型通道打通后，接下来把 OpenClaw 接进飞书。这一步在飞书开放平台操作，核心是创建自建应用、配权限、开事件订阅、发布版本。

4.1 创建企业自建应用

进入飞书开放平台 https://open.feishu.cn/ ，创建企业自建应用。创建完成后，先去"凭证与基础信息"页面，记下两个东西：App ID 和 App Secret。这两个值后面配置 OpenClaw 时要用。

4.2 配置权限

来到"权限管理"页面，把官方给的权限 JSON 整个贴进去。内容如下：

{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } }

贴完后点"申请开通"。另外建议顺手加上contact:contact.base:readonly这个权限，不加也能用，但不加的话飞书会时不时弹提示，比较烦。

4.3 启用机器人并配置事件订阅

权限搞定后，去"机器人"那一栏，点一下修改机器人名称，相当于把机器人正式启用。

接着是"事件与回调"页面。这里要把模式改成长连接，然后手动添加一个事件。点击"添加事件"，搜索im.message.receive_v1并添加。这个事件一定要加，不加的话机器人收不到你发的任何消息，看起来像是"配置好了但完全不工作"。

4.4 发布应用版本

最后去"版本管理"页面，新建一个版本并发布。不发布版本，机器人是用不了的。到这里飞书后台的配置就算完成了。

5. 在 OpenClaw 中配置飞书插件并端到端验证

飞书后台配好后，回到 OpenClaw 这边。这一步可以直接让 OpenClaw 自己装插件，省去手动配置的麻烦。

5.1 安装飞书插件

在 OpenClaw 的 WEBUI 聊天框里直接说：

帮我安装飞书插件: https://github.com/AlexAnys/openclaw-feishu

OpenClaw 会自己去拉取仓库并安装。等它提示安装完成即可。这一步比手动 clone、npm install 省事很多，也是 OpenClaw 作为 Agent 的一个典型用法——你给它一个任务，它自己拆步骤完成。

5.2 配置飞书凭证

插件装好后，把飞书的 App ID 和 App Secret 告诉 OpenClaw：

我的飞书 appId:XXXXX appSecret:XXXX 帮我配置下

过一会儿它会告诉你配置完成。这一步 OpenClaw 会自动把凭证写入对应的配置文件，你不需要手动改 JSON。

5.3 重启网关并验证

配置完成后重启网关：

openclaw gateway restart

看到网关正常启动后，打开飞书，找到你的机器人，发一条消息。如果机器人正常回复，说明整条链路已经打通：飞书消息 → 飞书事件订阅 → 本地 OpenClaw → 模型调用 → 回复发回飞书。

5.4 端到端验证动作

为了确认它真的能干活，可以丢一个稍微复杂点的任务，比如：

帮我把 D:\test 目录下的所有 .txt 文件按修改时间排序，打包成一个 zip 放到桌面

然后你就可以去干别的事了。回来一看，压缩包已经打好放在桌面，文件名也整理好了。到这一步，OpenClaw 已经不是"能不能跑"的问题，而是真的可以开始在这台电脑上替你干活了。

6. 常见报错排查：401、local proxy failed 与事件不生效

配置过程中最容易卡住的就是几个典型报错。下面按实际遇到的顺序整理。

6.1 401 Unauthorized

这是最常见的报错，说明 API Key 或 Base URL 有问题。检查openclaw.json里的apiKey是否和 TaoToken 控制台创建的一致，baseUrl是否是https://taotoken.net/api。如果 Key 复制时带了空格，也会导致 401。另外确认一下 TaoToken 账户里是否有可用额度。

6.2 local proxy failed

这个报错通常出现在网关启动阶段，说明本地代理端口被占用或网关没起来。先确认openclaw gateway restart是否成功执行，然后检查是否有其他程序占用了 OpenClaw 的默认端口。可以尝试重启电脑后再启动网关。如果还是不行，检查防火墙是否拦截了本地回环地址的通信。

6.3 reading choices 报错

这个报错一般出现在模型返回格式不符合预期时。常见原因是 modelId 填错了，或者该模型不支持 OpenClaw 的调用格式。解决办法是换一个确认支持的 Model ID，或者检查 TaoToken 控制台里该模型是否可用。如果用的是兼容 Anthropic 格式的通道，确认 baseUrl 路径是否正确。

6.4 飞书事件不生效

机器人配置好了但收不到消息，九成是事件订阅没配对。检查三件事：事件im.message.receive_v1是否已添加、事件订阅模式是否改成了长连接、应用版本是否已发布。这三步缺一不可。另外确认机器人是否已在飞书里启用（修改机器人名称那一步）。

6.5 OAuth 相关报错

如果出现 OAuth 相关提示，通常是飞书应用的权限范围没配对，或者 App ID / App Secret 填错了。回到飞书开放平台的"凭证与基础信息"页面重新核对，然后重新让 OpenClaw 配置一次凭证，最后重启网关。

6.6 配置三件套速查

无论用哪种方式接入，核心配置永远是三件套：Base URL、Key、Model ID。以 TaoToken 为例：

如果你用的是 CC Switch、Cline MCP 或 Codex 的 auth.json，同样遵循这三件套的逻辑：Base URL 指向 TaoToken 的 API 入口，Key 填 TaoToken 创建的 Key，Model ID 填你想用的模型。三件套对齐了，大部分接入问题都能解决。

7. 把 AI 员工用起来：统一通道与后续扩展

整条链路走完之后，你会发现本地跑 Agent、接一个 Channel、再丢进聊天平台用，这个模式是通用的。后面不管是接企业微信还是其他协作工具，本质都只是换个入口而已，核心的 OpenClaw 和模型通道不用动。

用 TaoToken 统一管理模型调用的好处在这里会越来越明显：当你后面想试不同模型、或者同时跑多个 Agent 时，不需要为每个模型单独维护一套 Key 和地址。一个 Base URL、一个 Key、改 Model ID 就能切换，配置文件干净很多。对于长期跑编码任务或 Agent 的场景，也可以了解一下 Coding Plan 相关的通道方案，把调用成本和管理复杂度都降下来。

几个实用建议：测试阶段别在主力机上跑关键任务，OpenClaw 的权限确实不小；飞书权限 JSON 直接整段贴，别手动一个个勾，容易漏；事件订阅那一步一定要确认长连接模式和版本发布都做了，否则会陷入"看起来配好了但完全不工作"的坑。如果后面要换模型，只改openclaw.json里的 modelId 那一行，然后openclaw gateway restart就行。

需要创建 Key 或查看接入文档的话，可以从 API Keys 页面和接入文档入手；想先验证模型对话效果，用模型对话页面快速试一下；长期编码或 Agent 场景则看 Coding Plan。通道配好之后，剩下的就是你想让这位"AI 员工"干什么活了。