Mattermost 平台案例

Mattermost 是这三个平台里最适合“直接拉 Agent 进去”的实时聊天入口。它已经有 bot account、REST API v4、WebSocket、channel @mention、thread reply 等原生能力，因此 chat-native Agent 场景优先走 Hermes/Mattermost gateway，不需要先绕 RSSHub。

Mattermost RexWang 对话证据截图

当前验证状态

字段	值
平台	Mattermost Team Edition
Public URL	https://matter.public.wzhecnu.cn
Local short alias	`<local-service-alias>`（私有部署快捷入口；公开文档不记录具体本地域名）
Team / Channel	`agent-lab` / `agent-room`
Actor	`RexWang`（Mattermost username: `rexwang`）
Bot	`hermes-agent`
Trigger post	https://matter.public.wzhecnu.cn/agent-lab/pl/q7xk8wq3q3rbugodkdw6u8cuka
Reply post	https://matter.public.wzhecnu.cn/agent-lab/pl/9okz731eapf47jks96p87eo8ze
Event id	`mattermost:post:q7xk8wq3q3rbugodkdw6u8cuka:mention:hermes-agent`
Action	`mattermost.thread_reply`
Evidence screenshot	`docs/assets/platform-cases/mattermost-rexwang-conversation.png`

触发机制

RexWang 在 Mattermost agent-room 中 @hermes-agent
  -> Mattermost 产生真实 post event
  -> Hermes/Mattermost gateway 可直接通过 WebSocket 收到事件
  -> 或 ChatRSS mattermost.posts connector 将 post 标准化为 TriggerEvent
  -> router 判定 act
  -> hermes-agent 在 Mattermost thread 中真实回复
  -> ledger 记录 trigger/action/readback

这里的 前置动作 是 RexWang @hermes-agent。行动内容来自 Mattermost post 正文。

是否需要 ChatRSS？

结论：如果目标只是让 Agent 进入 Mattermost 房间，优先不需要 ChatRSS；直接走 Hermes/Mattermost gateway 更简单。

Mattermost 已经提供实时 agent 入口：

Mattermost WebSocket / REST API
  -> Hermes Mattermost gateway
  -> allowed users/channels / require mention
  -> agent run
  -> thread reply

ChatRSS 仍然有价值，但它的位置变成“统一事件层 / 审计层 / 跨平台 router”：

Mattermost post/webhook/WebSocket event
  -> mattermost.posts connector
  -> TriggerEvent
  -> Rule Router / Model Router
  -> optional Action Planner
  -> Ledger

也就是说：Mattermost 可以不经过 RSSHub；但如果要把 Zulip、Discourse、Mattermost、GitHub feed 都放进同一套去重、路由、审计和 action ledger，ChatRSS 仍然是统一入口。

标准事件

{
  "source": "mattermost",
  "connector": "mattermost.posts",
  "event_type": "community.mention.created",
  "event_id": "mattermost:post:q7xk8wq3q3rbugodkdw6u8cuka:mention:hermes-agent",
  "actor": {
    "type": "mattermost_user",
    "username": "rexwang",
    "display_name": "RexWang"
  },
  "subject": {
    "type": "mattermost.post",
    "team": "agent-lab",
    "channel": "agent-room",
    "post_id": "q7xk8wq3q3rbugodkdw6u8cuka"
  },
  "raw": {
    "mentions": ["hermes-agent"],
    "marker": "chatrss-mattermost-trigger-20260805043149"
  }
}

当前接入配置

Mattermost 接入配置应保存在主机侧受保护的 secret store 或 ChatEnv profile 中。公开文档只描述配置类别，不列真实文件路径、secret-bearing env key 名或任何 credential 值。

配置类别：

Mattermost public/base URL
Bot authentication credential
Bot username / allowed actor policy
Home channel and reply mode
Mention-required safety switch

Mattermost 平台案例

当前验证状态

触发机制

是否需要 ChatRSS？

标准事件

当前接入配置

推荐用法

直接 Agent 房间

ChatRSS 统一 router