Channels

状态： 可选插件（默认禁用）。 Nostr 是一个去中心化的社交网络协议。此渠道使 OpenClaw 能够通过 NIP-04 接收和回复加密私信（DMs）。 安装（按需） 新手引导（推荐） 新手引导向导（openclaw onboard）和 openclaw channels add 会列出可选的渠道插件。 选择 Nostr 会提示你按需安装插件。 安装默认值： Dev 渠道 + git checkout 可用： 使用本地插件路径。 Stable/Beta： 从 npm 下载。 你可以随时在提示中覆盖选择。 手动安装 openclaw plugins install @openclaw/nostr 使用本地 checkout（开发工作流）： openclaw plugins install --link <path-to-openclaw>/extensions/nostr 安装或启用插件后重启 Gateway 网关。 快速设置 生成 Nostr 密钥对（如需要）： # 使用 nak nak key generate 添加到配置： { "channels": { "nostr": { "privateKey": "${NOSTR_PRIVATE_KEY}" } } } 导出密钥： export NOSTR_PRIVATE_KEY="nsec1..." 重启 Gateway 网关。 配置参考 键 类型 默认值 描述 privateKey string 必填 nsec 或十六进制格式的私钥 relays string[] ['wss://relay.damus.io', 'wss://nos.lol'] 中继 URL（WebSocket） dmPolicy string pairing 私信访问策略 allowFrom string[] [] 允许的发送者公钥 enabled boolean true 启用/禁用渠道 name string - 显示名称 profile object - NIP-01 个人资料元数据 个人资料元数据 个人资料数据作为 NIP-01 kind:0 事件发布。你可以从控制界面（Channels -> Nostr -> Profile）管理它，或直接在配置中设置。 ...

状态：外部 CLI 集成。Gateway 网关通过 HTTP JSON-RPC + SSE 与 signal-cli 通信。 快速设置（初学者） 为 bot 使用单独的 Signal 号码（推荐）。 安装 signal-cli（需要 Java）。 链接 bot 设备并启动守护进程： signal-cli link -n "OpenClaw" 配置 OpenClaw 并启动 Gateway 网关。 最小配置： { channels: { signal: { enabled: true, account: "+15551234567", cliPath: "signal-cli", dmPolicy: "pairing", allowFrom: ["+15557654321"], }, }, } 它是什么 通过 signal-cli 的 Signal 渠道（非嵌入式 libsignal）。 确定性路由：回复始终返回到 Signal。 私信共享智能体的主会话；群组是隔离的（agent:<agentId>:signal:group:<groupId>）。 配置写入 默认情况下，Signal 允许写入由 /config set|unset 触发的配置更新（需要 commands.config: true）。 禁用方式： ...

Socket 模式（默认） 快速设置（新手） 创建一个 Slack 应用并启用 Socket Mode。 创建一个 App Token（xapp-...）和 Bot Token（xoxb-...）。 为 OpenClaw 设置令牌并启动 Gateway 网关。 最小配置： { channels: { slack: { enabled: true, appToken: "xapp-...", botToken: "xoxb-...", }, }, } 设置 在 https://api.slack.com/apps 创建一个 Slack 应用（从头开始）。 Socket Mode → 开启。然后前往 Basic Information → App-Level Tokens → Generate Token and Scopes，添加 connections:write 权限范围。复制 App Token（xapp-...）。 OAuth & Permissions → 添加 bot token 权限范围（使用下面的 manifest）。点击 Install to Workspace。复制 Bot User OAuth Token（xoxb-...）。 可选：OAuth & Permissions → 添加 User Token Scopes（参见下面的只读列表）。重新安装应用并复制 User OAuth Token（xoxp-...）。 Event Subscriptions → 启用事件并订阅： message.*（包括编辑/删除/线程广播） app_mention reaction_added、reaction_removed member_joined_channel、member_left_channel channel_rename pin_added、pin_removed 邀请机器人加入你希望它读取的频道。 Slash Commands → 如果你使用 channels.slack.slashCommand，创建 /openclaw。如果启用原生命令，为每个内置命令添加一个斜杠命令（名称与 /help 相同）。除非你设置 channels.slack.commands.native: true，否则 Slack 默认关闭原生命令（全局 commands.native 是 "auto"，对 Slack 保持关闭）。 App Home → 启用 Messages Tab 以便用户可以私信机器人。 使用下面的 manifest 以保持权限范围和事件同步。 ...

