1. 飞书群里接一个 AI 助手到底卡在哪飞书群机器人这件事很多人第一次做都会卡在三个地方应用权限没配对、Webhook 回调地址填错、以及模型调用通道各写各的 Key 导致后面维护爆炸。OpenClaw 本身是个挺好用的 AI 助手框架飞书又是国内团队协作里覆盖率很高的工具把两者接起来你就能在群里 一下机器人让它回答问题、整理文档、做会议提醒。适合谁适合已经部署了 OpenClaw、手里有飞书企业管理员权限、想让 AI 能力落到具体群聊场景里的开发和运维同学。我这次要解决的核心问题是用 OpenClaw 通过 Webhook 接入飞书群机器人并且所有模型调用统一走 TaoToken 的 Key/API 通道而不是每个插件、每个模型单独配一套密钥。这样做的直接好处是后面换模型、加额度、查用量都只在一个地方操作飞书侧只负责消息进出职责清晰。整篇会给你可复制的config.toml和settings.json骨架、飞书后台 Webhook 回调地址该填哪一项、以及一条消息回环验证动作从配置到联调走完闭环。你照着改参数就能跑。2. 前置准备TaoToken 统一 Key 与飞书应用凭证在动 OpenClaw 配置之前先把两边的身份证准备好。飞书这边需要 App ID、App Secret以及一个机器人能接收事件的通道TaoToken 这边需要一个统一 Key让 OpenClaw 的所有模型请求都从这里出去。2.1 拿到 TaoToken 的 API KeyTaoToken 的定位是统一的大模型 API 通道你注册后在控制台创建 Key 即可。地址走这里官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台创建 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Key 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建完 Key 之后API 的基础地址是https://taotoken.net/api这个地址不加 UTM 参数直接用于程序请求。把 Key 复制出来形如sk-xxxx后面写进config.toml的api_key字段。注意Key 只显示一次建议创建后立刻存到你的密钥管理里别直接提交到 Git 仓库。2.2 飞书侧创建应用并开权限打开飞书开放平台用企业管理员账号登录创建自建应用。创建完成后在应用详情页记下 App ID 和 App Secret。接着进权限管理至少开这几个权限标识用途im:message:send_as_bot机器人发消息im:message:receive接收群消息事件im:chat:member读取群成员im:chat:create创建群聊可选权限开完要去版本管理与发布创建版本并提交发布等管理员审批通过权限才真正生效。这一步很多人漏掉导致后面机器人收不到消息其实是应用没发布。2.3 配置事件订阅与 Webhook 回调地址飞书机器人接收消息靠的是事件订阅。在应用后台找到事件与回调选择将事件发送至开发者服务器这里要填一个请求地址回调地址格式是https://你的域名/feishu/webhook这个地址必须满足两个条件公网可访问、HTTPS。飞书会先发一个challenge校验请求过来你的服务要原样返回challenge值才算验证通过。OpenClaw 的飞书插件已经内置了这个校验逻辑你只要保证地址填对、服务在跑就行。同时把要订阅的事件勾上核心是im.message.receive_v1接收消息。如果你还想让机器人被拉进群、被 时响应这个事件是必须的。3. 可复制配置config.toml 与 settings.json 骨架OpenClaw 的配置分两层config.toml管服务级参数端口、模型通道、飞书凭证settings.json管行为级参数回复规则、关键词触发。下面给的是能直接改参数用的骨架。3.1 config.toml统一走 TaoToken 通道# OpenClaw 主配置 [server] host 0.0.0.0 port 8080 # 飞书回调地址对应的路径 webhook_path /feishu/webhook [model] # 统一走 TaoToken 通道所有插件共用这一个 Key provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 default_model gpt-4o-mini timeout 60 [feishu] enabled true app_id cli_你的AppID app_secret 你的AppSecret # 机器人被 时是否响应 respond_to_mention true # 事件校验 token飞书后台可查 verification_token 你的VerificationToken # 消息加密密钥若开启了加密则填 encrypt_key 你的EncryptKey这里的关键点是[model]段base_url指向https://taotoken.net/apiapi_key填 TaoToken 的 Key。OpenClaw 内部所有需要调模型的地方——不管是群消息回复、文档总结还是关键词触发——都复用这一段配置不用每个功能单独填 Key。3.2 settings.json回复规则与关键词{ autoreply: { enabled: true, rules: [ { keyword: 帮助, response: 我可以帮你查资料、写文档、设提醒直接 我 说需求就行。 }, { keyword: 天气, response: 请告诉我城市名称我来查。 } ] }, keywords: [ { word: /文档, action: create_document }, { word: /提醒, action: set_reminder } ], group: { welcome_new_member: true, welcome_text: 欢迎加入有问题可以 我。 } }autoreply是命中关键词直接回固定话术适合 FAQkeywords是命中后触发具体动作比如建文档、设提醒这些动作背后调模型时同样走config.toml里的 TaoToken 通道。3.3 飞书后台要填的项对照飞书后台位置填写内容事件订阅-请求地址https://你的域名/feishu/webhook事件订阅-Verification Token与 config.toml 的verification_token一致事件订阅-Encrypt Key与 config.toml 的encrypt_key一致如开启加密权限管理勾选 2.2 表格里的权限版本管理与发布创建版本并发布等审批4. 启动服务与消息回环验证配置写完先启动 OpenClaw确认端口和回调路径能通再去飞书里发一条消息验证闭环。4.1 启动与本地自检# 启动 OpenClaw 服务 openclaw serve --config ./config.toml # 另开一个终端本地测回调路径是否可达 curl -X POST http://127.0.0.1:8080/feishu/webhook \ -H Content-Type: application/json \ -d {challenge:test_challenge,type:url_verification}如果返回体里包含challenge:test_challenge说明校验逻辑正常。这一步过了再去飞书后台点验证通常就能通过。4.2 飞书后台验证回调回到飞书应用后台的事件订阅页填好请求地址后点保存飞书会自动发一次challenge请求。如果 OpenClaw 服务在跑且路径对页面会提示验证成功。失败的话看服务日志里有没有收到请求没收到就是网络或地址问题收到了但报错就是校验字段没对上。4.3 一条消息回环验证把机器人拉进一个测试群然后在群里 它发一句话AI助手 你好预期结果是机器人回复一条消息。这条消息的完整链路是飞书把im.message.receive_v1事件推到你的 Webhook 地址 → OpenClaw 解析事件、取出文本 → 调用https://taotoken.net/api上的模型 → 拿到回复 → 调飞书发消息接口发回群里。如果你想确认模型调用确实走了 TaoToken可以在 OpenClaw 日志里看请求的base_url或者去 TaoToken 控制台的用量页看有没有新增调用记录。这一步能对上说明统一 Key 通道生效了。5. 本篇常见错排查接入过程里报错基本集中在下面几类按顺序排查效率最高。机器人收不到消息。先看飞书应用有没有发布并通过审批没发布权限不生效再看事件订阅里im.message.receive_v1有没有勾最后确认 Webhook 地址是 HTTPS 且公网可达本地127.0.0.1飞书是访问不到的。回调验证失败。多半是verification_token或encrypt_key和后台不一致。如果开了加密OpenClaw 侧必须填encrypt_key否则解不开事件体。校验请求返回的不是原始challenge也会失败。消息发送失败。检查im:message:send_as_bot权限是否开、机器人是否在目标群里。App Secret 填错会直接导致拿不到 tenant_access_token日志里会有鉴权错误。模型调用报 401 或 404。401 一般是 TaoToken 的 Key 填错或过期去控制台重新生成404 检查base_url是不是写成了https://taotoken.net/api别多加路径后缀。模型名写错也会报错default_model要和通道支持的模型对得上。响应特别慢。先看是不是timeout设太短导致重试再看模型本身的首 token 延迟。群消息场景建议用轻量模型做默认重任务再走关键词触发切模型。提示排障时把 OpenClaw 日志级别调到 debug能看到每个请求的入参和出参比猜快得多。6. 后续怎么走按场景选通道配置跑通之后接下来看你主要拿它干什么。如果只是偶尔在群里问问题、验证模型效果直接用模型对话页试就行https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite如果你要把 OpenClaw 当成长期在线的编码或 Agent 助手频繁调用、需要稳定额度那更适合走 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入过程中遇到鉴权、回调、Key 配置这类问题直接翻接入文档最省事https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite要是你用的是 Claude Code 那套 Anthropic 风格的调用也有对应入口https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite我自己的习惯是飞书群机器人只做入口和展示所有模型能力都收敛到 TaoToken 一个通道上这样换模型、控成本、查用量都不用碰飞书那边的配置。你先把第 4 节那条回环消息跑通剩下的规则和关键词慢慢加就行。
