1. 为什么要在命令行里把 OpenClaw 飞书插件跑通OpenClaw 是一个本地部署的开源个人 AI 智能体能直接操作电脑、跑定时任务、做浏览器自动化数据留在本机。它支持把飞书、钉钉这类聊天工具当作远程遥控入口你在手机上发一句话电脑那头的智能体就开始干活。飞书插件就是这座桥飞书负责收指令OpenClaw 负责执行再把结果回传。问题在于很多人卡在“装完插件但飞书没反应”。要么是依赖没对齐要么是凭证写错位置要么是事件订阅没开长连接最后openclaw status里插件是灰的。这篇就按终端实操的顺序从依赖检查一路走到消息回环验证把config.toml骨架、CC Switch 切换配置、curl 验证动作都给你目标是在命令行里确认插件启用、飞书侧收发正常。适合谁已经装好 OpenClaw、Gateway 能跑起来但飞书插件还没接通的人或者想用统一 Key 管理模型调用、不想每个插件单独配一遍凭证的人。全程不需要图形界面复制命令即可。2. 前置TaoToken 统一 Key 与依赖检查OpenClaw 的飞书插件本身只管消息通道真正干活时还是要调模型。如果你不想在每个插件、每个渠道里重复填 API Key可以用 TaoToken 做统一入口。它的 API 地址是https://taotoken.net/api兼容常见的 OpenAI 风格调用把 Key 配一次OpenClaw 这边指向它就行。先去控制台建一个 Key打开https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite在 API Keys 页面创建复制出来备用。文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入参数以文档为准。依赖检查这一步别跳过。飞书插件依赖 Node 运行时和 OpenClaw 的插件加载器版本不对会直接报plugin load failed。在终端里跑node -v openclaw --version openclaw plugins listnode -v建议 18 以上openclaw --version确认主程序在openclaw plugins list看当前已装插件如果列表里没有 feishu 相关项说明还没装。另外确认 Gateway 在线openclaw status输出里Gateway: running是前提。如果这里就是 stopped先openclaw gateway start别急着装插件。注意飞书侧需要企业/团队账号才能创建自建应用个人版没有开发者后台入口。这一步在飞书开放平台完成和 OpenClaw 本机配置是两条线先拿到 App ID 和 App Secret 再回来。3. 可复制配置插件安装与 config.toml 骨架3.1 安装飞书插件以管理员身份打开终端Windows 用 PowerShellmacOS/Linux 用对应 shell执行openclaw plugins install m1heng-clawd/feishu等提示安装成功后新建一个终端窗口再配置避免旧进程缓存干扰。装完可以用openclaw plugins list复查应该能看到 feishu 条目。3.2 写入 config.toml 骨架OpenClaw 的配置集中在config.toml。你可以用交互式向导openclaw config生成也可以直接手写。下面是一份可复制的骨架把占位符换成你自己的值[gateway] port 18789 host 127.0.0.1 [model] provider taotoken base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model gpt-4o-mini [plugins.feishu] enabled true app_id cli_你的AppID app_secret 你的AppSecret domain cn group_policy accept event_mode long_connection几个关键点base_url指向 TaoToken 的 API 地址api_key填刚才在控制台建的 Keydomain cn对应飞书中国区event_mode long_connection表示用长连接接收事件这样本机不需要公网回调地址适合本地部署。group_policy accept允许群组里 机器人触发。3.3 CC Switch 切换配置如果你有多个环境比如测试和生产各一套 Key可以用 CC Switch 做配置切换避免手改config.toml。它的作用是维护多份 profile切换时替换当前生效的配置段。典型用法cc-switch list cc-switch use taotoken-prod cc-switch currentcc-switch current会打印当前生效的 profile 名和关键字段Key 会脱敏。切换后记得重启 Gateway让新配置加载openclaw gateway restart重启完再openclaw status看到Feishu Plugin: Active才算插件层通了。4. 验证请求curl 打通与消息回环4.1 先用 curl 验证模型侧在飞书还没完全配好之前先确认 OpenClaw 能通过 TaoToken 调到模型。用 curl 直接打 API排除 Key 或网络问题curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: ping}] }返回里有choices字段和内容说明 Key 和网络都正常。如果返回 401检查 Key 是否复制完整返回 404检查base_url有没有多写或少写/v1以文档为准。4.2 飞书侧事件订阅回到飞书开放平台应用详情页左侧「机器人」→「事件订阅」选择「使用长连接接收事件」。这一步很关键只有选了长连接「添加事件」按钮才会变成可点击。然后添加「消息接收」和「消息发送」事件保存。权限管理里确认已开通「获取通讯录基本信息」否则机器人拿不到用户信息回消息可能失败。改完权限和事件后进「版本管理与发布」重新发布版本并等审批状态变「已上线」才生效。4.3 消息回环验证在飞书客户端搜索你创建的机器人加为好友或拉进群发一句测试指令比如「列出当前目录文件」。同时在本机终端看 Gateway 日志openclaw logs --follow正常的话日志里会先出现收到飞书事件的记录然后是模型调用最后是发送回复。飞书那边几秒内收到机器人回复就说明整条链路通了。如果日志有收到事件但没有回复多半是模型侧 Key 或base_url的问题回到 4.1 用 curl 再确认一次。5. 本篇常见错排查插件装了但 status 里不显示 Active先openclaw gateway restart再openclaw status。如果还是灰的检查config.toml里[plugins.feishu]段有没有拼写错误enabled是否为 true。可以用openclaw doctor做一次诊断它会指出配置项缺失。飞书发消息机器人没反应按顺序查三处。一是事件订阅是否选了长连接、是否添加了消息事件二是权限是否开通并重新发布版本三是本机 Gateway 是否在跑。三者缺一不可。日志里如果完全没有收到事件的记录问题在飞书侧有事件但无回复问题在模型侧。curl 返回 401 或 403Key 无效或没权限。去https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite重新确认 Key 状态必要时新建一个。注意 Key 前后不要有空格复制时容易带上换行。长连接频繁断开检查本机网络是否稳定以及是否有其他进程占用同一端口。openclaw health会给出连接状态。如果公司网络有出站限制确认能访问飞书开放平台和 TaoToken 的 API 地址。群组里 机器人没反应确认group_policy设为accept并且机器人已被拉进群。有些群默认不允许机器人发言需要在群设置里放开。6. 接下来怎么用统一 Key 与长期编码插件通了之后日常就是两件事一是把模型调用统一走 TaoToken省得每个渠道单独配 Key二是如果你要长期跑编码类任务或 Agent 工作流可以看下 Coding Plan把常用模型和额度规划好避免临时 Key 不够用。想直接体验模型对话效果可以打开https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite试几句确认返回风格符合预期再接到 OpenClaw 里。接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite参数有变动以文档为准。Key 管理入口还是控制台那个 API Keys 页面建议给 OpenClaw 单独建一个 Key方便后续轮换和排查。最后留一个实操习惯每次改完config.toml先openclaw doctor再openclaw gateway restart最后openclaw status确认三连。这套动作能挡掉大部分“改了没生效”的问题。