状态：通过 grammY 支持机器人私信和群组，已可用于生产环境。默认使用长轮询；webhook 可选。 快速设置（入门） 通过 @BotFather（直达链接）创建机器人。确认用户名确实是 @BotFather，然后复制 token。 设置 token： 环境变量：TELEGRAM_BOT_TOKEN=... 或配置：channels.telegram.botToken: "..."。 如果两者都设置了，配置优先（环境变量回退仅适用于默认账户）。 启动 Gateway 网关。 私信访问默认使用配对模式；首次联系时需要批准配对码。 最小配置： { channels: { telegram: { enabled: true, botToken: "123:abc", dmPolicy: "pairing", }, }, } 这是什么 一个由 Gateway 网关拥有的 Telegram Bot API 渠道。 确定性路由：回复返回到 Telegram；模型不会选择渠道。 私信共享智能体的主会话；群组保持隔离（agent:<agentId>:telegram:group:<chatId>）。 设置（快速路径） 1）创建机器人 token（BotFather） 打开 Telegram 并与 @BotFather（直达链接）对话。确认用户名确实是 @BotFather。 运行 /newbot，然后按照提示操作（名称 + 以 bot 结尾的用户名）。 复制 token 并安全保存。 可选的 BotFather 设置： /setjoingroups — 允许/拒绝将机器人添加到群组。 /setprivacy — 控制机器人是否可以看到所有群组消息。 2）配置 token（环境变量或配置文件） 示例： ...

Tlon 是一个基于 Urbit 构建的去中心化即时通讯工具。OpenClaw 连接到你的 Urbit ship，可以响应私信和群聊消息。群组回复默认需要 @ 提及，并可通过允许列表进一步限制。 状态：通过插件支持。支持私信、群组提及、话题回复和纯文本媒体回退（URL 附加到说明文字）。不支持表情回应、投票和原生媒体上传。 需要插件 Tlon 作为插件提供，不包含在核心安装中。 通过 CLI 安装（npm 仓库）： openclaw plugins install @openclaw/tlon 本地检出（从 git 仓库运行时）： openclaw plugins install ./extensions/tlon 详情：插件 设置 安装 Tlon 插件。 获取你的 ship URL 和登录代码。 配置 channels.tlon。 重启 Gateway 网关。 私信机器人或在群组频道中提及它。 最小配置（单账户）： { channels: { tlon: { enabled: true, ship: "~sampel-palnet", url: "https://your-ship-host", code: "lidlut-tabwed-pillex-ridrup", }, }, } 群组频道 默认启用自动发现。你也可以手动固定频道： { channels: { tlon: { groupChannels: ["chat/~host-ship/general", "chat/~host-ship/support"], }, }, } 禁用自动发现： ...

