OpenClaw 中文文档 — 社区平台接入

本文覆盖 OpenClaw 支持的社区和开放协议渠道：Matrix、IRC、LINE、Nostr、Twitch、Tlon 和 Zalo。这些渠道均以插件形式提供，面向特定的用户群体和场景。

渠道总览

渠道	协议/框架	连接方式	主要功能	目标场景
Matrix	Matrix 协议	用户登录 homeserver	E2EE、线程、媒体、表情、投票	去中心化社区
IRC	IRC	TCP/TLS	频道、私信	开源社区
LINE	Messaging API	Webhook	Flex 消息、模板、快速回复	日本/台湾市场
Nostr	NIP-04	中继连接	加密私信	Web3/去中心化
Twitch	IRC	Bot 连接	频道聊天	直播互动
Tlon	Urbit	飞船连接	私信、群组、线程、富文本	Urbit 生态
Zalo	Bot API / QR	Webhook / WebSocket	私信、群聊	越南市场

所有渠道安装方式统一：openclaw plugins install @openclaw/<name>。

Matrix

架构特点

Matrix 是一个开放的去中心化协议，OpenClaw 作为 Matrix 用户连接到 homeserver。从架构层面来看，这意味着 OpenClaw 不依赖任何特定的 Matrix 服务商——可以连接 matrix.org、自建 homeserver 或 Beeper。

配置

{
  channels: {
    matrix: {
      enabled: true,
      homeserverUrl: "https://matrix.example.org",
      accessToken: "syt_xxx",
      dmPolicy: "pairing",
    },
  },
}

也支持用户名+密码登录（OpenClaw 自动获取并持久化 access token）。

功能矩阵

端到端加密支持（需加密模块）、线程回复、媒体（图片/文件/音频）、表情回应、投票（发送+接收）、位置。Beeper 客户端兼容（需启用加密）。

IRC

设计考量

IRC 是最早的聊天协议之一，协议本身没有认证机制——任何人都可以使用任何昵称连接。这对访问控制提出了额外要求。

OpenClaw 的 IRC 渠道采用 nick!user@host 格式的白名单，而非纯昵称。纯昵称匹配需要显式启用 dangerouslyAllowNameMatching: true——名称本身已表明这不是推荐做法。

配置

{
  "channels": {
    "irc": {
      "enabled": true,
      "host": "irc.libera.chat",
      "port": 6697,
      "tls": true,
      "nick": "openclaw-bot",
      "channels": ["#openclaw"]
    }
  }
}

值得注意的是，TLS 不是默认启用的。在生产环境中应始终使用 TLS——IRC 默认是明文传输。

LINE

市场定位

LINE 在日本市场份额超过 90%，在台湾也占有重要地位。对于面向这些市场的产品，LINE 是必选渠道。

配置

{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_TOKEN",
      channelSecret: "LINE_SECRET",
      dmPolicy: "pairing",
    },
  },
}

需要 HTTPS 公网 URL 作为 webhook。LINE 签名验证基于请求体的 HMAC，OpenClaw 在验证前应用预认证请求体大小限制。

特色功能

LINE 的 Flex 消息（可自定义布局的富文本卡片）和模板消息是其区别于其他渠道的特色。不支持表情回应和线程。

Nostr

去中心化设计

Nostr 通过 NIP-04 加密私信协议接入。需要一个 Nostr 密钥对（nsec/npub）。

{
  "channels": {
    "nostr": {
      "privateKey": "${NOSTR_PRIVATE_KEY}"
    }
  }
}

Nostr 的去中心化特性意味着没有中心服务器，消息通过多个中继（relay）传播。

Twitch

直播场景

通过 IRC 协议连接 Twitch 聊天。需要 Twitch Bot 账户的凭据。

{
  channels: {
    twitch: {
      enabled: true,
      clientId: "xxx",
      accessToken: "xxx",
      userId: "12345",
      channels: ["#your-channel"],
    },
  },
}

适合直播间 AI 互动和聊天管理。

Tlon

基于 Urbit 的去中心化即时通讯。支持私信、群组、线程回复、富文本格式和图片上传。需要连接到 Urbit 飞船。

Zalo

越南市场最流行的即时通讯应用。提供两个渠道：

• Zalo Bot API（@openclaw/zalo）：通过 Bot Token 接入
• Zalo Personal（@openclaw/zalouser）：通过 QR 登录个人账号

共同模式

尽管这些渠道各有特色，但在 OpenClaw 中它们共享相同的配置模式：

• dmPolicy：私信策略（pairing/allowlist/open/disabled）
• groupPolicy：群组策略
• allowFrom / groupAllowFrom：白名单
• 配对机制：未知发送者触发配对码

这种统一的配置模型降低了管理多渠道的认知负担——学会一个渠道的配置模式，其他渠道的配置逻辑基本相同。

小结

社区和开放协议渠道覆盖了从经典 IRC 到 Web3 去中心化的广泛场景。虽然用户量不如主流渠道，但在特定市场（LINE 之于日本/台湾、Zalo 之于越南）或特定社区（Matrix、IRC 之于开源/技术社区）中不可替代。

本文是渠道篇的第六篇。下一篇覆盖群组消息与渠道路由的高级配置。

---

完整中文文档：OpenClaw 中文文档

GitHub 仓库：openclaw/openclaw