飞书接入 Hermes 配置总结飞书侧的配置与接入OpenClaw方式一致可参考我发的另外的关于OpenClaw配置飞书的操作指南。这篇文章重点分享Hermes侧的配置和启动命令以及常见报错解决方案结果飞书已成功接入当前源码方式运行的 Hermes。已确认Hermes 通过源码方式启动成功Feishu WebSocket 连接成功建立私聊机器人可以正常回复当前运行方式项目目录~/code/github/hermes-agent启动命令cd~/code/github/hermes-agentsourcevenv/bin/activate python-mgateway.run--verbose已完成配置已写入~/.hermes/.env的关键项FEISHU_APP_IDxxxFEISHU_APP_SECRET已配置未在本文明文记录FEISHU_DOMAINfeishuFEISHU_CONNECTION_MODEwebsocketGATEWAY_ALLOW_ALL_USERStrue说明当前是中国区飞书因此FEISHU_DOMAINfeishu连接模式使用websocket不需要公网 webhook当前为了先跑通启用了GATEWAY_ALLOW_ALL_USERStrue已安装依赖在源码虚拟环境中已安装飞书依赖cd~/code/github/hermes-agentsourcevenv/bin/activate pipinstall-e.[feishu]安装后已确认这些依赖可用lark_oapiaiohttpwebsockets过程中遇到的问题1. 连接数超限报错1000040350: the number of connections exceeded the limit原因同一个飞书 App 之前被另一台机器上的 OpenClaw 占用处理结果停止另一台机器上的旧服务后当前 Hermes 成功连接2. 本地源码环境说明用户当前不是通过已安装的hermes命令启动而是通过源码运行。因此后续统一使用sourcevenv/bin/activate python-mgateway.run--verbose当前剩余警告1. bot identity 自动识别权限不足警告大意无法从应用信息中自动获取 bot 身份建议补权限之一admin:app.info:readonly或application:application:self_manage影响主要影响群聊里 bot 的精确识别不影响私聊正常使用2. chat info 读取权限不足警告大意缺少聊天信息读取权限建议补权限之一im:chat:readonly推荐最小权限或im:chat:read或im:chat影响主要影响读取群聊/会话信息不影响当前私聊可用性当前结论当前飞书接入已可用至少满足私聊 bot 正常工作如果后续需要更稳定的群聊体验建议到飞书开放平台补充以下权限im:chat:readonlyadmin:app.info:readonly后续建议如果只是自己先用当前配置已经够用如果准备正式长期使用建议收紧访问控制不再使用GATEWAY_ALLOW_ALL_USERStrue改为配置FEISHU_ALLOWED_USERS...如果要在群里稳定使用再补上聊天读取和应用信息读取权限