Mattermost 设置
Hermes Agent 与 Mattermost 作为机器人集成，通过直接消息或团队频道与你的 AI 助手聊天。Mattermost 是自托管、开源的 Slack 替代品。
行为
| 上下文 | 行为 |
|---|---|
| DM | Hermes 响应每条消息，无需 @mention |
| 频道 | 需要 @mention 才响应 |
| 线程 | MATTERMOST_REPLY_MODE=thread 时在线程中回复 |
设置步骤
步骤 1：启用机器人账户
- 以 System Admin 登录 Mattermost
- 进入 System Console → Integrations → Bot Accounts
- 启用 Enable Bot Account Creation
步骤 2：创建机器人账户
- 进入 Integrations → Bot Accounts
- 添加机器人用户名（如
hermes） - 复制显示的机器人令牌
步骤 3：配置 Hermes
hermes gateway setup # 选择 Mattermost
或手动：
MATTERMOST_URL=https://mm.example.com
MATTERMOST_TOKEN=你的令牌
MATTERMOST_ALLOWED_USERS=3uo8dkh1p7g1mfk49ear5fzs5c
配置选项
MATTERMOST_REPLY_MODE=thread # 线程回复模式
MATTERMOST_REQUIRE_MENTION=false # 无需提及
故障排除
| 问题 | 解决方案 |
|---|---|
| 机器人不响应 | 检查机器人已加入频道，MATTERMOST_ALLOWED_USERS 包含你的用户 ID |
| 403 错误 | 令牌无效或机器人没有发布权限 |
| WebSocket 断开 | 检查 nginx 配置需要 WebSocket 升级头 |
安全
注意
始终设置 MATTERMOST_ALLOWED_USERS 限制谁可以与机器人交互。