OpenClaw 中文教程网

外观

第三章：平台与渠道

约 1748 字大约 6 分钟

本章介绍 OpenClaw 支持的所有平台和消息渠道，以及如何配置 Telegram、WhatsApp 等主流平台，还有 Web 控制界面的使用。

3.1 支持的操作系统平台

平台支持状态说明
macOS✅ 完整支持菜单栏伴侣应用 + Gateway
Linux✅ 完整支持Gateway 完整支持，推荐无头服务器
Windows⚠️ WSL2通过 WSL2 运行 Gateway；原生应用开发中
iOS✅ 节点应用作为远程节点，支持 Canvas
Android✅ 节点应用作为远程节点，支持 Canvas、摄像头

运行时建议：推荐使用 Node.js，不推荐 Bun（WhatsApp/Telegram 有已知问题）。

安装 Gateway 服务（开机自启）

# 推荐：向导方式
openclaw onboard --install-daemon

# 直接安装
openclaw gateway install

# 诊断修复
openclaw doctor
  • macOS：创建 LaunchAgent（ai.openclaw.gateway）
  • Linux/WSL2：创建 systemd user service

云端/VPS 托管

OpenClaw 支持多种云平台部署：

  • Fly.io：详见官方文档 /install/fly
  • Hetzner（Docker）：详见 /install/hetzner
  • GCP Compute Engine：详见 /install/gcp

3.2 支持的消息渠道

OpenClaw 支持几乎所有主流聊天平台，多个渠道可以同时运行：

内置渠道（无需插件）

渠道接入方式特点
WhatsAppBaileys（模拟 Web）最流行，需 QR 扫码配对
TelegramgrammY Bot API配置最简单，推荐入门首选
Discorddiscord.js Bot API支持服务器、频道、私信
IRC原生 IRC经典 IRC，支持频道和私信
SlackBolt SDK工作区应用
Signalsignal-cli注重隐私
BlueBubblesREST API推荐的 iMessage 方案
iMessage（旧版）imsg CLI已废弃，建议用 BlueBubbles
WebChatGateway WebSocket内置浏览器聊天界面

插件渠道（需单独安装）

渠道说明
MattermostBot API + WebSocket
Feishu/飞书飞书/Lark bot，WebSocket
Google ChatHTTP webhook
Microsoft TeamsBot Framework
LINELINE Messaging API
MatrixMatrix 协议
Zalo越南主流社交平台
TwitchTwitch 聊天 IRC
Nostr去中心化私信

选择渠道的建议

  • 最快配置：Telegram（只需 Bot Token，无需扫码）
  • 最流行：WhatsApp（需要第二个手机号）
  • 企业/团队：Discord、Slack、Mattermost
  • 隐私优先：Signal

3.3 Telegram 配置详解

Telegram 是最推荐的入门渠道，配置简单，功能完整。

快速配置步骤

第一步：创建 Telegram Bot

  1. 在 Telegram 中搜索并打开 @BotFather（注意：用户名必须完全匹配）
  2. 发送 /newbot 命令
  3. 按提示输入 Bot 名称和用户名
  4. 保存生成的 Bot Token（格式：123456789:ABCdef...）

第二步：获取你的 Telegram ID

方式一（最安全）：

  1. 向你的 Bot 发送任意消息
  2. 运行 openclaw logs --follow
  3. 在日志中找到 from.id 字段

方式二：访问 https://api.telegram.org/bot<你的Token>/getUpdates

方式三（不推荐）：发消息给 @userinfobot

第三步：写入配置

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdef...",
      "dmPolicy": "pairing",
      "groups": {
        "*": {"requireMention": true}
      }
    }
  }
}

也可以用环境变量：TELEGRAM_BOT_TOKEN=你的Token

第四步：启动并审批首次连接

# 启动网关
openclaw gateway

# 查看等待配对的请求
openclaw pairing list telegram

# 审批（CODE 来自日志）
openclaw pairing approve telegram <CODE>

注意：配对码 1 小时后过期。

Telegram 访问控制

私信（DM）策略

通过 dmPolicy 控制谁能与 Bot 私信：

策略说明
pairing（默认）新用户需通过配对审批
allowlist仅 allowFrom 列表中的用户
open任何人（allowFrom 需包含 "*"）
disabled关闭私信
{
  "channels": {
    "telegram": {
      "dmPolicy": "allowlist",
      "allowFrom": ["123456789", "987654321"]
    }
  }
}

群组策略

{
  "channels": {
    "telegram": {
      "groupPolicy": "allowlist",
      "groups": {
        "-1001234567890": {
          "groupPolicy": "open",
          "requireMention": false
        }
      }
    }
  }
}

在群组中 @提及机器人

