---
read_when:
    - Thiết lập tích hợp trò chuyện Twitch cho OpenClaw
sidebarTitle: Twitch
summary: Cấu hình và thiết lập bot trò chuyện Twitch
title: Twitch
x-i18n:
    generated_at: "2026-05-02T22:16:27Z"
    model: gpt-5.5
    provider: openai
    source_hash: c0d5f16d1369e2783bec6e0c7b2d7bee8aae86f2a424b77b9adf14850de0f20b
    source_path: channels/twitch.md
    workflow: 16
---

Hỗ trợ trò chuyện Twitch qua kết nối IRC. OpenClaw kết nối dưới dạng người dùng Twitch (tài khoản bot) để nhận và gửi tin nhắn trong các kênh.

## Plugin đi kèm

<Note>
Twitch được phát hành dưới dạng Plugin đi kèm trong các bản phát hành OpenClaw hiện tại, vì vậy các bản dựng đóng gói thông thường không cần cài đặt riêng.
</Note>

Nếu bạn đang dùng bản dựng cũ hơn hoặc bản cài đặt tùy chỉnh loại trừ Twitch, hãy cài trực tiếp gói npm:

<Tabs>
  <Tab title="npm registry">
    ```bash
    openclaw plugins install @openclaw/twitch
    ```
  </Tab>
  <Tab title="Bản checkout cục bộ">
    ```bash
    openclaw plugins install ./path/to/local/twitch-plugin
    ```
  </Tab>
</Tabs>

Dùng gói trần để theo thẻ phát hành chính thức hiện tại. Chỉ ghim một phiên bản chính xác khi bạn cần bản cài đặt có thể tái lập.

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

## Thiết lập nhanh (người mới bắt đầu)

