1. 为什么要在飞书里跑 OpenClawOpenClaw 是一个可以本地部署、自己掌控模型凭证的 AI 助手框架它能通过「渠道channel」把对话能力接到不同的聊天工具里。飞书作为团队协作入口天然适合承载这类助手群里 一下机器人就能触发代码生成、文档摘要、答疑等任务不用来回切换窗口。把 OpenClaw 接入飞书群聊本质上是让 AI 助手成为团队里的一个「同事」消息即指令回复即结果。但真正动手时很多人会卡在三个地方飞书开放平台的应用权限和事件订阅配置繁琐OpenClaw 的渠道配置项散落在 config.toml 和命令行里最头疼的是多模型凭证管理——今天用这个模型的 Key明天换那个每个渠道都要单独配一遍改起来容易漏。这篇教程就围绕「OpenClaw 接入飞书」这条主线给出 config.toml 与飞书事件订阅的完整骨架并演示用 TaoToken 统一 Key 替换多模型凭证的验证步骤最终实现飞书消息触发 OpenClaw 并回传结果。适合谁看已经装好 OpenClaw、想让机器人在飞书群里响应消息的开发者手里有多个模型 Key、想收敛成一套凭证的团队以及第一次配飞书事件订阅、被权限 JSON 劝退的新手。下面从飞书应用创建讲到配对成功每一步都给可复制的命令和配置。2. TaoToken 前置把多模型 Key 收敛成一套在讲飞书配置之前先把凭证这件事理顺否则后面每接一个模型都要改一次 config.toml。TaoToken 的作用是提供一个统一的 API 入口你只需要在它那里生成一个 Key就能在 OpenClaw 里调用多个模型不用为每个模型单独维护凭证。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 这个地址不加 UTM 参数。操作路径很直接登录后进入控制台在 API Keys 页面创建一个新 Key复制保存。这个 Key 就是后面 config.toml 里要填的凭证。如果你还没决定用哪个模型可以先去模型对话页面试一下效果确认响应质量再落到配置里。对于长期跑编码任务或 Agent 的场景Coding Plan 会更划算适合把 OpenClaw 当日常工具用的团队。这里要强调一点TaoToken 是统一的 API 接入层不是让你绕过什么而是把分散的模型凭证管理集中到一处。你原来的模型服务该怎么用还怎么用只是 OpenClaw 这边不再需要为每个模型存一份 Key。配置文档在 https://taotoken.net/doc 接入细节可以对照着看。3. 飞书应用创建与权限配置3.1 创建企业自建应用登录飞书开放平台用飞书账号进入后点击「创建企业自建应用」填写名称比如「OpenClaw助手」和描述创建完成。进入「凭证与基础信息」页面复制 App ID格式 cli_xxx和 App Secret这两个值后面要填进 OpenClaw。接着在「添加应用能力」里找到「机器人」点击添加这样应用才具备收发消息的能力。3.2 批量导入权限进入「权限管理」点击「批量导入」把下面这段 JSON 粘进去。这段权限覆盖了消息收发、群聊读取、文档读取等 OpenClaw 常用能力按需保留即可{ scopes: { tenant: [ 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:chat, im:chat:read, im:chat:update, im:resource, contact:contact.base:readonly, docx:document:readonly, docs:document.content:read, event:ip_list ], user: [ im:message, im:message:readonly, im:chat:read, contact:user.base:readonly, offline_access ] } }导入后确认权限列表里出现了这些 scope。权限给多了会增加审批复杂度给少了机器人收不到群消息上面这份是经过验证的最小可用集。3.3 发布应用进入「版本管理与发布」点击「创建版本」填版本号后提交发布申请。如果你本人是管理员可以直接审批通过否则需要等管理员处理。发布生效后机器人才能正式在群里工作。4. OpenClaw 侧 config.toml 与渠道配置4.1 添加飞书渠道回到终端运行渠道添加命令openclaw channels add在交互提示里选择「Feishu」然后依次输入刚才保存的 App ID 和 App Secret其余选项保持默认。添加完成后重启网关让配置生效openclaw gateway restart openclaw gateway status确认输出里 feishu 渠道状态为 connected。如果显示 disconnected先检查 App ID 和 App Secret 是否复制完整再确认应用是否已发布。4.2 config.toml 完整骨架OpenClaw 的配置文件通常在~/.openclaw/config.toml下面是一份接入飞书并用 TaoToken 统一 Key 的骨架[gateway] host 127.0.0.1 port 18789 [channels.feishu] enabled true app_id cli_xxxxxxxxxxxx app_secret your_app_secret event_mode websocket encrypt_key verification_token [providers.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 default_model gpt-4o-mini [agent] provider taotoken system_prompt 你是团队助手回答简洁代码用代码块输出。关键点event_mode设为websocket对应飞书的长连接接收事件模式不需要公网回调地址base_url填 TaoToken 的 API 入口api_key填你在控制台创建的 Key。这样 OpenClaw 只认这一套凭证换模型时改default_model即可不用动飞书渠道配置。4.3 配置飞书事件订阅回到飞书开放平台进入「事件与回调」→「事件配置」选择「使用长连接接收事件」然后添加事件im.message.receive_v1。这个事件是机器人接收消息的入口没有它机器人收不到任何消息。添加后保存飞书会自动与 OpenClaw 建立长连接。5. 验证请求与成功结果5.1 配对与首次对话配对机制是为了防止陌生人滥用机器人消耗你的 API 额度。新用户第一次发消息时会收到一个 8 位配对码只有批准后才能正常对话配对码 1 小时过期。在飞书里找到你的机器人发送「你好」。机器人会回复一个 8 位配对码然后在终端批准openclaw pairing approve feishu 配对码批准后再次发送消息机器人就会正常回复。如果没收到配对码检查事件订阅是否添加了im.message.receive_v1以及网关状态是否为 connected。5.2 用 curl 验证 TaoToken 凭证在配置 OpenClaw 之前建议先用 curl 确认 TaoToken 的 Key 可用curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: 回复ok}] }返回里出现choices字段和正常内容说明凭证有效。这一步能提前排除 Key 错误、额度不足等问题避免在飞书里排查半天发现是凭证问题。5.3 端到端验证在飞书群里 机器人发一句「用 Python 写一个快速排序」。如果配置正确机器人会返回代码块。实测下来从消息发出到收到回复通常在几秒内。如果回复为空或报错看 OpenClaw 网关日志openclaw gateway logs --follow日志里会显示请求是否到达、模型是否返回、飞书是否发送成功按这三段定位问题。6. 本篇常见错排查机器人收不到消息最常见的原因是事件订阅没加im.message.receive_v1或者应用没发布。检查「事件与回调」里事件是否添加、版本是否审批通过。另一个原因是权限里缺im:message.group_at_msg:readonly群聊 消息需要这个 scope。配对码一直不出现确认网关状态是 connected且event_mode是websocket。如果用了 webhook 模式但没配公网地址消息不会到达。配对码过期后重新发消息会生成新的。TaoToken 返回 401Key 复制时带了空格或者用了已删除的 Key。重新在控制台创建一个注意Bearer后面有一个空格。如果返回 404检查base_url是否写成了https://taotoken.net/api不要多加/v1之外的路径。模型回复乱码或截断检查default_model是否是 TaoToken 支持的模型名。不同模型的上下文长度不同长消息可能被截断可以在[agent]里加max_tokens限制。群聊里 了没反应私聊正常群聊需要额外权限im:message.group_at_msg:readonly和im:chat:read补上后重新发布应用版本。7. 下一步把凭证和渠道都收拢到这里飞书消息已经能触发 OpenClaw 并回传结果。如果你还想接其他渠道比如 Slack 或 Discord思路是一样的渠道配置里只填渠道自己的凭证模型凭证统一走 TaoToken。这样每加一个渠道不用再复制一遍模型 Key。需要管理 Key 或查看用量去控制台 https://taotoken.net/console 要新建或轮换 Key在 API Keys 页面 https://taotoken.net/api-keys 操作。接入过程中遇到报错先对照接入文档 https://taotoken.net/doc 检查参数格式。如果想让 OpenClaw 长期跑编码和 Agent 任务Coding Plan https://taotoken.net/coding-plan 会比按量计费更省心。飞书这边配好后建议把config.toml里的system_prompt按团队场景调一下比如加上「回答用中文代码标注语言」机器人回复会更贴合日常使用。