跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI

Openclaw 与飞书多机器人配置指南

介绍如何在云端部署 Openclaw 并结合飞书实现多机器人配置。主要步骤包括准备基础环境、创建多个飞书企业自建应用以获取凭证、启动 Openclaw 服务并创建对应 Agent、通过配置菜单绑定飞书渠道与 Agent、设置事件订阅及测试验证。最终实现不同机器人分工协作,如办公助手、资讯推送等场景,提升自动化效率。

静心发布于 2026/4/6更新于 2026/10/25117 浏览

一、配置前必看:核心说明与前置准备

1.1 核心价值

Openclaw+ 飞书多机器人配置,核心是让多个飞书机器人分别绑定 Openclaw 的不同 Agent,实现「分工协作、各司其职」——无需切换工具,在飞书内即可完成所有操作,大幅提升工作效率。

典型分工场景:

  • 1 个机器人负责日常指令响应
  • 1 个机器人负责定时推送资讯
  • 1 个机器人负责办公流程自动化(会议整理、报表生成等)

1.2 前置环境准备(必做)

提前准备好以下环境和工具,避免配置过程中卡顿,所有工具均为免费可用:

  • 基础环境:云端安装 Openclaw;
  • 账号权限:飞书个人账号(无需企业认证,个人账号即可创建企业自建应用),拥有飞书开放平台访问权限;
  • 辅助工具:终端(用于执行 Openclaw 命令)、文本编辑器(用于修改配置文件)、飞书客户端(用于测试机器人功能)。

1.3 核心概念科普(新手必看)

避免配置过程中混淆关键概念,提前梳理 2 个核心名词:

  • Openclaw Agent:可理解为「机器人的大脑」,每个 Agent 有独立的工作空间和配置,负责执行特定任务,多机器人配置本质就是为不同 Agent 绑定不同的飞书机器人;
  • 飞书企业自建应用:飞书机器人的载体,每个飞书机器人对应一个企业自建应用,需在飞书开放平台创建,获取 App ID 和 App Secret 用于与 Openclaw 对接。

二、分步实操:Openclaw+ 飞书多机器人配置

📌 核心流程:创建飞书应用 → 配置 Openclaw Agent → 绑定机器人与 Agent → 测试验证

每一步均附关键提示和命令示例,可直接复制执行,降低操作难度。

2.1 第一步:创建多个飞书企业自建应用(对应多机器人)

