Telegram 接入

Telegram 是 OpenClaw 中配置最简单、最推荐的频道。

创建 Bot

1. 打开 Telegram，搜索 @BotFather
2. 发送 /newbot 命令
3. 输入 Bot 名称（显示名，如 My AI Assistant）
4. 输入 Bot 用户名（必须以 bot 结尾，如 myai_bot）
5. 复制获得的 Token（格式：1234567890:ABCdef...）

配置 OpenClaw

# 方式一：命令行
openclaw config set channels.telegram.token "YOUR_BOT_TOKEN"
openclaw config set channels.telegram.enabled true

# 方式二：编辑配置文件 ~/.openclaw/config.json

配置文件示例：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "1234567890:ABCdefGHI...",
      "allowedUsers": ["your_username"],
      "dmPairingPolicy": "whitelist"
    }
  }
}

启动与测试

# 重启服务使配置生效
openclaw restart

# 检查频道状态
openclaw channels list

打开 Telegram，找到你的 Bot，发送 /start，成功后 AI 会回复。

安全配置

白名单限制

只允许指定用户使用 Bot：

{
  "channels": {
    "telegram": {
      "allowedUsers": ["username1", "username2"],
      "dmPairingPolicy": "whitelist"
    }
  }
}

群组使用

在群组中使用时，Bot 需要被添加到群组，且通过 @bot_username 提及才会响应：

{
  "channels": {
    "telegram": {
      "groupMention": true,
      "allowedGroups": ["-100123456789"]
    }
  }
}

常用功能

命令	说明
/start	初始化会话
/new	开启新对话（清除上下文）
/history	查看对话历史
/tools	查看可用工具列表
/help	显示帮助信息