概述
Mattermost 是 fries-mac 与用户通信的主要平台(235条消息)。配置涉及服务器地址设置、Bot 账号绑定、文件发送功能、会话管理等方面。服务器部署在 mm.dora.restry.cn。
关键事件
- 2026-03-03: 修复 Mattermost 服务器地址错误(应为 mm.dora.restry.cn)
- 2026-03-03: 要求将配置信息准确记录,避免反复出错
- 2026-03-07: 在 tiger-host 上安装 Supabase(参考官方 Docker 文档)
- 2026-03-10: 处理
/compact、/new、/reset等命令 - 2026-03-17: 新建会话,切换模型到 claude-opus-4.6
- 2026-04-04: 持续进行配置维护和更新
技术要点
- 服务器地址: mm.dora.restry.cn
- Bot Token: 通过 OpenClaw 网关配置
- 文件发送: 需要通过 Mattermost API 上传附件
- 会话管理: 支持
/compact(压缩上下文)、/new(新会话)、/reset(重置)
经验教训
- 服务器地址等关键配置必须准确记录到记忆中
- Bot 配置变更后需要重启 Gateway 才能生效
/compact命令可用于压缩上下文窗口,避免 token 超限- 文件发送功能需要正确调用 API,不能仅输出文件路径
相关主题
- openclaw-config
- file-sending
- caddy-reverse-proxy
- gatewaybot
- dev-port-management — 3000系/4000系端口分配方案
Bot 开发端口约定
以下信息来源于 gatewaybot 的 Mattermost DM 聊天记录(2026-03-18)。
各项目 Bot 开发时的本地端口分配:
| 项目 | 前端端口 | 后端端口 | 备注 |
|---|---|---|---|
| Clawline Gateway | 3020 | 3021 | 不使用 18800~18890 区间 |
用户明确要求不使用 18800~18890 区间端口,改用 3000 区间。开发站点通过 Caddy 反向代理暴露为 HTTPS(如 gw.dev.dora.restry.cn)。
注意事项:
- Vite dev server 需要配置
server.allowedHosts以允许域名访问 crypto.randomUUID()在非 HTTPS 环境下不可用,需用crypto.getRandomValues()作为 fallback
Prism Bot 频道配置
以下信息来源于 bnef 的 Mattermost DM 聊天记录(2026-03-13)。
Prism 项目使用了 3 个 Mattermost 频道:
- prism-general — 通用讨论和日报发布
- prism-dev — 开发讨论
- prism-standup — 每日站会自动推送
5 个 Bot 账号的 Mattermost 配置(在 openclaw.json 的 channels.mattermost.accounts 中):
| Bot | dmPolicy | chatmode | 群消息触发 |
|---|---|---|---|
| prism-pm | open | onchar(前缀 pm) | pm 开头 或 @prism-pm |
| prism-arch | open | oncall | @prism-arch |
| prism-data | open | oncall | @prism-data |
| prism-ui | open | oncall | @prism-ui |
| prism-docs | open | oncall | @prism-docs |
默认账号配置:dmPolicy: "pairing", groupPolicy: "open", allowFrom: ["*"]。
Mattermost 服务器迁移(2026-03-15)
以下信息来源于 work_assistant 的 Mattermost DM 聊天记录。
原 Mattermost 服务器 mm.dora.restry.cn 运行在本地。为 Prism 项目创建了独立的新实例:
| 步骤 | 内容 |
|---|---|
| VM 准备 | transparent-n3 → 重建为 mattermost-server(保留磁盘+网卡) |
| DNS | mattermost-server.chinanorth3.cloudapp.chinacloudapi.cn |
| 镜像 | 推送至 northacr.azurecr.cn(Azure China 北区,免密 pull) |
| 部署 | Docker Compose: Mattermost + PostgreSQL + Caddy(HTTPS 自动证书) |
| Bot 迁移 | 5 个 prism- bot 在新服务器上创建并转为 bot 账号,生成 access token |
| OpenClaw 更新 | Eagle 服务器 openclaw.json 的 baseUrl 和 token 切换到新服务器 |
| 清理 | 旧服务器上停用 9 个用户 + 删除 3 个 prism 频道 |
Bot 死循环事件
新服务器上线后立即出现 Bot 互 @ 死循环——一个 Bot 回复时 @ 了另一个 Bot,触发连锁响应。
修复方案:
- 配置层:
groupAllowFrom仅允许人类用户 ID 触发(allowlist 模式) - 人设层:所有 Agent SOUL.md 明确禁止主动 @ Bot
- PM Bot 保持群聊全响应,其他 4 个 Bot 仅响应 allowlist 中的真人 @提及
注意:
ignoreBots是编造的不存在字段,正确方式为groupPolicy: "allowlist"+groupAllowFrom
相关主题
- openclaw-config
- file-sending
- caddy-reverse-proxy
- bnef — BNEF Bot Mattermost 频道配置
- work-assistant — 执行迁移操作的代理
- prism-bots — 被迁移的 Bot 集群
- bot-inventory — Bot 清单