通过 IRC 连接支持 Twitch 聊天。OpenClaw 以 Twitch 用户（机器人账户）身份连接，在频道中接收和发送消息。 需要插件 Twitch 作为插件发布，未与核心安装捆绑。 通过 CLI 安装（npm 注册表）： openclaw plugins install @openclaw/twitch 本地检出（从 git 仓库运行时）： openclaw plugins install ./extensions/twitch 详情：插件 快速设置（新手） 为机器人创建一个专用的 Twitch 账户（或使用现有账户）。 生成凭证：Twitch Token Generator 选择 Bot Token 确认已选择 chat:read 和 chat:write 权限范围 复制 Client ID 和 Access Token 查找你的 Twitch 用户 ID：https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/ 配置令牌： 环境变量：OPENCLAW_TWITCH_ACCESS_TOKEN=...（仅限默认账户） 或配置：channels.twitch.accessToken 如果两者都设置，配置优先（环境变量回退仅适用于默认账户）。 启动 Gateway 网关。 ⚠️ 重要： 添加访问控制（allowFrom 或 allowedRoles）以防止未授权用户触发机器人。requireMention 默认为 true。 最小配置： { channels: { twitch: { enabled: true, username: "openclaw", // 机器人的 Twitch 账户 accessToken: "oauth:abc123...", // OAuth Access Token（或使用 OPENCLAW_TWITCH_ACCESS_TOKEN 环境变量） clientId: "xyz789...", // Token Generator 中的 Client ID channel: "vevisk", // 要加入的 Twitch 频道聊天（必填） allowFrom: ["123456789"], // （推荐）仅限你的 Twitch 用户 ID - 从 https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/ 获取 }, }, } 它是什么 由 Gateway 网关拥有的 Twitch 渠道。 确定性路由：回复总是返回到 Twitch。 每个账户映射到一个隔离的会话键 agent:<agentId>:twitch:<accountName>。 username 是机器人账户（进行身份验证的账户），channel 是要加入的聊天室。 设置（详细） 生成凭证 使用 Twitch Token Generator： ...

状态：仅支持通过 Baileys 的 WhatsApp Web。Gateway 网关拥有会话。 快速设置（新手） 如果可能，使用单独的手机号码（推荐）。 在 ~/.openclaw/openclaw.json 中配置 WhatsApp。 运行 openclaw channels login 扫描二维码（关联设备）。 启动 Gateway 网关。 最小配置： { channels: { whatsapp: { dmPolicy: "allowlist", allowFrom: ["+15551234567"], }, }, } 目标 在一个 Gateway 网关进程中支持多个 WhatsApp 账户（多账户）。 确定性路由：回复返回到 WhatsApp，无模型路由。 模型能看到足够的上下文来理解引用回复。 配置写入 默认情况下，WhatsApp 允许写入由 /config set|unset 触发的配置更新（需要 commands.config: true）。 禁用方式： { channels: { whatsapp: { configWrites: false } }, } 架构（谁拥有什么） Gateway 网关拥有 Baileys socket 和收件箱循环。 CLI / macOS 应用与 Gateway 网关通信；不直接使用 Baileys。 发送出站消息需要活跃的监听器；否则发送会快速失败。 获取手机号码（两种模式） WhatsApp 需要真实手机号码进行验证。VoIP 和虚拟号码通常会被封锁。在 WhatsApp 上运行 OpenClaw 有两种支持的方式： ...

状态：实验性。仅支持私信；根据 Zalo 文档，群组即将推出。 需要插件 Zalo 以插件形式提供，不包含在核心安装中。 通过 CLI 安装：openclaw plugins install @openclaw/zalo 或在新手引导期间选择 Zalo 并确认安装提示 详情：插件 快速设置（初学者） 安装 Zalo 插件： 从源代码检出：openclaw plugins install ./extensions/zalo 从 npm（如果已发布）：openclaw plugins install @openclaw/zalo 或在新手引导中选择 Zalo 并确认安装提示 设置 token： 环境变量：ZALO_BOT_TOKEN=... 或配置：channels.zalo.botToken: "..."。 重启 Gateway 网关（或完成新手引导）。 私信访问默认为配对模式；首次联系时批准配对码。 最小配置： { channels: { zalo: { enabled: true, botToken: "12345689:abc-xyz", dmPolicy: "pairing", }, }, } 它是什么 Zalo 是一款专注于越南市场的即时通讯应用；其 Bot API 让 Gateway 网关可以运行一个用于一对一对话的 bot。 它非常适合需要确定性路由回 Zalo 的支持或通知场景。 由 Gateway 网关拥有的 Zalo Bot API 渠道。 确定性路由：回复返回到 Zalo；模型不会选择渠道。 私信共享智能体的主会话。 群组尚不支持（Zalo 文档标注"即将推出"）。 设置（快速路径） 1）创建 bot token（Zalo Bot 平台） 前往 https://bot.zaloplatforms.com 并登录。 创建新 bot 并配置其设置。 复制 bot token（格式：12345689:abc-xyz）。 2）配置 token（环境变量或配置） 示例： ...

状态：实验性。此集成通过 zca-cli 自动化个人 Zalo 账户。 **警告：**这是一个非官方集成，可能导致账户被暂停/封禁。使用风险自负。 需要插件 Zalo Personal 作为插件提供，不包含在核心安装中。 通过 CLI 安装：openclaw plugins install @openclaw/zalouser 或从源码检出安装：openclaw plugins install ./extensions/zalouser 详情：插件 前置条件：zca-cli Gateway 网关机器必须在 PATH 中有可用的 zca 二进制文件。 验证：zca --version 如果缺失，请安装 zca-cli（参见 extensions/zalouser/README.md 或上游 zca-cli 文档）。 快速设置（新手） 安装插件（见上文）。 登录（QR，在 Gateway 网关机器上）： openclaw channels login --channel zalouser 用 Zalo 手机应用扫描终端中的二维码。 启用渠道： { channels: { zalouser: { enabled: true, dmPolicy: "pairing", }, }, } 重启 Gateway 网关（或完成新手引导）。 私信访问默认为配对模式；首次联系时批准配对码。 这是什么 使用 zca listen 接收入站消息。 使用 zca msg ... 发送回复（文本/媒体/链接）。 专为"个人账户"使用场景设计，适用于 Zalo Bot API 不可用的情况。 命名 渠道 ID 为 zalouser，以明确表示这是自动化个人 Zalo 用户账户（非官方）。我们保留 zalo 用于未来可能的官方 Zalo API 集成。 ...

状态： 实验性功能 版本： 于 2026.1.9 版本新增 概述 广播群组允许多个智能体同时处理并响应同一条消息。这使你能够在单个 WhatsApp 群组或私信中创建协同工作的专业智能体团队——全部使用同一个手机号码。 当前范围：仅限 WhatsApp（web 渠道）。 广播群组在渠道白名单和群组激活规则之后进行评估。在 WhatsApp 群组中，这意味着广播会在 OpenClaw 正常回复时发生（例如：被提及时，具体取决于你的群组设置）。 使用场景 1. 专业智能体团队 部署多个具有原子化、专注职责的智能体： Group: "Development Team" Agents: - CodeReviewer (reviews code snippets) - DocumentationBot (generates docs) - SecurityAuditor (checks for vulnerabilities) - TestGenerator (suggests test cases) 每个智能体处理相同的消息并提供其专业视角。 2. 多语言支持 Group: "International Support" Agents: - Agent_EN (responds in English) - Agent_DE (responds in German) - Agent_ES (responds in Spanish) 3. 质量保证工作流 Group: "Customer Support" Agents: - SupportAgent (provides answer) - QAAgent (reviews quality, only responds if issues found) 4. 任务自动化 Group: "Project Management" Agents: - TaskTracker (updates task database) - TimeLogger (logs time spent) - ReportGenerator (creates summaries) 配置 基本设置 添加一个顶层 broadcast 部分（与 bindings 同级）。键为 WhatsApp peer id： ...