OpenClaw 飞书机器人集成完全指南

基于阿里云官方文档 feishu-bot-config 技能优化 多 Agent 管理最佳实践 目录方案概述环境准备安装 feishu-bot-config 技能推荐创建飞书应用配置 OpenClaw三种方式配对与验证多 Agent 管理定时任务与高级功能常见问题排查命令速查表方案概述什么是 OpenClaw 飞书集成OpenClaw原 Moltbot、Clawdbot集成飞书后你可以在飞书群聊或单聊中通过自然语言直接与 AI Agent 交互。两种配置方案对比特性阿里云标准方案feishu-bot-config 技能方案配置方式手动执行多条命令对话中自动完成配对方式手动执行openclaw pairing approve将配对码发给 Agent 自动配对多 Agent 管理需手动切换配置自然语言指定 Agent错误排查自行检查日志技能自动诊断适用版本OpenClaw 2026.2.9所有版本推荐度⭐⭐⭐⭐⭐⭐⭐⭐环境准备硬件要求轻量应用服务器阿里云或任意 Linux/Mac 服务器内存≥2 GiBOpenClaw 版本建议 2026.2.9 及以上购买与部署阿里云轻量应用服务器登录阿里云轻量应用服务器控制台选择应用镜像→OpenClaw 镜像实例规格内存 2GiB 以上完成购买后在应用详情页获取OpenClaw WebUI 访问地址随机生成的端口号管理员 Token端口放通重要# 在阿里云控制台执行端口放通命令# 或手动开放 OpenClaw 的随机端口⚠️ 端口放通会使服务暴露于公网使用后建议一键关闭 WebUI 公网访问。安装 feishu-bot-config 技能推荐 安装 feishu-bot-config 技能你可以通过以下两种方式之一将飞书自动化配置技能添加到 OpenClaw 中。方式一自动安装最推荐对话即完成这是最简单的方法。你只需要直接在 OpenClaw 的对话界面中向 Agent 发送以下指令“请帮我从这个地址https://github.com/70asunflower/my-skills/tree/main/feishu-bot-config克隆并安装飞书配置技能到 skills 文件夹。”Agent 会自动完成以下操作解析指令识别下载地址和目标文件夹。执行克隆使用git clone命令将技能仓库下载到 OpenClaw 的skills目录。确认安装安装完成后Agent 会回复安装结果。✅优势无需手动操作命令无需担心路径错误全程由 Agent 自动完成。方式二手动安装适用于自动方式失败或无网络环境如果自动安装方式不可用可以按照以下步骤手动操作进入技能目录打开终端进入 OpenClaw 的skills文件夹。cd~/openclaw/skills# 如果你的安装路径不同请替换为实际路径克隆技能仓库执行以下命令将技能下载到feishu-bot-config文件夹中。gitclone https://github.com/70asunflower/my-skills/tree/main/feishu-bot-config ./feishu-bot-config注意如果提示git命令未找到请先安装 Git。如果上述命令报错可以尝试仅克隆整个仓库再复制所需文件夹gitclone https://github.com/70asunflower/my-skills.gitcp-rmy-skills/feishu-bot-config.rm-rfmy-skills验证安装确保~/openclaw/skills/feishu-bot-config文件夹存在并且其中包含skill.json等文件。安装完成后即可按照文档后续步骤使用该技能来自动化配置飞书机器人。验证安装在 OpenClaw 对话中发送列出已安装的技能应能看到feishu-bot-config在列表中。技能功能功能说明自动配置根据 App ID/Secret 自动生成配置自动配对解析配对码并执行 approve 命令多 Agent 管理支持为不同 Agent 配置独立机器人状态诊断检查配置、连接、权限问题配置迁移导出/导入飞书配置创建飞书应用步骤 1创建应用访问 飞书开放平台点击创建企业自建应用填写应用名称、描述上传图标点击创建步骤 2获取凭证进入凭证与基础信息页面复制App ID格式cli_xxxApp Secret步骤 3配置权限进入权限管理→批量导入/导出权限粘贴以下 JSON 完整权限配置点击展开{scopes:{tenant:[aily:file:read,aily:file:write,application:application.app_message_stats.overview:readonly,application:application:self_manage,application:bot.menu:write,cardkit:card:write,contact:user.employee_id:readonly,corehr:file:download,docs:document.content:read,event:ip_list,im:chat,im:chat.access_event.bot_p2p_chat:read,im:chat.members:bot_access,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:resource,sheets:spreadsheet,wiki:wiki:readonly],user:[aily:file:read,aily:file:write,im:chat.access_event.bot_p2p_chat:read]}}点击下一步→确认新增权限→申请开通。步骤 4添加机器人能力左侧导航栏 →添加应用能力→机器人→配置步骤 5配置事件订阅长连接左侧导航栏 →事件与回调订阅方式→ 选择使用长连接接收事件→ 保存添加事件→ 搜索im.message.receive_v1→ 确认添加步骤 6发布应用左侧导航栏 →版本管理与发布点击创建版本填写版本号如1.0.0和更新说明保存并提交审核审核通过后发布配置 OpenClaw三种方式方式一自动配置推荐需 feishu-bot-config 技能在 OpenClaw 对话中发送请帮我配置飞书机器人App ID 是 cli_a945xxxxxxxxxxxxxxxApp Secret 是 1WovbkJPRxxxxxxxxxxxxxxxAgent 会自动生成配置文件设置必要的参数返回配置结果方式二半自动配置手动 技能辅助手动创建配置文件~/.openclaw/channels/feishu.json{enabled:true,appId:cli_xxx,appSecret:xxx,connectionMode:websocket,dmPolicy:pairing,groupPolicy:allowlist,requireMention:true}在对话中发送请帮我验证飞书配置是否正确方式三纯手动配置阿里云标准方式openclaw configsetchannels.feishu.appId你的_app_idopenclaw configsetchannels.feishu.appSecret你的_app_secretopenclaw configsetchannels.feishu.enabledtrueopenclaw configsetchannels.feishu.connectionMode websocket openclaw configsetchannels.feishu.dmPolicy pairing openclaw configsetchannels.feishu.groupPolicy allowlist openclaw configsetchannels.feishu.requireMentiontrueopenclaw gateway restart配置参数说明参数说明推荐值enabled是否启用飞书通道trueappId飞书应用 App ID从飞书开放平台获取appSecret飞书应用 Secret从飞书开放平台获取connectionMode连接模式websocket长连接dmPolicy私聊策略pairing需配对groupPolicy群聊策略allowlist白名单requireMention是否需要 true配对与验证标准配对流程步骤 1发起对话在飞书中搜索你的机器人发送任意消息如“你好”。步骤 2获取配对码机器人回复类似OpenClaw: access not configured. Your Feishu user id: ou_5969847348fxxxxxxxxxxxxxxxxx Pairing code: GFxxxxxx Ask the bot owner to approve with: openclaw pairing approve feishu GFxxxxxx步骤 3完成配对自动方式推荐将上述回复内容发送给 OpenClaw Agent机器人回复了以下内容请帮我完成配对 [粘贴机器人回复的完整内容]手动方式openclaw pairing approve feishu GFxxxxxx步骤 4验证再次向飞书机器人发送消息应能得到正常回复。通过终端命令配对备用方案# 登录服务器后# 查看待配对列表openclaw pairing list feishu# 批准配对openclaw pairing approve feishu YXXX群聊中使用在群聊中需机器人才能触发响应首次在群聊中使用可能也需要配对取决于groupPolicy设置多 Agent 管理场景说明当你配置了多个 Agent如work-agent、personal-agent、test-agent每个 Agent 可以拥有独立的飞书机器人。核心操作1. 为新 Agent 配置飞书机器人向已可用的 Agent发送请帮我为 work-agent 配置飞书机器人App ID 是 cli_work_xxxxxApp Secret 是 work_secret_xxxxx2. 完成新 Agent 的配对在飞书中向work-agent对应的机器人发送消息获取配对码然后这是 work-agent 的配对码 GF12345你帮我给 work-agent 配置一下3. 查看所有 Agent 状态列出所有 Agent 的飞书配置状态4. 为特定 Agent 重新配对请为 work-agent 重新配对配对码是 GFnew123455. 删除某个 Agent 的配置帮我移除 test-agent 的飞书机器人配置6. 排查特定 Agent 的问题请帮我排查 work-agent 的飞书机器人连接问题管理技巧技巧说明保留管理 Agent建议保留一个admin-agent专门用于管理其他 Agent命名规范使用有意义的 Agent 名称如customer-service、data-analysis权限隔离每个 Agent 使用独立的飞书应用互不干扰批量配置可一次性发送多个 Agent 的配置请求批量配置示例请帮我依次为以下 Agent 配置飞书机器人 - agent_a: App ID cli_a_xxx, Secret a_xxx - agent_b: App ID cli_b_xxx, Secret b_xxx - agent_c: App ID cli_c_xxx, Secret c_xxx定时任务与高级功能创建定时任务通过对话创建定时任务并将结果发送到飞书群。步骤 1获取群机器人 Webhook在飞书群聊中点击设置→群机器人点击添加机器人→ 选择自定义机器人填写名称和描述 → 添加复制Webhook 地址步骤 2创建定时任务在 OpenClaw 对话中每天早上8点查询北京天气发送到 [Webhook地址]步骤 3测试任务立即发送一条测试消息到 [Webhook地址]步骤 4修改或取消任务把天气查询任务改成每天早上9点执行 取消天气查询任务其他高级功能功能示例指令定时提醒每周五下午3点提醒我周报发送到飞书数据报表每天早上10点发送昨日销售数据到飞书群监控告警当服务器CPU超过80%时发送告警到飞书内容推送每天推送一条AI新闻到我的飞书私聊常见问题排查Q1: 机器人无响应可能原因OpenClaw 服务未运行飞书配置未生效长连接断开排查方法请帮我检查飞书机器人连接状态或手动检查openclaw status--deepopenclaw gateway restartQ2: 配对失败提示“没有待处理的配对请求”解决方法# 查看当前配对请求openclaw pairing list feishu# 如果没有记录重新向机器人发消息获取新配对码Q3: 群聊中 机器人 无响应检查项requireMention是否为true群聊是否在白名单中groupPolicy设置机器人是否已被添加到群聊Q4: 权限不足错误解决方法检查飞书应用是否已申请所有必要权限确认权限已生效可能需要重新发布应用在飞书开放平台重新授权Q5: 多 Agent 配置混乱排查方法请列出所有 Agent 的飞书配置详情技能会返回每个 Agent 的配置文件路径App ID脱敏配对状态最后活跃时间Q6: WebUI 无法访问解决方法检查防火墙是否放通 OpenClaw 端口确认 Token 是否正确尝试重启 OpenClaw 网关命令速查表配置管理操作命令/对话指令自动配置请帮我配置飞书机器人App ID: xxx, Secret: xxx查看状态检查飞书机器人状态重启网关openclaw gateway restart查看配置openclaw config get channels.feishu配对管理操作命令/对话指令自动配对这是配对码 GFxxx帮我完成配对查看配对列表openclaw pairing list feishu手动批准openclaw pairing approve feishu GFxxx取消配对openclaw pairing revoke feishu多 Agent 管理操作对话指令为指定 Agent 配置为 work-agent 配置飞书App ID: xxx, Secret: xxx查看所有 Agent列出所有 Agent 的飞书配置状态为指定 Agent 配对这是 work-agent 的配对码 GFxxx帮我配置排查指定 Agent检查 work-agent 的飞书连接删除指定 Agent 配置移除 test-agent 的飞书配置定时任务操作对话指令创建定时任务每天早上8点[任务内容]发送到 [Webhook]测试任务立即发送测试消息到 [Webhook]修改任务把[任务名]改成[新内容]取消任务取消[任务名]故障排查操作命令/对话指令深度状态检查openclaw status --deep查看日志openclaw logs --tail 50技能诊断请诊断飞书机器人配置问题重新加载配置openclaw config reload附录文件结构~/.openclaw/ ├── channels/ │ └── feishu.json # 飞书通道配置 ├── skills/ │ └── feishu-bot-config/ # 飞书配置技能 │ ├── skill.json │ ├── main.py │ └── README.md ├── agents/ │ ├── default/ # 默认 Agent │ └── work-agent/ # 其他 Agent │ └── config.json └── logs/ └── openclaw.log相关链接阿里云官方文档feishu-bot-config 技能飞书开放平台OpenClaw GitHub安全建议保护 App Secret不要提交到公开仓库保护配对码配对码有效期有限及时处理限制群聊权限使用groupPolicy: allowlist限制可用的群聊定期轮换凭证定期更换 App Secret关闭不必要的公网访问使用后关闭 WebUI 公网访问更新日志日期版本更新内容2026-04-032.0整合 feishu-bot-config 技能增加多 Agent 管理2026-01-291.0初始版本阿里云官方文档