乐于分享
好东西不私藏

OpenClaw Mattermost 插件安装与配置

OpenClaw Mattermost 插件安装与配置

OpenClaw 的 Mattermost 支持 是通过一个独立的插件实现的,它允许 OpenClaw 的 AI agent(也就是那个“蟹蟹”助手)接入自托管的 Mattermost 服务器,作为聊天机器人来使用。主要特点:

  • 支持文本消息交互(@用户名、#频道名 等都会被正确解析)
  • 使用 Bot Token + WebSocket 实时事件来连接
  • 目前只支持文本,语音通话(Calls plugin)还在 feature request 阶段(GitHub issue #12007

官方文档地址:https://docs.openclaw.ai/channels/mattermost

安装和配置步骤(2026年3月现状)

Mattermost 插件不是 core 自带,需要单独安装,但很多人遇到 npm 包 404 的问题(@openclaw/mattermost 不存在或没发到 npm)。

常见报错:

  • openclaw plugins install @openclaw/mattermost → 404 Not Found
  • openclaw plugins enable mattermost 看似成功,但 status 还是显示未配置

推荐的实际安装方式(来自 GitHub issue 和社区 workaround):

  1. 如果你是 从 git 源码运行 OpenClaw 的(推荐大多数自托管用户):

    Bash

    openclaw plugins install ./extensions/mattermost
    (前提是你有 extensions/mattermost 这个本地文件夹,通常 git clone 后就有)
  2. 如果是纯 npm/docker 安装,当前(2026年3月)官方 npm 包还没发出来,可以:
    • 等官方修复(看 GitHub issue #10147#19503#5331 进展)
    • 或找社区 fork(如 @hagivu/openclaw-mattermost,但似乎也不太稳定)
    • 或者直接用中文社区版(openclaw-cn),它可能已经内置或优化了 Mattermost 支持

安装后配置:

Bash

# 进入 OpenClaw 配置流程,或者直接编辑 configopenclaw config edit# 在 mattermost 部分填入:url: https://your-mattermost-server.comtoken: xoxb-your-bot-token-here   # 在 Mattermost 创建 Incoming Webhook 或 Bot Account 拿到team_id: xxx   # 可选

然后重启 gateway:

Bash

openclaw gateway restart

配置完成后,在 Mattermost 里 @你的bot名字 就能和 OpenClaw 对话了。

很多人为什么选择 Mattermost + OpenClaw?

  • 全自托管,数据完全私有(不像 Slack/Discord 要给第三方)
  • 有线程、频道、私信,适合把 AI 当团队成员用
  • 可以配合 Focalboard / Playbooks 做任务管理 + AI 辅助
  • 国内用户很多拿它做“个人/小团队的全私有 AI 中枢”

如果你是想找 OpenClaw 的公共 Mattermost 服务器(类似社区交流群),目前没有官方的公共实例,大家基本都是自己搭 Mattermost 再接 OpenClaw。

你现在是遇到安装问题,还是想知道怎么在 Mattermost 里用 OpenClaw 做更高级的 workflow?或者你已经有服务器了,想调试连接?告诉我具体情况我可以再细说~ 🦀