revx-telegram

Telegram 连接器（revx connector telegram）

配置 Telegram 机器人集成，用于接收监控器和网格机器人发送的提醒通知。

需要身份验证。 运行这些命令前，请确保已安装并配置 revx。如果任何命令因身份验证问题失败，错误为 Auth not configured、No private key found、Authentication failed (401)、Invalid signature、insecure permissions，或缺少 ~/.config/revolut-x/ 中的密钥／配置文件，请立即调用 revx-auth 技能并自行应用修复。 不要中断用户并要求他们运行设置。只有需要用户亲自执行的步骤（粘贴 API 密钥、在 Revolut X 个人资料中注册公钥、选择密码短语）才升级给用户。修复后，重试原始命令。

---

添加连接

revx connector telegram add --token <bot-token> --chat-id <chat-id>
revx connector telegram add --token <token> --chat-id <id> --label prod --test

标志	说明
--token <token>	Telegram Bot API 令牌（必需）
--chat-id <id>	Telegram 聊天 ID（必需）
--label <name>	连接标签（默认值："default"）
--test	先发送测试消息，只有消息送达后才保存连接

Claude 的行为说明

当用户想要设置 Telegram 通知时，需要准备两项内容：机器人令牌和聊天 ID。如果缺少其中任何一项，请引导用户完成以下设置。将相关步骤作为用户可照做的说明发送给用户——不要尝试通过工具执行这些步骤，因为它们需要用户使用 Telegram 应用。

设置指南：获取机器人令牌和聊天 ID

用户需要帮助设置 Telegram 时，请向其发送以下说明：

第 1 步 — 创建 Telegram 机器人（获取机器人令牌）：

1. 打开 Telegram（移动版或桌面版）
2. 搜索 @BotFather 并开始聊天
3. 发送 /newbot
4. BotFather 会要求提供显示名称（例如："My RevX Alerts"）——输入任意名称
5. BotFather 会要求提供以 bot 结尾的用户名（例如：my_revx_alerts_bot）——该用户名必须唯一
6. BotFather 会回复你的机器人令牌，格式类似 123456789:ABCdefGHI-jklMNOpqrSTUvwxYZ
7. 复制令牌并在此处发给我

第 2 步 — 获取聊天 ID：

1. 打开 Telegram，找到你新创建的机器人（搜索刚创建的用户名）
2. 向机器人发送任意消息（例如："hello"）
3. 在浏览器中打开此 URL——将 <YOUR_TOKEN> 替换为第 1 步中的令牌：

   https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates
   

4. 在 JSON 响应中找到 "chat":{"id": <number>}——其中的数字就是你的聊天 ID
5. 个人聊天的 ID 通常为正数（例如：123456789），群聊的 ID 则为负数（例如：-1001234567890）
6. 复制聊天 ID 并在此处发给我

第 3 步 — 添加连接（由 Claude 执行）：

用户提供这两个值后，运行：

revx connector telegram add --token <bot-token> --chat-id <chat-id> --test

--test 标志会在保存前发送测试消息。只有消息送达后才会保存连接。如果失败，命令会以状态码 1 退出、说明原因且不保存任何内容，因此请修正令牌或聊天 ID 后重新运行。令牌格式必须类似 123456789:AA...，聊天 ID 格式必须类似 123456789、-1001234567890 或 @mychannel，否则同样不会保存任何内容。

故障排除：

• 出现 "chat not found" 或 getUpdates 响应为空——用户必须先向机器人发送一条消息，然后重试该 URL
• 出现 "Unauthorized"——令牌不正确，请让用户从 BotFather 重新复制
• 对于群聊：必须先将机器人添加为群成员，然后有人必须在群中发送一条消息，getUpdates 才会显示群聊 ID

---

管理连接

revx connector telegram list                       # List all connections
revx connector telegram test <connection-id>       # Send test message
revx connector telegram test <id> --message "Custom test"
revx connector telegram enable <connection-id>     # Enable connection
revx connector telegram disable <connection-id>    # Disable connection
revx connector telegram delete <connection-id>     # Delete connection

---

通知的工作方式

配置并启用 Telegram 连接后：

• 监控提醒（参见 revx-monitor 技能）会在触发时自动作为 Telegram 消息发送
• 网格机器人事件（参见 revx-strategy 技能）会在启动、关闭、成交和盈亏变化时发送通知

无需其他配置——活跃的监控器和网格机器人会自动检测已启用的 Telegram 连接。

---

相关技能

技能	用途
revx-monitor	设置价格/指标提醒，通过 Telegram 通知
revx-strategy	网格机器人通过 Telegram 发送交易通知
revx-auth	API 密钥设置与配置