设置您的第一个渠道

OpenClaw 支持多个聊天平台。在本教程中，我们将使用 Telegram，因为：

• 最容易设置（只需创建一个机器人）
• 无需电话号码
• 非常适合测试和学习
• 可在所有平台上运行

对于其他渠道：请参阅 WhatsApp、Discord、Slack、Signal、iMessage 等的渠道参考。

Telegram 使用机器人，这是可以通过编程控制的特殊账号。以下是创建方法：

步骤 2.1：打开 Telegram 并找到 BotFather

• 在手机或电脑上打开 Telegram 应用
• 搜索 @BotFather（官方 Telegram 机器人创建器）
• 开始与 BotFather 聊天
• 发送命令：/start

步骤 2.2：创建您的机器人

• 向 BotFather 发送：/newbot
• BotFather 会询问机器人的名称（这是显示名称，例如“我的 OpenClaw 助手”）
• BotFather 会询问用户名（必须以“bot”结尾，例如“myopenclawbot”）
• BotFather 会返回一个机器人令牌 - 复制此令牌（您在下一步中将需要它）

步骤 2.3：（可选）配置您的机器人

您可以使用 BotFather 命令自定义您的机器人：

• /setdescription - 设置机器人的功能描述
• /setabouttext - 设置机器人简介
• /setuserpic - 设置机器人个人资料图片

这些是可选的 - 您的机器人即使没有这些也能正常工作。

现在我们将您的 Telegram 机器人添加到 OpenClaw 的配置中。

步骤 3.1：打开配置文件

您的 OpenClaw 配置文件位于 ~/.openclaw/openclaw.json。在您喜欢的文本编辑器中打开它：

# On macOS/Linux:
nano ~/.openclaw/openclaw.json
# or
code ~/.openclaw/openclaw.json  # VS Code
# or
open ~/.openclaw/openclaw.json  # Default editor

步骤 3.2：添加 Telegram 配置

将 Telegram 渠道配置添加到您的文件中。如果您已经有配置文件，请添加 channels 部分：

{
  "agents": {
    "defaults": {
      "model": { "primary": "anthropic/claude-opus-4-5" }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN_HERE"
    }
  }
}

将 YOUR_BOT_TOKEN_HERE 替换为您从 BotFather 复制的令牌。

步骤 3.3：保存并重启 Gateway

保存配置后：

• 保存配置文件
• 重启您的 OpenClaw Gateway 以加载新配置

# If Gateway is running as a service:
openclaw gateway restart

# Or if running manually, stop and restart:
openclaw gateway --port 18789 --verbose

现在让我们验证一切是否正常！

步骤 4.1：在 Telegram 上找到您的机器人

• 打开 Telegram
• 通过机器人的用户名（您创建的那个，例如“myopenclawbot”）搜索您的机器人
• 开始与您的机器人聊天
• 发送 /start 初始化机器人

步骤 4.2：发送测试消息

向您的机器人发送一条简单的消息，例如：

• “你好！”
• “你能做什么？”
• “介绍一下你自己”

您的 OpenClaw 助手应该会做出回应！如果做到了，恭喜您 - 您的渠道已成功运行！ 🎉

机器人无响应

如果您的机器人没有响应：

• 检查 Gateway 是否正在运行：openclaw gateway status
• 验证令牌是否正确：检查配置文件中是否有拼写错误
• 检查 Gateway 日志：查找有关 Telegram 连接的错误消息
• 重启 Gateway：有时重启可以解决连接问题

“机器人令牌无效”错误

这通常意味着：

• 令牌复制不正确（检查是否有额外的空格）
• 令牌已重新生成（从 BotFather 获取新令牌）
• 配置文件存在语法错误（检查 JSON 格式）

机器人有响应但 Gateway 显示错误

如果机器人正常工作但您看到错误：

• 检查 Gateway 日志以查看具体的错误消息
• 验证您的 AI 模型配置是否正确
• 确保您有可用的 API 额度/配额

如需更多故障排除帮助，请参阅我们的故障排除指南。

现在您已经连接了一个渠道，接下来可以探索以下内容：

其他渠道

想要设置其他渠道？以下是其参考指南的快速链接：

• WhatsApp 设置 - 与您的 WhatsApp 账号进行二维码配对
• Discord 设置 - 创建 Discord 机器人并邀请至服务器
• 所有渠道 - 受支持的聊天平台完整列表

每个渠道都有自己的设置过程，但大体流程相似：创建/关联账号 → 获取凭据 → 配置 OpenClaw → 测试连接。