OpenClaw对接飞书

如果你要对接飞书,则需要这些操作,飞书的官方文档一直在变,一切要以最新的为准,这里只简单做介绍

注意:尽量用社区版的飞书插件,openclaw自带的飞书插件兼容性并不是很好

创建飞书应用

打开飞书开放平台: https://open.feishu.cn/

点击 开发者后台创建企业自建应用

image

image

填写信息后点击 创建

image

配置机器人权限

接下来添加应用能力

image

点击添加,就可以到机器人管理页面

image

点击权限管理,然后点击开通权限

image

在搜索框输入im:message,然后确认开通权限

image

如果觉得麻烦的话可以选择批量导入/导出权限,将以下配置复制粘贴到导入框

{
  "scopes": {
    "tenant": [
  "contact:contact.base:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.reactions:read",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_depts",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update"
    ],
    "user": [
      "contact:user.base:readonly"
    ]
  }
}

image

然后点击创建版本

image

填写相关信息后保存

image

确认发布

image

然后你会在飞书里面收到审核通过的消息,如果没有那就自己手动审核一下

image

安装飞书插件并接入 OpenClaw

按照我们之前的教程配置了系统代理和环境后

来到飞书配置界面

image

千万不要用openclaw安装程序默认的飞书插件!不要用@openclaw/feishu 这个,否则会报错image

因为会报错

image

手动安装飞书插件

如果你安装的时候报错了,则需要手动配置插件

不要用默认飞书插件,在确保挂了国外的网络以后,直接安装社区最新版飞书插件:

openclaw plugins install @m1heng-clawd/feishu

如果你之前已经安装过 OpenClaw,先把进程暂停:(没装过不用运行)

openclaw gateway stop

如果你之前安装过默认的飞书插件,为了避免冲突,先删除旧插件:(没装过不用运行)

rm -rf ~/.npm-global/lib/node_modules/openclaw/extensions/feishu
rm -rf ~/.openclaw/extensions/feishu

重启 OpenClaw:

openclaw gateway restart

配置飞书:

openclaw channels add

然后按界面提示操作:

image

选择飞书

image

image

获取 App ID 和 App Secret:登录飞书开放平台,进入你创建的机器人的 基础信息 页面,找到这两个值

image

填入 App ID,按回车键

image

填入 App Secret,按回车键

image

飞书域名,如果你是国内的飞书,选feishu.cn,国外的选lark

image

继续配置:按回车键,选择 Open-respond in all groups,再按回车键

image

选择 Finished,按回车键

image

选择 Yes,按回车键

image

选择 Open,按回车键

image

选择 Continue,按回车键

image

重启openclaw即可 openclaw gateway restart

 

飞书机器人事件与回调配置

进入配置页面:登录飞书开放平台,进入你创建的机器人,选择 事件与回调

选择订阅方式:全部选择 使用长链接接收事件

image

image

添加必需事件

点击 添加事件

image

添加以下 4 个事件:
事件
说明
im.message.receive_v1
接收消息(必需)
im.message.message_read_v1
消息已读
im.chat.member.bot.added_v1
机器人进群
im.chat.member.bot.deleted_v1
机器人被移出群
通过搜索框查询完成添加:

image

重新发布应用

点击上方的 创建版本,填入相关信息,然后点击 保存

image

点击 确认发布,完成事件配置

image

开始使用你的机器人

打开飞书,找到你的机器人,直接对话测试
注意:第一次使用的时候会提示允许当前设备对话,在命令行输入他给你的提示就行了
 

疑难杂症

如果你用的是Windows+WSL2+V2RAY+Mirror镜像网络模式,那么feishu.cn域名可能会被屏蔽,如果你出现连接不上,先让openclaw检查一下和飞书渠道的连接问题,如果还是不行,参考这个源码,添加NO PROXY参数,不代理feishu.cn、钉钉、企业微信、国内云厂AI等域名
mkdir -p ~/.config/systemd/user/openclaw-gateway.service.d
cat > ~/.config/systemd/user/openclaw-gateway.service.d/override.conf <<'EOF'
[Service]
Environment="NO_PROXY=localhost,127.0.0.1,::1,.local,<local>,feishu.cn,.feishu.cn,larksuite.com,.larksuite.com,qyapi.weixin.qq.com,work.weixin.qq.com,dingtalk.com,.dingtalk.com,open.bigmodel.cn,api.moonshot.cn,api.deepseek.com,dashscope.aliyuncs.com,qianfan.baidubce.com"
Environment="no_proxy=localhost,127.0.0.1,::1,.local,<local>,feishu.cn,.feishu.cn,larksuite.com,.larksuite.com,qyapi.weixin.qq.com,work.weixin.qq.com,dingtalk.com,.dingtalk.com,open.bigmodel.cn,api.moonshot.cn,api.deepseek.com,dashscope.aliyuncs.com,qianfan.baidubce.com"
EOF
systemctl --user daemon-reload
systemctl --user restart openclaw-gateway

其他的可能遇到的小配置

2026年3月份以后,openclaw安装工具新增了搜索引擎提供者,这里基本都是国外的搜索引擎,所以直接跳过

image

Skill是一些给openclaw的技能,你可以自己探索安装,也可以选择NO跳过

image

Hooks这里选装,可选择跳过,或启用 Memory(启用记忆功能,支持多轮对话上下文关联,避免多次聊天需要重复说明需求)功能以支持多轮对话上下文,按回车确认

image

 
© 版权声明
THE END
喜欢就支持一下吧
点赞16 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容