每个飞书机器人对应一个企业自建应用,需逐个创建,步骤完全一致,此处以创建 1 个为例,其余机器人可重复操作:

  1. 访问飞书开放平台(https://open.feishu.cn/),登录飞书账号后,点击右上角「创建应用」,选择「企业自建应用」(个人账号可直接创建,无需企业认证);
  2. 填写应用信息:应用名称(如「Openclaw-办公助手」「Openclaw-资讯推送」,区分不同机器人用途)、应用描述,上传可选图标,点击「创建」;
  3. 添加机器人能力:进入应用详情页,左侧菜单点击「添加应用能力」,找到「机器人」能力并点击添加,确保「机器人」开关已开启;
  4. 配置权限(必加,否则无法正常收发消息):
    • 左侧菜单点击「权限管理」,搜索并添加 3 个核心权限;
    • im:message(获取与发送单聊、群组消息,必须);
    • im:message:send_as_bot(以应用的身份发消息,必须);
    • im:chat:readonly(读取群信息,推荐,可选)。
  5. 获取应用凭证:在应用详情页的「凭证与基础信息」中,复制 App ID 和 App Secret(点击「显示」后复制),妥善保管,后续配置需用到,切勿泄露;
  6. 发布应用:左侧菜单点击「版本管理与发布」,点击「创建版本」,填写版本号和更新说明,设置可用范围(选择自己或需要使用机器人的人/部门),点击「保存」后「申请发布」,内部应用通常自动审核通过,无需等待;
  • 重复步骤 1-6,创建多个飞书企业自建应用,每个应用对应一个机器人,分别记录每个应用的 App ID 和 App Secret,做好区分(建议按机器人用途命名,如「办公助手-AppID」)。
  • 💡 提示:创建多个应用时,应用名称建议差异化,方便后续绑定和管理,避免混淆。

    2.2 第二步:配置 Openclaw 多 Agent(对应多机器人分工)

    Openclaw 的每个 Agent 对应一个飞书机器人,需先创建多个 Agent,再配置其工作属性,步骤如下:

    1. 启动 Openclaw 服务(后续配置长连接需用到):
    # 启动 Openclaw 网关
    openclaw gateway start
    # 查看服务状态,确认启动成功
    openclaw gateway status
    
    1. 创建多个 Agent(每个 Agent 对应一个飞书机器人):
    # 创建第一个 Agent(办公助手,对应第一个飞书机器人)
    openclaw agents add office-assistant
    # 创建第二个 Agent(资讯推送,对应第二个飞书机器人)
    openclaw agents add news-push
    # 创建第三个 Agent(开发助手,对应第三个飞书机器人)
    openclaw agents add dev-assistant
    
    1. 查看 Agent 列表,确认创建成功:
    openclaw agents list
    

    ✅ 输出示例:Agents: - main (default)、- office-assistant、- news-push、- dev-assistant,即为创建成功。 4. 配置 Agent 属性(可选):每个 Agent 可设置独立的身份、行为准则等,进入对应 Agent 的工作空间(路径:~/.openclaw/workspace-xxx,xxx 为 Agent 名称),修改 IDENTITY.md、SOUL.md 等文件,定义 Agent 的性格、功能,让不同机器人有差异化的响应逻辑。

    2.3 第三步:配置飞书渠道,绑定 Agent 与飞书机器人(核心步骤)

    核心目标:将每个 Openclaw Agent 与对应的飞书应用(机器人)绑定,实现「指令分流」,步骤如下:

    1. 进入 Openclaw 消息渠道配置界面:
    bash ~/.openclaw/config-menu.sh
    
    1. 依次选择「(3) 消息渠道配置」→「(7) 飞书 (feishu)」,按提示输入第一个飞书应用的 App ID 和 App Secret,配置完成后选择「是」重启 gateway;
    2. 重复步骤 1-2,为每个飞书应用(机器人)配置飞书渠道,确保每个渠道对应不同的 App ID 和 App Secret;
    3. 绑定 Agent 与飞书渠道(示例如下):
    # 绑定 office-assistant Agent 到第一个飞书账号(main 对应第一个渠道)
    openclaw agents bind --agent office-assistant --bind feishu:main
    # 绑定 news-push Agent 到第二个飞书账号(自定义账号名,如 news)
    openclaw agents bind --agent news-push --bind feishu:news
    # 绑定 dev-assistant Agent 到第三个飞书账号(自定义账号名,如 dev)
    openclaw agents bind --agent dev-assistant --bind feishu:dev
    
    1. 查看绑定结果,确认绑定成功:
    openclaw agents bindings
    

    ✅ 输出示例:Routing bindings: - office-assistant <- feishu accountId=main、- news-push <- feishu accountId=news,即为绑定成功。 6. 配置飞书事件订阅(长连接,必做):

    • 回到飞书开放平台,进入每个飞书应用的详情页,左侧菜单点击「事件与回调」;
    • 选择「使用长连接接收事件」(无需填写 webhook 地址,无需公网服务器);
    • 点击「添加事件」,添加 im.message.receive_v1(接收消息,必须),可选添加 im.message.message_read_v1(消息已读)、im.chat.member.bot.added_v1(机器人进群),添加完成后点击「保存」。
    1. 添加机器人到飞书群/私聊:打开飞书客户端,进入目标群组或私聊,通过「群设置→群机器人→添加机器人」,搜索每个机器人的应用名称并添加,完成后即可通过飞书与机器人交互。

    💡 提示:配置长连接时,需确保 Openclaw 服务已启动,否则无法保存长连接设置;若保存失败,重新执行 openclaw gateway start 启动服务后再尝试。

    2.4 第四步:多机器人测试验证(确保配置生效)

    配置完成后,需逐个测试机器人,确保每个机器人能正常响应指令,分工明确,测试步骤如下:

    1. 单个机器人测试:在飞书内找到对应机器人(私聊或群聊),@机器人发送指令(如办公助手发送「帮我整理今天的会议要点」,资讯推送发送「推送今日行业热点」),查看机器人是否正常响应;
    2. 批量测试:同时向多个机器人发送对应指令,确认每个机器人仅响应自身分工范围内的指令,无串流、无延迟;
    3. 命令行测试(可选,快速验证连通性):
    bash ~/.openclaw/config-menu.sh
    # 选择 (7) 快速测试 → (5) 测试飞书机器人
    # 按提示输入群组 chat id(以 oc_开头,可在飞书群设置→群信息中复制),发送测试消息
    
    1. 异常排查:若机器人不响应,查看日志定位问题:
    # 查看飞书渠道日志
    openclaw logs --channel feishu
    

    ✅ 测试成功标准:每个飞书机器人能正常接收指令,按对应 Agent 的配置响应,无报错、无串流,飞书内可正常查看响应结果。

    三、进阶优化:多机器人分工建议与配置技巧

    3.1 多机器人分工推荐(实用场景)

    根据日常工作需求,推荐以下分工方式,最大化发挥多机器人价值,可直接参考:

    • 办公助手机器人:绑定 office-assistant Agent,负责会议录音整理、月度报表生成、邮件提取与总结,解放办公重复劳动;
    • 资讯推送机器人:绑定 news-push Agent,负责定时推送行业热点、定制化早报,无需手动搜索信息;
    • 开发助手机器人:绑定 dev-assistant Agent,负责代码查询、调试建议、开发文档生成,提升开发效率;
    • 生活助手机器人:绑定 life-assistant Agent,负责航班信息提取、自动值机、日程提醒,便捷处理生活事务。

    3.2 配置技巧(避坑指南)

    • 📌 凭证管理:每个飞书应用的 App Secret 需妥善保管,切勿泄露,若泄露需及时在飞书开放平台重置;
    • 📌 权限配置:务必添加核心权限(im:message、im:message:send_as_bot),否则机器人无法收发消息;
    • 📌 服务稳定性:本地部署建议设置 Openclaw 开机自启,避免重启电脑后服务中断;云端部署可 7×24 小时运行,推荐新手使用;
    • 📌 Agent 配置:不同 Agent 的工作空间做好区分,避免配置文件混淆,可在 IDENTITY.md 中明确 Agent 分工;
    • 📌 版本兼容:确保 Openclaw 版本为 2026.2.9 及以上,避免因版本过低导致飞书多渠道配置失败。

    3.3 拓展功能:定时任务配置(可选)

    可通过 Openclaw 为飞书机器人配置定时任务,实现自动化推送,示例如下(以资讯推送机器人为例):

    1. 获取飞书群机器人 Webhook 地址:飞书群设置→群机器人→添加机器人→选择自定义机器人,填写名称后复制 Webhook 地址;
    2. 在飞书内给资讯推送机器人发送指令:「帮我创建定时任务,每天早上 9 点推送行业热点,推送至指定群聊,使用以下 Webhook 地址:[复制的 Webhook 地址]」;
    3. 验证定时任务:可让 Agent 立即发送测试消息,查看群聊是否收到推送,若需修改或取消定时任务,直接在飞书内发送对应指令即可。

    四、常见问题排查(新手必看,避坑神器)

    配置过程中难免遇到问题,整理了 6 个高频问题,附详细解决方案,无需额外搜索,直接对照排查:

    • 问题 1:飞书长连接保存失败? 解决方案:确保 Openclaw 服务已启动(执行 openclaw gateway start),飞书后台需要检测到客户端连接才能保存长连接设置,启动服务后重新尝试保存。
    • 问题 2:机器人不回复消息? 解决方案:依次检查 4 点:① Openclaw 服务是否正常运行(openclaw gateway status);② 飞书事件订阅是否添加了 im.message.receive_v1 事件;③ 飞书应用是否添加了核心权限;④ 应用是否已发布,机器人是否已添加到群聊/私聊。
    • 问题 3:群聊中@机器人无响应? 解决方案:默认情况下,群聊中需@机器人才能触发响应,避免机器人响应所有消息,若需修改触发方式,可在 Openclaw Agent 配置中调整。
    • 问题 4:私聊机器人不回复? 解决方案:确认自己在飞书应用的「可用范围」内,尝试在飞书内搜索机器人名称,点击进入私聊后发送消息测试。
    • 问题 5:多机器人出现串流(指令发送给 A 机器人,B 机器人响应)? 解决方案:检查 Agent 与飞书渠道的绑定关系,确保每个 Agent 仅绑定一个飞书账号,执行 openclaw agents bindings 查看绑定结果,若绑定错误,重新执行绑定命令。
    • 问题 6:配置完成后,重启 Openclaw 服务,机器人失效? 解决方案:检查飞书渠道配置是否保存,可重新进入 config-menu.sh,确认飞书渠道的 App ID 和 App Secret 配置正确,重启 gateway 后再次测试。

    五、总结与拓展

    到这里,Openclaw+ 飞书多机器人配置就全部完成了!其实核心逻辑很简单:

    📝 核心逻辑:创建多个飞书应用(机器人)→ 配置 Openclaw 多 Agent → 绑定两者实现分工

    🚀 拓展方向:后续可根据需求,为每个 Agent 配置更多技能(如邮件处理、语音转文字、飞书文档生成等)。

    附:常用命令汇总(复制即用)

    # Openclaw 服务相关
    openclaw gateway start # 启动网关
    openclaw gateway status # 查看服务状态
    openclaw gateway stop # 停止网关
    
    # Agent 相关
    openclaw agents add 【Agent 名称】 # 创建 Agent
    openclaw agents list # 查看 Agent 列表
    openclaw agents bind --agent 【Agent 名称】 --bind feishu:【账号名】 # 绑定 Agent 与飞书渠道
    openclaw agents bindings # 查看绑定结果
    
    # 飞书渠道相关
    bash ~/.openclaw/config-menu.sh # 进入配置菜单
    openclaw logs --channel feishu # 查看飞书渠道日志
    
    # 测试相关
    openclaw pairing approve feishu 【配对码】 # 飞书机器人配对(若需)
    

    目录

    1. 一、配置前必看:核心说明与前置准备
    2. 1.1 核心价值
    3. 1.2 前置环境准备(必做)
    4. 1.3 核心概念科普(新手必看)
    5. 二、分步实操:Openclaw+ 飞书多机器人配置
    6. 2.1 第一步:创建多个飞书企业自建应用(对应多机器人)
    7. 2.2 第二步:配置 Openclaw 多 Agent(对应多机器人分工)
    8. 启动 Openclaw 网关
    9. 查看服务状态,确认启动成功
    10. 创建第一个 Agent(办公助手,对应第一个飞书机器人)
    11. 创建第二个 Agent(资讯推送,对应第二个飞书机器人)
    12. 创建第三个 Agent(开发助手,对应第三个飞书机器人)
    13. 2.3 第三步:配置飞书渠道,绑定 Agent 与飞书机器人(核心步骤)
    14. 绑定 office-assistant Agent 到第一个飞书账号(main 对应第一个渠道)
    15. 绑定 news-push Agent 到第二个飞书账号(自定义账号名,如 news)
    16. 绑定 dev-assistant Agent 到第三个飞书账号(自定义账号名,如 dev)
    17. 2.4 第四步:多机器人测试验证(确保配置生效)
    18. 选择 (7) 快速测试 → (5) 测试飞书机器人
    19. 按提示输入群组 chat id(以 oc_开头,可在飞书群设置→群信息中复制),发送测试消息
    20. 查看飞书渠道日志
    21. 三、进阶优化:多机器人分工建议与配置技巧
    22. 3.1 多机器人分工推荐(实用场景)
    23. 3.2 配置技巧(避坑指南)
    24. 3.3 拓展功能:定时任务配置(可选)
    25. 四、常见问题排查(新手必看,避坑神器)
    26. 五、总结与拓展
    27. 附:常用命令汇总(复制即用)
    28. Openclaw 服务相关
    29. Agent 相关
    30. 飞书渠道相关
    31. 测试相关

    更多推荐文章

    查看全部
    • MySQL 分库分表中的聚合查询与扩容方案
    • 构建 Java 镜像的 10 个最佳实践
    • Python try-except-else 异常处理详解
    • 芋道项目部署:前端直连与 Nginx 反向代理方案对比
    • Soft Actor-Critic (SAC) 算法详解与 PyTorch 实现
    • 2026 年毕业论文 AI 检测标准及各高校红线汇总
    • Java 滑动窗口算法实战:LeetCode 经典题解
    • Ubuntu 部署 OpenClaw 并接入飞书机器人
    • 为什么开源语言大模型很重要?
    • AI 写作发展趋势与展望
    • C语言Web开发:CGI、FastCGI与Nginx模块实战
    • JavaScript 内存管理机制与变量作用域优化
    • Reachy Mini:桌面机器人开源硬件设计与实现
    • Ubuntu 403 软件包下载错误解决方法
    • 如何成为一名职业黑客:核心技能与成长路径
    • 三年前端转 CS 硕士:我在韩国亚大的留学复盘与回归前端
    • FPGA 是什么:现场可编程门阵列详解
    • Hashcat 密码恢复工具用法详解
    • Python 协程基础与 asyncio 异步编程实战
    • Three.js 模型导入后显示黑色的常见原因及解决方案

    相关免费在线工具

    • RSA密钥对生成器

      生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

    • Mermaid 预览与可视化编辑

      基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

    • 随机西班牙地址生成器

      随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

    • Base64 字符串编码/解码

      将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

    • Base64 文件转换器

      将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

    • Markdown转HTML

      将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online