Mattermost

要让 OpenClaw 小助手进入 Mattermost 聊天室，你需要先给它装一个专门的“小工具包”，这个叫插件。装好之后，你还要在 Mattermost 里为小助手创建一个专门的机器人账号，拿到它的“密码”（bot token）和聊天室的“门牌号”（base URL）。

第一步：安装小工具包（插件）

1. 打开你的电脑终端（就像打开一个对电脑说话的小窗口）。
2. 输入安装命令：openclaw plugins install @openclaw/mattermost。这就像对电脑说：“请去商店把 Mattermost 插件买回来装上。”

第二步：准备机器人的“身份证”

1. 在你们的 Mattermost 聊天室里，创建一个新的机器人账号。
2. 找到并复制这个机器人的 bot token，这就像它的专属密码。
3. 复制你们聊天室的网址，比如 https://chat.example.com，这就像聊天室的门牌号。

第三步：告诉小助手怎么进去 你需要写一个简单的“说明纸条”（配置文件）给小助手。纸条上要写清楚：

• enabled: true：告诉它“可以开始工作了”。
• botToken: "mm-token"：这里贴上你刚才复制的机器人密码。
• baseUrl: "https://chat.example.com"：这里写上聊天室的门牌号。
• dmPolicy: "pairing"：这表示如果有陌生人私聊小助手，需要先对一下暗号。

小助手在聊天室里的规矩 小助手很懂礼貌，在大家的公共频道里，它不会随便插嘴。

• 默认情况下（chatmode: "oncall"），只有在聊天里 @提到 它名字的时候，它才会回答。
• 你也可以设置成 chatmode: "onmessage"，这样它会对频道里的每一条消息都回应（可能会有点吵哦）。
• 或者设置成 chatmode: "onchar"，并指定一个“暗号”，比如 oncharPrefixes: [">", "!"]。这样，当消息以 > 或 ! 开头时，它就知道是在叫它了。

发送带按钮的酷消息！ 小助手可以发送带有按钮的消息，让大家点击选择。

1. 首先，要在“说明纸条”里加上一行：capabilities: ["inlineButtons"]，这等于告诉小助手：“我允许你使用按钮超能力。”
2. 当你想发带按钮的消息时，需要按照固定的格式告诉小助手按钮怎么排列。 这里要小心：按钮的 callback_data 里面，不能有短横线 - 或下划线 _，只能用字母和数字，否则按钮点了会没反应！

一些重要的提醒

• 安装：这个 Mattermost 功能是一个额外的“小工具包”，不是小助手自带的，所以你必须先安装它。
• 私聊控制：默认情况下，陌生人私聊小助手需要先对暗号。如果你想让所有人都能直接私聊，需要把 dmPolicy 改成 "open"。
• 按钮回调地址：如果你设置的按钮，点击后没反应，可能是 Mattermost 服务器找不到小助手的地址。不要把回调地址（callbackUrl）设置成 localhost，除非 Mattermost 和小助手在同一台电脑上。
• 多账号：你可以让小助手管理多个不同的 Mattermost 聊天室。但是，通过环境变量（像 MATTERMOST_BOT_TOKEN）设置的密码，只对名叫 default 的第一个账号有效。

如果遇到问题...

• 小助手在频道里不吭声？检查它是不是已经被邀请进那个频道了，并且你有没有用 @它的名字 的方式叫它。
• 按钮点了没反应？检查按钮的 id 是不是只用了字母和数字，没有用 - 或 _。
• 总是提示密码错误？检查你复制的 botToken 和 baseUrl 对不对，有没有多一个空格。