<Steps>
  <Step title="Đảm bảo Plugin có sẵn">
    Các bản phát hành OpenClaw đóng gói hiện tại đã đi kèm Plugin này. Các bản cài đặt cũ hơn/tùy chỉnh có thể thêm thủ công bằng các lệnh ở trên.
  </Step>
  <Step title="Tạo tài khoản bot Twitch">
    Tạo một tài khoản Twitch riêng cho bot (hoặc dùng tài khoản hiện có).
  </Step>
  <Step title="Tạo thông tin xác thực">
    Dùng [Twitch Token Generator](https://twitchtokengenerator.com/):

    - Chọn **Mã bot**
    - Xác minh các phạm vi `chat:read` và `chat:write` đã được chọn
    - Sao chép **ID máy khách** và **Mã truy cập**

  </Step>
  <Step title="Tìm ID người dùng Twitch của bạn">
    Dùng [https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/](https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/) để chuyển đổi tên người dùng thành ID người dùng Twitch.
  </Step>
  <Step title="Cấu hình mã thông báo">
    - Biến môi trường: `OPENCLAW_TWITCH_ACCESS_TOKEN=...` (chỉ tài khoản mặc định)
    - Hoặc cấu hình: `channels.twitch.accessToken`

    Nếu cả hai đều được đặt, cấu hình được ưu tiên (dự phòng bằng biến môi trường chỉ áp dụng cho tài khoản mặc định).

  </Step>
  <Step title="Khởi động Gateway">
    Khởi động Gateway với kênh đã cấu hình.
  </Step>
</Steps>

<Warning>
Thêm kiểm soát truy cập (`allowFrom` hoặc `allowedRoles`) để ngăn người dùng trái phép kích hoạt bot. `requireMention` mặc định là `true`.
</Warning>

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

```json5
{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw", // Bot's Twitch account
      accessToken: "oauth:abc123...", // OAuth Access Token (or use OPENCLAW_TWITCH_ACCESS_TOKEN env var)
      clientId: "xyz789...", // Client ID from Token Generator
      channel: "vevisk", // Which Twitch channel's chat to join (required)
      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only - get it from https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/
    },
  },
}
```

## Đây là gì

- Một kênh Twitch do Gateway sở hữu.
- Định tuyến xác định: các phản hồi luôn quay lại Twitch.
- Mỗi tài khoản ánh xạ tới một khóa phiên cô lập `agent:<agentId>:twitch:<accountName>`.
- `username` là tài khoản của bot (tài khoản xác thực), `channel` là phòng trò chuyện cần tham gia.

## Thiết lập (chi tiết)

### Tạo thông tin xác thực

Dùng [Twitch Token Generator](https://twitchtokengenerator.com/):

- Chọn **Mã bot**
- Xác minh các phạm vi `chat:read` và `chat:write` đã được chọn
- Sao chép **ID máy khách** và **Mã truy cập**

<Note>
Không cần đăng ký ứng dụng thủ công. Mã thông báo hết hạn sau vài giờ.
</Note>

### Cấu hình bot

<Tabs>
  <Tab title="Biến môi trường (chỉ tài khoản mặc định)">
    ```bash
    OPENCLAW_TWITCH_ACCESS_TOKEN=oauth:abc123...
    ```
  </Tab>
  <Tab title="Cấu hình">
    ```json5
    {
      channels: {
        twitch: {
          enabled: true,
          username: "openclaw",
          accessToken: "oauth:abc123...",
          clientId: "xyz789...",
          channel: "vevisk",
        },
      },
    }
    ```
  </Tab>
</Tabs>

Nếu cả biến môi trường và cấu hình đều được đặt, cấu hình được ưu tiên.

### Kiểm soát truy cập (khuyến nghị)

```json5
{
  channels: {
    twitch: {
      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only
    },
  },
}
```

Ưu tiên `allowFrom` cho danh sách cho phép cứng. Thay vào đó dùng `allowedRoles` nếu bạn muốn truy cập dựa trên vai trò.

**Vai trò có sẵn:** `"moderator"`, `"owner"`, `"vip"`, `"subscriber"`, `"all"`.

<Note>
**Vì sao dùng ID người dùng?** Tên người dùng có thể thay đổi, cho phép mạo danh. ID người dùng là vĩnh viễn.

Tìm ID người dùng Twitch của bạn: [https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/](https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/) (Chuyển đổi tên người dùng Twitch của bạn thành ID)
</Note>

## Làm mới mã thông báo (tùy chọn)

Các mã thông báo từ [Twitch Token Generator](https://twitchtokengenerator.com/) không thể được làm mới tự động - hãy tạo lại khi hết hạn.

Để tự động làm mới mã thông báo, hãy tạo ứng dụng Twitch của riêng bạn tại [Twitch Developer Console](https://dev.twitch.tv/console) và thêm vào cấu hình:

```json5
{
  channels: {
    twitch: {
      clientSecret: "your_client_secret",
      refreshToken: "your_refresh_token",
    },
  },
}
```

Bot tự động làm mới mã thông báo trước khi hết hạn và ghi nhật ký các sự kiện làm mới.

## Hỗ trợ nhiều tài khoản

Dùng `channels.twitch.accounts` với mã thông báo theo từng tài khoản. Xem [Cấu hình](/vi/gateway/configuration) để biết mẫu dùng chung.

Ví dụ (một tài khoản bot trong hai kênh):

```json5
{
  channels: {
    twitch: {
      accounts: {
        channel1: {
          username: "openclaw",
          accessToken: "oauth:abc123...",
          clientId: "xyz789...",
          channel: "vevisk",
        },
        channel2: {
          username: "openclaw",
          accessToken: "oauth:def456...",
          clientId: "uvw012...",
          channel: "secondchannel",
        },
      },
    },
  },
}
```

<Note>
Mỗi tài khoản cần mã thông báo riêng (một mã thông báo cho mỗi kênh).
</Note>

## Kiểm soát truy cập

<Tabs>
  <Tab title="Danh sách cho phép ID người dùng (an toàn nhất)">
    ```json5
    {
      channels: {
        twitch: {
          accounts: {
            default: {
              allowFrom: ["123456789", "987654321"],
            },
          },
        },
      },
    }
    ```
  </Tab>
  <Tab title="Dựa trên vai trò">
    ```json5
    {
      channels: {
        twitch: {
          accounts: {
            default: {
              allowedRoles: ["moderator", "vip"],
            },
          },
        },
      },
    }
    ```

    `allowFrom` là danh sách cho phép cứng. Khi được đặt, chỉ các ID người dùng đó mới được phép. Nếu bạn muốn truy cập dựa trên vai trò, hãy để `allowFrom` chưa đặt và cấu hình `allowedRoles` thay thế.

  </Tab>
  <Tab title="Tắt yêu cầu @mention">
    Theo mặc định, `requireMention` là `true`. Để tắt và phản hồi tất cả tin nhắn:

    ```json5
    {
      channels: {
        twitch: {
          accounts: {
            default: {
              requireMention: false,
            },
          },
        },
      },
    }
    ```

  </Tab>
</Tabs>

## Khắc phục sự cố

Trước tiên, chạy các lệnh chẩn đoán:

```bash
openclaw doctor
openclaw channels status --probe
```

<AccordionGroup>
  <Accordion title="Bot không phản hồi tin nhắn">
    - **Kiểm tra kiểm soát truy cập:** Đảm bảo ID người dùng của bạn nằm trong `allowFrom`, hoặc tạm thời xóa `allowFrom` và đặt `allowedRoles: ["all"]` để kiểm thử.
    - **Kiểm tra bot có ở trong kênh:** Bot phải tham gia kênh được chỉ định trong `channel`.

  </Accordion>
  <Accordion title="Sự cố mã thông báo">
    "Không kết nối được" hoặc lỗi xác thực:

    - Xác minh `accessToken` là giá trị mã truy cập OAuth (thường bắt đầu bằng tiền tố `oauth:`)
    - Kiểm tra mã thông báo có các phạm vi `chat:read` và `chat:write`
    - Nếu dùng làm mới mã thông báo, xác minh `clientSecret` và `refreshToken` đã được đặt

  </Accordion>
  <Accordion title="Làm mới mã thông báo không hoạt động">
    Kiểm tra nhật ký để tìm các sự kiện làm mới:

    ```
    Using env token source for mybot
    Access token refreshed for user 123456 (expires in 14400s)
    ```

    Nếu bạn thấy "token refresh disabled (no refresh token)":

    - Đảm bảo `clientSecret` được cung cấp
    - Đảm bảo `refreshToken` được cung cấp

  </Accordion>
</AccordionGroup>

## Cấu hình

### Cấu hình tài khoản

<ParamField path="username" type="string">
  Tên người dùng bot.
</ParamField>
<ParamField path="accessToken" type="string">
  Mã truy cập OAuth với `chat:read` và `chat:write`.
</ParamField>
<ParamField path="clientId" type="string">
  ID máy khách Twitch (từ Token Generator hoặc ứng dụng của bạn).
</ParamField>
<ParamField path="channel" type="string" required>
  Kênh cần tham gia.
</ParamField>
<ParamField path="enabled" type="boolean" default="true">
  Bật tài khoản này.
</ParamField>
<ParamField path="clientSecret" type="string">
  Tùy chọn: dùng để tự động làm mới mã thông báo.
</ParamField>
<ParamField path="refreshToken" type="string">
  Tùy chọn: dùng để tự động làm mới mã thông báo.
</ParamField>
<ParamField path="expiresIn" type="number">
  Thời hạn mã thông báo tính bằng giây.
</ParamField>
<ParamField path="obtainmentTimestamp" type="number">
  Dấu thời gian lấy mã thông báo.
</ParamField>
<ParamField path="allowFrom" type="string[]">
  Danh sách cho phép ID người dùng.
</ParamField>
<ParamField path="allowedRoles" type='Array<"moderator" | "owner" | "vip" | "subscriber" | "all">'>
  Kiểm soát truy cập dựa trên vai trò.
</ParamField>
<ParamField path="requireMention" type="boolean" default="true">
  Yêu cầu @mention.
</ParamField>

### Tùy chọn nhà cung cấp

- `channels.twitch.enabled` - Bật/tắt khởi động kênh
- `channels.twitch.username` - Tên người dùng bot (cấu hình một tài khoản được đơn giản hóa)
- `channels.twitch.accessToken` - Mã truy cập OAuth (cấu hình một tài khoản được đơn giản hóa)
- `channels.twitch.clientId` - ID máy khách Twitch (cấu hình một tài khoản được đơn giản hóa)
- `channels.twitch.channel` - Kênh cần tham gia (cấu hình một tài khoản được đơn giản hóa)
- `channels.twitch.accounts.<accountName>` - Cấu hình nhiều tài khoản (tất cả các trường tài khoản ở trên)

Ví dụ đầy đủ:

```json5
{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw",
      accessToken: "oauth:abc123...",
      clientId: "xyz789...",
      channel: "vevisk",
      clientSecret: "secret123...",
      refreshToken: "refresh456...",
      allowFrom: ["123456789"],
      allowedRoles: ["moderator", "vip"],
      accounts: {
        default: {
          username: "mybot",
          accessToken: "oauth:abc123...",
          clientId: "xyz789...",
          channel: "your_channel",
          enabled: true,
          clientSecret: "secret123...",
          refreshToken: "refresh456...",
          expiresIn: 14400,
          obtainmentTimestamp: 1706092800000,
          allowFrom: ["123456789", "987654321"],
          allowedRoles: ["moderator"],
        },
      },
    },
  },
}
```

## Hành động công cụ

Tác nhân có thể gọi `twitch` với hành động:

- `send` - Gửi tin nhắn tới một kênh

Ví dụ:

```json5
{
  action: "twitch",
  params: {
    message: "Hello Twitch!",
    to: "#mychannel",
  },
}
```

## An toàn và vận hành

- **Xử lý mã thông báo như mật khẩu** — Không bao giờ commit mã thông báo vào git.
- **Dùng tự động làm mới mã thông báo** cho các bot chạy lâu dài.
- **Dùng danh sách cho phép ID người dùng** thay vì tên người dùng để kiểm soát truy cập.
- **Giám sát nhật ký** để theo dõi sự kiện làm mới mã thông báo và trạng thái kết nối.
- **Giới hạn phạm vi mã thông báo ở mức tối thiểu** — Chỉ yêu cầu `chat:read` và `chat:write`.
- **Nếu bị kẹt**: Khởi động lại Gateway sau khi xác nhận không có tiến trình nào khác sở hữu phiên.

## Giới hạn

- **500 ký tự** cho mỗi tin nhắn (tự động chia đoạn ở ranh giới từ).
- Markdown bị loại bỏ trước khi chia đoạn.
- Không giới hạn tốc độ (dùng giới hạn tốc độ tích hợp của Twitch).

## Liên quan

- [Định tuyến kênh](/vi/channels/channel-routing) — định tuyến phiên cho tin nhắn
- [Tổng quan về kênh](/vi/channels) — tất cả các kênh được hỗ trợ
- [Nhóm](/vi/channels/groups) — hành vi trò chuyện nhóm và kiểm soát @mention
- [Ghép nối](/vi/channels/pairing) — xác thực DM và luồng ghép nối
- [Bảo mật](/vi/gateway/security) — mô hình truy cập và gia cố