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

飞书接入 Hermes 配置总结

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

结果

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

已确认：

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

当前运行方式

项目目录：

~/code/github/hermes-agent

启动命令：

bash 复制代码

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

已完成配置

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

bash 复制代码

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

已安装依赖

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

bash 复制代码

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 命令启动，而是通过源码运行。

因此后续统一使用：

bash 复制代码

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

后续建议

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