> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mattermost

# Mattermost (plugin)

Status: supported via plugin (bot token + WebSocket events). Channels, groups, and DMs are supported.
Mattermost is a self-hostable team messaging platform; see the official site at
[mattermost.com](https://mattermost.com) for product details and downloads.

## Yêu cầu plugin

Mattermost được phân phối dưới dạng plugin và không được gộp sẵn trong bản cài đặt lõi.

Cài đặt qua CLI (npm registry):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/mattermost
```

Cài đặt từ mã nguồn cục bộ (khi chạy từ repo git):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install ./extensions/mattermost
```

Nếu bạn chọn Mattermost trong quá trình cấu hình/hướng dẫn ban đầu và phát hiện có bản checkout git,
OpenClaw sẽ tự động đề xuất đường dẫn cài đặt cục bộ.

Chi tiết: [Plugins](/tools/plugin)

## Khởi động nhanh

1. Cài đặt plugin Mattermost.
2. Tạo tài khoản bot Mattermost và sao chép **bot token**.
3. Sao chép **base URL** của Mattermost (ví dụ: `https://chat.example.com`).
4. Cấu hình OpenClaw và khởi động gateway.

Cấu hình tối thiểu:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
    },
  },
}
```

## Biến môi trường (tài khoản mặc định)

Thiết lập các biến này trên máy chủ gateway nếu bạn предпоч thích dùng biến môi trường:

* `MATTERMOST_BOT_TOKEN=...`
* `MATTERMOST_URL=https://chat.example.com`

Env vars apply only to the **default** account (`default`). Other accounts must use config values.

## Chế độ chat

Mattermost responds to DMs automatically. Channel behavior is controlled by `chatmode`:

* `oncall` (mặc định): chỉ phản hồi khi được @mention trong kênh.
* `onmessage`: phản hồi mọi tin nhắn trong kênh.
* `onchar`: phản hồi khi tin nhắn bắt đầu bằng tiền tố kích hoạt.

Ví dụ cấu hình:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    mattermost: {
      chatmode: "onchar",
      oncharPrefixes: [">", "!"],
    },
  },
}
```

Ghi chú:

* `onchar` vẫn phản hồi các @mention rõ ràng.
* `channels.mattermost.requireMention` vẫn được tôn trọng cho cấu hình cũ nhưng `chatmode` được ưu tiên.

## Kiểm soát truy cập (DM)

* Mặc định: `channels.mattermost.dmPolicy = "pairing"` (người gửi chưa biết sẽ nhận mã ghép cặp).
* Phê duyệt qua:
  * `openclaw pairing list mattermost`
  * `openclaw pairing approve mattermost <CODE>`
* DM công khai: `channels.mattermost.dmPolicy="open"` cộng với `channels.mattermost.allowFrom=["*"]`.

## Kênh (nhóm)

* Mặc định: `channels.mattermost.groupPolicy = "allowlist"` (giới hạn theo mention).
* Cho phép người gửi theo danh sách cho phép bằng `channels.mattermost.groupAllowFrom` (ID người dùng hoặc `@username`).
* Kênh mở: `channels.mattermost.groupPolicy="open"` (giới hạn theo mention).

## Đích để gửi ra ngoài

Sử dụng các định dạng đích này với `openclaw message send` hoặc cron/webhooks:

* `channel:<id>` cho một kênh
* `user:<id>` cho một DM
* `@username` cho một DM (được phân giải qua API Mattermost)

ID trần được coi là kênh.

## Đa tài khoản

Mattermost hỗ trợ nhiều tài khoản dưới `channels.mattermost.accounts`:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    mattermost: {
      accounts: {
        default: { name: "Primary", botToken: "mm-token", baseUrl: "https://chat.example.com" },
        alerts: { name: "Alerts", botToken: "mm-token-2", baseUrl: "https://alerts.example.com" },
      },
    },
  },
}
```

## Xử lý sự cố

* Không có phản hồi trong kênh: đảm bảo bot đã ở trong kênh và được mention (oncall), dùng tiền tố kích hoạt (onchar), hoặc đặt `chatmode: "onmessage"`.
* Lỗi xác thực: kiểm tra bot token, base URL và việc tài khoản có được bật hay không.
* Vấn đề đa tài khoản: biến môi trường chỉ áp dụng cho tài khoản `default`.