Telegram 全流程 (Archive)

Archived original-language source from the legacy CrabClaw docs. This page is intentionally not machine-translated.

本教程将带你从零开始接入 Telegram Bot，配置自动回复，并了解常用的高级功能。

前置条件

• Crab Claw 已安装并完成初始配置
• 拥有 Telegram 账号
• 至少配置了一个模型提供商（如 Anthropic、OpenAI）

第一步：创建 Bot

1. 在 Telegram 中找到 @BotFather（直达链接）
2. 发送 /newbot，按提示输入 Bot 名称和用户名（须以 bot 结尾）
3. 复制获得的 Bot Token（格式如 123456:ABC-DEF...）

可选的 BotFather 设置：

• /setjoingroups — 允许/禁止 Bot 被加入群组
• /setprivacy — 控制 Bot 是否能看到群组中所有消息

第二步：配置 Token

编辑 ~/.crabclaw/crabclaw.json：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456:ABC-DEF...",
      "dmPolicy": "pairing"
    }
  }
}

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456:ABC-DEF...",
      "dmPolicy": "pairing"
    }
  }
}

或通过环境变量：

export TELEGRAM_BOT_TOKEN="123456:ABC-DEF..."

export TELEGRAM_BOT_TOKEN="123456:ABC-DEF..."

第三步：启动并配对

1. 启动 Gateway: crabclaw gateway
2. 在 Telegram 中向你的 Bot 发送任意消息
3. Bot 会返回一个配对码
4. 在终端中确认配对: crabclaw channels approve telegram <CODE>

配对完成后，Bot 即可正常回复消息。

第四步：测试对话

在 Telegram 中向 Bot 发送消息，智能体会自动处理并回复。试试：

• "你好" — 测试基本对话
• "今天天气怎么样" — 测试网页搜索能力
• 发送一张图片 — 测试多模态识别

群组配置

要在群组中使用 Bot：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "...",
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "...",
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

• requireMention: true: 在群组中需要 @提及 Bot 才响应
• "*" 表示对所有群组生效，也可以用具体群组 ID

高级配置

Webhook 模式

默认使用长轮询，如需 Webhook：

{
  "channels": {
    "telegram": {
      "webhook": {
        "enabled": true,
        "url": "https://your-domain.com/hooks/telegram"
      }
    }
  }
}

{
  "channels": {
    "telegram": {
      "webhook": {
        "enabled": true,
        "url": "https://your-domain.com/hooks/telegram"
      }
    }
  }
}

多账号

支持配置多个 Telegram Bot：

{
  "channels": {
    "telegram": {
      "accounts": {
        "main": { "botToken": "...", "dmPolicy": "pairing" },
        "support": { "botToken": "...", "dmPolicy": "open" }
      }
    }
  }
}

{
  "channels": {
    "telegram": {
      "accounts": {
        "main": { "botToken": "...", "dmPolicy": "pairing" },
        "support": { "botToken": "...", "dmPolicy": "open" }
      }
    }
  }
}

DM 策略

常见问题

Bot 不回复消息？

• 检查 Token 是否正确
• 检查 Gateway 是否运行: crabclaw status
• 查看日志: crabclaw logs

群组中 Bot 不响应？

• 确认 BotFather 中 privacy 设置为 disabled
• 确认配置中 requireMention 的设置
• 确认 Bot 已被添加为群组管理员（如需读取所有消息）