{
  "channels": {
    "telegram": {
      "groups": {
        "*": {"requireMention": true}
      }
    }
  }
}

Telegram 功能特性

流式输出（实时预览）

{
  "channels": {
    "telegram": {
      "streaming": "partial"
    }
  }
}
值效果
off（默认）等待完成后一次性发送
partial实时编辑消息，边生成边更新
block分块发送
progress等同于 partial

自定义命令菜单

{
  "channels": {
    "telegram": {
      "customCommands": [
        {"command": "backup", "description": "Git 备份"},
        {"command": "generate", "description": "生成图片"}
      ]
    }
  }
}

隐私模式设置

重要：Telegram Bot 默认开启隐私模式，只能看到 @提及自己的消息。

若需要 Bot 看到群里所有消息：

  • 方式一：在 BotFather 中发送 /setprivacy → 选择 Bot → 选 Disable
  • 方式二：将 Bot 设为群管理员
  • 设置后需将 Bot 从群组移除再重新添加

3.4 WhatsApp 配置详解

双手机方案（强烈推荐）

为什么需要第二个手机号？

如果用个人 WhatsApp 连接 OpenClaw，你收到的每条消息都会触发 AI 响应。建议使用：

  • 第二张 SIM 卡
  • eSIM
  • 预付费手机号

配置步骤

第一步：QR 扫码配对

# 触发 QR 码（用助手手机扫码）
openclaw channels login

第二步：安全配置

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123"],
      "groups": {
        "*": {"requireMention": true}
      }
    }
  }
}

安全警告：必须配置 allowFrom！否则任何人都能触发你的 AI 助手。

第三步：启动网关

openclaw gateway --port 18789

多账号配置

# 分别配对各账号
openclaw channels login --channel whatsapp --account personal
openclaw channels login --channel whatsapp --account biz
{
  "channels": {
    "whatsapp": {
      "accounts": {
        "personal": {},
        "biz": {}
      }
    }
  }
}

3.5 Discord 配置

创建 Discord Bot

  1. 访问 Discord Developer Portal
  2. 创建新应用 → 添加 Bot
  3. 开启 Message Content Intent（重要！）
  4. 复制 Bot Token
  5. 生成邀请链接，邀请 Bot 到你的服务器

基础配置

{
  "channels": {
    "discord": {
      "token": "YOUR_DISCORD_BOT_TOKEN",
      "groupPolicy": "allowlist",
      "guilds": {
        "你的服务器ID": {
          "channels": {
            "你的频道ID": {"allow": true, "requireMention": false}
          }
        }
      }
    }
  }
}

3.6 Web 控制界面（Control UI）

OpenClaw 内置一个基于浏览器的控制台，通过 Gateway 的 WebSocket 提供服务。

访问地址

http://127.0.0.1:18789/    （本地访问）
https://<tailscale-主机名>/  （Tailscale 远程访问）

功能列表

功能说明
聊天直接与 AI 对话，实时查看工具调用
渠道状态WhatsApp/Telegram/Discord 状态、QR 登录
会话管理列出/切换会话，调整思考深度
定时任务创建/编辑/运行 Cron 任务
技能（Skills）启用/禁用/安装技能
节点查看已连接的节点设备
配置编辑可视化编辑 openclaw.json
日志实时查看 Gateway 日志
调试健康检查、模型列表、手动 RPC
更新一键更新并重启

首次连接（设备配对）

首次从新浏览器访问 Control UI，需要一次性配对：

# 查看等待配对的设备
openclaw devices list

# 审批设备
openclaw devices approve <requestId>

# 撤销设备授权
openclaw devices revoke --device <id> --role <role>

注意：127.0.0.1 本地连接会自动审批，远程连接需手动审批。

远程访问（推荐 Tailscale）

# 使用 Tailscale Serve（最安全）
openclaw gateway --tailscale serve

通过 Tailscale 访问时，Gateway 自动使用 HTTPS，并通过 Tailscale 身份验证。

聊天界面操作

操作命令
停止当前运行点击「Stop」按钮 或 输入 /stop
中止当前会话所有运行chat.abort + sessionKey

3.7 媒体支持

接收媒体

入站附件（图片/音频/文档）可通过模板变量在提示词中使用：

变量说明
{{MediaPath}}本地临时文件路径
{{MediaUrl}}伪 URL
{{Transcript}}音频转文字结果（需启用）

发送媒体

AI 在回复中可以发送媒体文件，格式为在回复中包含：

Here's the screenshot.
MEDIA:https://example.com/screenshot.png

或本地文件路径：

MEDIA:/path/to/local/file.png

3.8 下一步

内容整理来自OpenClaw官网及自有笔记
Copyright © 2026 OpenClaw 中文教程网