★ FEATURED ARTICLE 1. 为什么要在 Windows 上把 OpenClaw 接进飞书OpenClaw 是一个可以跑在自己电脑上的 AI 助手网关它能把你常用的聊天工具变成 AI 的入口。飞书作为国内团队协作场景里使用频率很高的工具把 OpenClaw 接进去之后你就能直接在飞书对话框里给 AI 下指令让它帮你处理文本、写代码、整理信息相当于给自己配了一个随叫随到的 AI 打工人。这套方案适合谁零基础但愿意跟着步骤敲命令的 Windows 用户、想把 AI 能力嵌进日常办公流的人、以及不想折腾服务器只想本地跑通链路的开发者。整条链路的核心是Node.js 提供运行环境OpenClaw 作为网关服务飞书开放平台提供机器人能力TaoToken 提供统一的模型 API 通道。四者串起来你就能在飞书里发消息、AI 在本地生成回复、消息再回到飞书。我实测下来整个流程最容易卡住的地方有三个PowerShell 执行策略拦截脚本、飞书事件回调没配长连接、以及默认模型没有可用 Key 导致启动报错。下面按顺序把每一步拆开讲跟着做基本能一次跑通。2. 环境准备Node.js、Git 与 PowerShell 执行策略2.1 安装 Node.js v22 以上OpenClaw 要求 Node.js 版本不低于 v22.0.0。打开官网 https://nodejs.org/zh-cn 点击绿色的 Windows 安装程序 (.msi)双击一路下一步即可。安装路径建议保持默认避免后续环境变量出问题。装完后按Ctrl Win打开命令行输入node -v如果输出类似v22.x.x说明环境就绪。如果提示找不到命令去系统环境变量里确认 Node.js 的安装目录已经加入 Path。2.2 安装 GitOpenClaw 安装过程依赖 Git没有它会在安装阶段报错。去 https://git-scm.com/download/win 下载安装包同样傻瓜式下一步。装完按Win R输入powershell执行git --version能显示版本号就说明 Git 可用。2.3 放宽 PowerShell 执行策略Windows PowerShell 默认不允许运行未签名脚本直接跑 OpenClaw 安装脚本会报执行策略错误。以管理员身份打开 PowerShellWin Q搜索 powershell右键以管理员运行执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser提示确认时输入Y回车。这一步只影响当前用户不会改动系统全局策略相对安全。注意如果你在公司受管设备上操作执行策略可能被组策略锁定这种情况下需要联系 IT 或改用其他安装方式。3. TaoToken 前置统一 Key 与 API 通道OpenClaw 启动后需要调用大模型来生成回复默认配置里选的是 Anthropic 的 Claude 模型但你没有对应 Key 就会启动失败。与其到处找各家 Key不如用 TaoToken 做统一通道一个 Key 走通多个模型。TaoToken 的定位是模型 API 聚合网关你可以在官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 了解它的能力范围。核心操作是先去控制台创建一个 API Key然后拿到统一的 Base URL。具体步骤第一打开控制台页面 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 注册或登录账号。第二进入 API Keys 管理页 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 点击创建新 Key复制保存。这个 Key 后面要填进 OpenClaw 的配置里。第三记住 API 端点地址https://taotoken.net/api。这个地址不加任何查询参数直接作为 OpenAI 兼容接口的 base_url 使用。如果你对模型能力有疑问可以先去模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 试一下对话效果确认 Key 能正常工作再往下走。提示Key 只显示一次复制后妥善保存。不要把它写进公开的代码仓库或截图里。4. 可复制配置安装 OpenClaw 并写入 config.toml4.1 切换 npm 镜像并执行安装为了避免下载过程中网络抖动导致失败先切换国内镜像npm config set registry https://registry.npmmirror.com然后在 PowerShell 里执行 OpenClaw 官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex等待安装完成期间不要关闭窗口。安装脚本跑完后会进入交互式配置流程。4.2 交互式配置的关键选择配置过程会用方向键选择按回车确认。几个关键节点第一询问是否信任本机使用时输入Yes。第二选择QuickStart进入快速配置。第三模型来源选All providers避免漏掉你要用的模型。第四默认模型那一步先选Keep current后面我们通过openclaw configure改成 TaoToken 通道。第五平台选择Feishu/Lark(飞书)。第六插件路径选Use local plugin path。到这里配置会暂停提示你去飞书开放平台申请 App ID 和 App Secret。先别关窗口。4.3 飞书应用配置骨架打开 https://open.feishu.cn/app 点击创建企业自建应用填写名称比如「OpenClaw智能管家」确定创建。进入凭证与基础信息页复制 App ID 和 App Secret。然后在左侧菜单「添加应用能力」里选择机器人并开启。接着进入「权限管理」点击批量导入粘贴以下 JSON{ scopes: { tenant: [ contact:user.base:readonly, contact:user.id:readonly, im:chat, im:chat:read, im:chat:readonly, im:message, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:message:readonly, im:message:send_as_bot, im:resource ], user: [] } }点击申请开通。然后去「版本管理与发布」创建版本版本号填 1.0.0保存并确认发布等待审核通过。4.4 事件回调配置左侧菜单点「事件与回调」点击订阅方式旁边的编辑按钮选择「使用长连接接收事件」。这一步先别急着保存因为 OpenClaw 那边还没填 App ID 和 Secret保存会报错。回到之前保留的 PowerShell 窗口把 App ID 和 App Secret 依次输入回车确认默认的 WebSocket 连接模式地区选China。后续几个配置项选Skip for now跳过先把核心链路跑通。OpenClaw 启动后会显示运行日志这个小黑屏窗口是网关服务必须保持打开飞书机器人才能持续工作。现在回到飞书开放平台点击保存事件回调配置。4.5 用 TaoToken 替换默认模型如果直接启动 OpenClaw 报模型 API Key 找不到的错误说明默认的 Claude 模型没有可用 Key。执行openclaw configure选择Local (this machine)再选Model。这里我们要接入 TaoToken 的统一通道。在模型配置环节把 base_url 填成https://taotoken.net/apiAPI Key 填你在 TaoToken 控制台创建的那个 Key模型名填你需要的模型标识。如果你更习惯用命令行直接改配置文件OpenClaw 的配置通常位于用户目录下的.openclaw/config.toml可以手动加入类似段落[model] provider openai-compatible base_url https://taotoken.net/api api_key 你的TaoToken Key model 你的模型名保存后重新执行openclaw gateway启动网关。5. 验证请求消息回环与成功结果5.1 启动网关并访问本地面板在 PowerShell 执行openclaw gateway然后在浏览器打开http://127.0.0.1:18789/能看到 OpenClaw 的本地管理面板就说明网关起来了。5.2 飞书端添加事件并发布回到飞书开放平台进入「事件与回调」点击添加事件搜索im.message.receive_v1勾选「接收消息」并添加。然后重新发布一个版本确保事件订阅生效。5.3 配对码验证在飞书客户端搜索你的机器人名称直接发一条消息。如果配置正确机器人会回复一个配对码。拿到配对码后在 PowerShell 执行openclaw pairing approve feishu 配对码看到批准成功的提示后再回飞书发消息机器人就能正常回复了。整个回环链路飞书消息 → 长连接事件 → OpenClaw 网关 → TaoToken API → 模型生成 → 回复回飞书。如果你在验证模型回复质量时想快速对比不同模型可以打开模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 直接测试确认哪个模型更适合你的场景再写回配置。6. 本篇常见错排查6.1 安装脚本报执行策略错误现象运行iwr -useb https://openclaw.ai/install.ps1 | iex时提示「无法加载文件因为在此系统上禁止运行脚本」。原因PowerShell 执行策略限制。解决以管理员身份运行 PowerShell执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认。6.2 飞书事件回调保存报错现象在飞书开放平台选择长连接后点击保存提示配置失败。原因OpenClaw 端还没填入 App ID 和 App Secret飞书无法完成握手验证。解决先回到 OpenClaw 配置窗口填入凭证等网关启动后再回飞书保存。6.3 启动后报模型 API Key 缺失现象openclaw gateway启动后日志里出现找不到 API Key 的错误。原因默认模型是收费的 Claude没有配置对应 Key。解决执行openclaw configure切换到 TaoToken 通道填入https://taotoken.net/api和你的 Key。6.4 飞书发消息没有回复排查顺序第一确认飞书开放平台「事件与回调」里订阅了im.message.receive_v1且订阅方式是长连接不是 HTTPS 推送。第二确认应用版本已经发布到测试环境或正式环境草稿状态下机器人发不出消息。第三确认 OpenClaw 网关窗口还开着关掉窗口服务就停了。第四检查配对码是否已经批准。6.5 网关启动但浏览器打不开面板确认端口 18789 没有被其他程序占用。可以在 PowerShell 执行netstat -ano | findstr 18789查看占用情况。如果被占用修改 OpenClaw 配置里的端口号后重启。7. 长期编码与 Agent 场景的接入建议如果你不只是想在飞书里聊天而是想把 OpenClaw 当成长期编码助手或 Agent 调度入口建议把模型通道固定下来避免每次换模型都改配置。TaoToken 的 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 有面向编码场景的套餐说明适合需要稳定调用量的用户。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有完整的接口参数和示例。如果你用的是 Claude Code 这类工具可以参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentClaudeCodeAnthropicutm_campaignrewrite 里的配置方式把 Anthropic 兼容通道指向 TaoToken。API Keys 管理入口再放一次https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。建议给不同用途创建不同的 Key方便按项目统计用量和随时吊销。整套流程跑通后你得到的是一个本地运行、飞书触达、模型通道统一的 AI 打工人。后续想换模型、加技能、接更多平台都只需要改配置而不用重装环境。踩过的坑基本集中在执行策略、事件回调和模型 Key 这三处按上面的排查顺序走大部分问题都能自己解决。
阅读完成 · 觉得有帮助？
