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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台。在 API Keys 页面创建一个新的 Key复制保存好。这个 Key 后面会填到 OpenClaw 的模型配置里。TaoToken 的好处是它把多个模型的调用通道统一到一个 Base URL 下。你不需要为每个模型单独记一套地址和 Key只要在配置里改 Model ID 就能切换。对于 OpenClaw 这种需要频繁试不同模型的场景这一点省事很多。创建完 Key 之后记下两个东西Base URLhttps://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 } }三个关键字段对照如下字段填写内容说明baseUrlhttps://taotoken.net/apiTaoToken 统一 API 入口apiKey你的 TaoToken Key在控制台 API Keys 页面创建modelId具体模型 ID按需切换改这一行即可换模型如果你之前用的是其他提供商的默认配置把 baseUrl 改成 TaoToken 的地址apiKey 换成 TaoToken 的 KeymodelId 填你想用的模型即可。改完保存文件。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-feishuOpenClaw 会自己去拉取仓库并安装。等它提示安装完成即可。这一步比手动 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 为例配置项值Base URLhttps://taotoken.net/apiAPI Key在 TaoToken 控制台创建Model ID按需选择改这一行即可切换模型如果你用的是 CC Switch、Cline MCP 或 Codex 的 auth.json同样遵循这三件套的逻辑Base URL 指向 TaoToken 的 API 入口Key 填 TaoToken 创建的 KeyModel 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 员工干什么活了。