Hermes Agent 接 Mattermost,适合自托管团队把 AI 助手放进内部频道。核心不是安装额外库,而是创建 bot account、拿到 token、把 bot 加进频道,并配置允许用户 ID。
基本步骤
- 管理员先在 Mattermost 后台开启 Bot Account Creation。
- 创建 bot account,复制首次显示的 bot token。
- 把 bot 加到需要使用的频道。
- 找到你的 Mattermost User ID,注意它不是 @username。
- 运行
hermes gateway setup,选择 Mattermost,填 server URL、token 和允许用户。
手动配置示例
MATTERMOST_URL=https://mm.example.com
MATTERMOST_TOKEN=***
MATTERMOST_ALLOWED_USERS=3uo8dkh1p7g1mfk49ear5fzs5c
# 可选:MATTERMOST_REPLY_MODE=thread频道里默认需要 @ bot;想让某些频道不用 @,再配置 free response channels。遇到 403,先查 token 是否正确、bot 是否进了频道、账号是否被禁用。
一句话:Mattermost 配置重点是 bot token、User ID、频道成员关系和 allowed users。
怎么判断配置成功
启动 hermes gateway 后,先给 bot 发 DM。如果 DM 能回,再去频道里 @ 它测试。DM 不回,多半是 URL、token 或 allowed users 错;DM 回但频道不回,多半是 bot 没进频道、没有 @、或频道权限不足。需要 cron 主动发结果时,再用 /sethome 设置 home channel。
官方开源地址:https://github.com/NousResearch/hermes-agent;官方文档入口:https://hermes-agent.nousresearch.com/。