Hermes：openclaw的最佳替代之基于源码部署的飞书配置

飞书接入 Hermes 配置总结

飞书侧的配置与接入OpenClaw方式一致，可参考我发的另外的关于OpenClaw配置飞书的操作指南。这篇文章重点分享Hermes侧的配置和启动命令，以及常见报错解决方案；

结果

飞书已成功接入当前源码方式运行的 Hermes。

已确认：

• Hermes 通过源码方式启动成功
• Feishu WebSocket 连接成功建立
• 私聊机器人可以正常回复

当前运行方式

项目目录：

• ~/code/github/hermes-agent

启动命令：

cd ~/code/github/hermes-agent
source venv/bin/activate
python -m gateway.run --verbose

已完成配置

已写入 ~/.hermes/.env 的关键项：

FEISHU_APP_ID=xxx
FEISHU_APP_SECRET=已配置（未在本文明文记录）
FEISHU_DOMAIN=feishu
FEISHU_CONNECTION_MODE=websocket
GATEWAY_ALLOW_ALL_USERS=true

说明：

• 当前是中国区飞书，因此 FEISHU_DOMAIN=feishu
• 连接模式使用 websocket，不需要公网 webhook
• 当前为了先跑通，启用了 GATEWAY_ALLOW_ALL_USERS=true

已安装依赖

在源码虚拟环境中已安装飞书依赖：

cd ~/code/github/hermes-agent
source venv/bin/activate
pip install -e '.[feishu]'

安装后已确认这些依赖可用：

• lark_oapi
• aiohttp
• websockets

过程中遇到的问题

1. 连接数超限

报错：

• 1000040350: the number of connections exceeded the limit

原因：

• 同一个飞书 App 之前被另一台机器上的 OpenClaw 占用

处理结果：

• 停止另一台机器上的旧服务后，当前 Hermes 成功连接

2. 本地源码环境说明

用户当前不是通过已安装的 hermes 命令启动，而是通过源码运行。

因此后续统一使用：

source venv/bin/activate
python -m gateway.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:readonly
• admin:app.info:readonly

后续建议

1. 如果只是自己先用，当前配置已经够用
2. 如果准备正式长期使用，建议：
   • 收紧访问控制，不再使用 GATEWAY_ALLOW_ALL_USERS=true
   • 改为配置 FEISHU_ALLOWED_USERS=...
3. 如果要在群里稳定使用，再补上聊天读取和应用信息读取权限