1. 为什么要在 Windows 上把 OpenClaw 接进飞书OpenClaw 是一个开源的多渠道 AI 网关简单说就是给 AI 模型装了一个“总机”让同一个助手能同时挂在飞书、网页控制台等多个入口上。你在飞书群里 一下机器人它就能帮你整理会议纪要、设置定时提醒、查询数据甚至定时生成日报。对于每天泡在飞书里的团队来说这相当于把 AI 能力直接塞进了日常办公流。这篇教程聚焦 Windows 环境从零把 OpenClaw 跑起来并接入飞书。适合谁有 Windows 10/11 电脑、会基本命令行操作、想让 AI 助手在飞书里干活的同学。整个过程覆盖 Node.js 与 PowerShell 前置准备、TaoToken 统一 Key/API 通道配置、飞书机器人事件订阅与回调验证最后交付一份可复制的 config.toml 骨架、PowerShell 启动命令和消息收发验证动作。目标很明确一次跑通本地到飞书的闭环。我试过在几台不同配置的 Windows 机器上部署踩过的坑主要集中在执行策略、环境变量刷新和飞书权限审核这三块。下面按顺序来每一步都给出可复制的命令和预期结果。2. 前置准备Node.js、Git 与 PowerShell 执行策略2.1 系统要求与安装 Node.js操作系统建议 Windows 10 21H2 及以上或 Windows 11 64 位内存 4GB 起步8GB 以上更稳硬盘留出 1GB 可用空间全程需要管理员权限。OpenClaw 基于 Node.js 开发要求 v22.0.0 或更高版本。去 Node.js 官网下载 LTS 版本的.msi安装包双击一路“下一步”保持默认路径即可。装完后按Win R输入powershell回车执行node --version npm --version如果显示v22.12.0或更高说明安装成功。这里有个细节装完 Node.js 后如果当前 PowerShell 窗口是之前打开的环境变量不会自动刷新必须关掉重开否则会提示node 不是内部或外部命令。2.2 安装 Git 与放宽执行策略OpenClaw 的部分依赖需要从 Git 仓库拉取去 Git 官网下载 Git for Windows用默认设置装完执行git --version验证。Windows PowerShell 默认禁止运行未签名脚本需要临时放宽。以管理员身份打开 PowerShellWin Q搜索 PowerShell右键“以管理员身份运行”执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser提示后输入Y回车确认。如果后续出现中文乱码补一条$OutputEncoding [Console]::InputEncoding [Console]::OutputEncoding [System.Text.Encoding]::UTF8 chcp 650012.3 切换镜像源并安装 OpenClaw为避免下载超时先把 npm 源切到国内镜像npm config set registry https://registry.npmmirror.com然后在管理员 PowerShell 中执行一键安装iwr -useb https://openclaw.ai/install.ps1 | iexiwr是Invoke-WebRequest的缩写-useb使用基本解析兼容性更好| iex把下载内容直接执行。等待安装完成期间别关窗口。装完执行openclaw --version出现版本号即成功。3. TaoToken 统一 Key 与 API 通道配置3.1 为什么用 TaoToken 做统一通道OpenClaw 支持多种模型平台但如果你同时想用 Claude、GPT 等不同模型逐个配 Key 会很乱。TaoToken 提供统一的 API 通道一个 Key 就能调用多个模型配置时只需要填一个地址和一个 Key省去反复切换服务商的麻烦。对于飞书办公助手这种需要长期稳定运行的场景统一通道能减少因单个平台额度或网络波动导致的掉线。3.2 获取 Key 与配置模型先到 TaoToken 控制台创建一个 API Key地址是https://taotoken.net/api-keys。创建后复制保存注意不要带多余空格或换行。然后在 OpenClaw 配置向导里选择自定义 Provider填入以下参数配置项值Provider 类型Custom / OpenAI CompatibleBase URLhttps://taotoken.net/apiAPI Key你刚创建的 Key模型名称按需填写如claude-sonnet-4-20250514如果你更习惯用配置文件OpenClaw 的配置目录在C:\Users\你的用户名\.openclaw\核心文件是openclaw.json或config.toml。下面是一份可复制的config.toml骨架[gateway] port 18789 bind 127.0.0.1 [provider.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你的Key model claude-sonnet-4-20250514 [channel.feishu] enabled true app_id cli_你的AppID app_secret 你的AppSecret connection_mode websocket region china注意api_key和app_secret属于敏感信息不要提交到公开仓库也不要在截图里暴露。3.3 验证模型通道是否通配置完成后先用命令行验证模型通道避免后面飞书接好了却发现模型不通。执行openclaw gateway run这个命令前台启动网关并输出实时日志。另开一个 PowerShell 窗口执行一次简单对话测试openclaw chat 你好请回复一句话如果返回正常文本说明 TaoToken 通道已经打通。如果报unauthorized或token_missing先检查 Key 是否复制完整再执行openclaw doctor --fix清理认证缓存。4. 飞书机器人配置与事件订阅4.1 创建飞书应用并获取凭证访问飞书开放平台点击“创建企业自建应用”填写应用名称如“我的OpenClaw助手”和描述创建后进入应用详情页。左侧菜单点“凭证与基础信息”复制App ID和App Secret保存好。这两个凭证等下要填进 OpenClaw。接着在“添加应用能力”里添加机器人能力确认添加。4.2 安装飞书插件并填入凭证回到 PowerShell执行飞书插件安装openclaw plugins install m1heng-clawd/feishu安装完成后按提示依次输入 App ID、App Secret连接模式直接回车选默认的 WebSocket地区选 China。WebSocket 模式的好处是不需要公网 IP 和域名本地电脑就能接收飞书事件对个人用户非常友好。4.3 批量导入权限与配置事件订阅在飞书开放平台应用后台左侧点“权限管理”找到“批量导入/导出权限”点“导入”粘贴以下 JSON{ scopes: { tenant: [ contact:user.base:readonly, im:chat, im:chat.access_event.bot_p2p_chat:read, im:message, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:message:readonly, im:message:send_as_bot, im:resource ], user: [] } }点“添加格式化JSON”查看权限列表后点“下一步”→“申请开通”→“确认开启”。然后左侧点“事件与回调”订阅方式选“使用长连接接收事件”WebSocket 模式保存。再点“添加事件”搜索并勾选im.message.receive_v1接收消息事件。这个事件的作用是当你给机器人发消息时飞书会通过长连接通知 OpenClaw 处理。4.4 发布应用与配对绑定左侧点“版本管理与发布”→“创建版本”填版本号如 1.0.0和更新说明保存后确认发布等待审核通过。打开飞书客户端搜索你创建的应用名称打开对话框发送任意消息如“你好”。机器人会自动回复一个配对码格式类似openclaw pairing approve feishu XXXX。把完整配对码复制粘贴回 OpenClaw 的 PowerShell 窗口回车完成绑定。5. 验证请求与成功结果5.1 消息收发闭环验证绑定成功后在飞书里再发一条消息比如“帮我列三个今天的待办”。预期结果是机器人几秒内回复一段结构化文本。如果收到回复说明本地到飞书的闭环已经跑通。同时在 OpenClaw 的 PowerShell 窗口里你能看到实时日志滚动类似[feishu] received message from user: ou_xxxx [provider] request to taotoken, modelclaude-sonnet-4-20250514 [feishu] reply sent, msg_idom_xxxx这三行日志分别对应飞书收到消息、请求发往 TaoToken、回复已发送。任何一环断了日志里都会停在对应位置方便定位。5.2 常用运维命令电脑重启后网关通常通过 Windows 计划任务自动运行。如果需要手动操作常用命令如下命令用途openclaw gateway run前台启动带实时日志适合排查openclaw gateway start后台启动长期使用openclaw gateway stop停止后台服务openclaw gateway restart重启网关openclaw doctor自动诊断配置问题openclaw logs follow查看实时日志openclaw status查看服务状态也可以直接运行安装生成的脚本C:\Users\你的用户名\.openclaw\gateway.cmd。6. 本篇常见错误排查6.1 安装与命令类报错提示“无法加载文件因为在此系统上禁止运行脚本”执行策略没设。以管理员身份运行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser输入Y确认。输入openclaw提示“不是内部或外部命令”环境变量未刷新。关掉当前 PowerShell重新以管理员身份打开即可。6.2 模型通道类报错API Key 配置了但对话没回复先确认 Key 复制时没有多余空格或换行再执行openclaw configure重新输入。如果用的是海外模型且网络不稳可以换用 TaoToken 统一通道里的其他模型。最后检查账户额度是否用完。遇到unauthorized或token_missing网关认证未通过。执行openclaw doctor --fix清理认证配置或访问http://127.0.0.1:18791跳过认证。6.3 飞书接入类报错机器人收不到消息按顺序检查五点——应用是否已发布、事件订阅里是否配了im.message.receive_v1、接收方式是否选的“长连接”、im:message权限是否审核通过、网关是否在运行openclaw gateway status。发消息提示权限不足检查im:message:send_as_bot权限是否已申请通过这是机器人发送消息的必要权限。App Secret 泄露立即去飞书开放平台→应用→凭证与基础信息→重置 App Secret然后更新 OpenClaw 配置。7. 后续扩展与接入文档跑通基础闭环后你可以继续扩展 OpenClaw 的能力。定时任务模块Cron支持提醒、信息检查、文件备份和自动生成日报智能体系统Agents可以创建多个不同角色的助手每个用不同模型、有独立工作目录浏览器集成Browser Relay装个 Chrome 插件后还能让 AI 直接操作浏览器。如果你在接入过程中遇到认证或通道配置问题可以到 TaoToken 接入文档查对应参数说明https://taotoken.net/doc。想先验证模型对话效果直接打开模型对话页面试一句https://taotoken.net/chat。长期跑编码或 Agent 类任务的话Coding Plan 会更划算https://taotoken.net/coding-plan。需要管理多个 Key 或查看用量控制台在https://taotoken.net/console。整套流程里最容易卡住的是飞书权限审核和 PowerShell 执行策略这两步把这两处过了剩下的基本就是复制粘贴。跑通之后你在飞书里 一下机器人就能干活比来回切网页顺手得多。