revx-telegram について
revx-telegramは、`revx`コマンドラインでTelegram通知接続を設定・管理するスキルです。ボット認証情報の準備を案内し、モニターやグリッドボットの通知を有効にします。
主な機能
- 01トークンとチャットIDで接続を追加
- 02保存前のテストメッセージ送信
- 03接続の一覧表示・有効化・無効化・削除
- 04モニターとグリッドボットの通知配信
活用シーン
- 01モニターのアラートをTelegramに送信
- 02グリッドボットの稼働・約定・損益更新を受信
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/revx-telegramを入力して読み込まれたか確認します。
詳細
Telegram Connector（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 の 2 つです。どちらかが不足している場合は、以下の手順を案内してください。ユーザーが実行できるように、該当する手順をメッセージとして共有してください。ユーザーの Telegram アプリが必要なため、ツールを使ってこれらの手順を実行しようとしないでください。
セットアップガイド：ボットトークンとチャット ID の取得
Telegram の設定についてサポートが必要な場合は、以下の手順をユーザーに共有してください。
ステップ 1 — Telegram ボットを作成する（ボットトークンを取得）：
- Telegram を開きます（モバイルまたはデスクトップ）。
- @BotFather を検索して、チャットを開始します。
/newbotを送信します。- BotFather から 表示名（例："My RevX Alerts"）を尋ねられます。任意の名前を入力してください。
- BotFather から末尾が
botの ユーザー名（例：my_revx_alerts_bot）を尋ねられます。ユーザー名は一意である必要があります。 - BotFather からボットトークンが返信されます。形式は
123456789:ABCdefGHI-jklMNOpqrSTUvwxYZのようなものです。 - トークンをコピーして、ここに共有してください。
ステップ 2 — チャット ID を取得する：
- Telegram を開き、新しいボットを見つけます（先ほど作成したユーザー名で検索します）。
- ボットに任意のメッセージ（例："hello"）を送信します。
- ブラウザーで以下の URL を開きます。ステップ 1 で取得したトークンで
<YOUR_TOKEN>を置き換えてください。https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates - JSON レスポンスから
"chat":{"id": <number>}を探します。その数値がチャット ID です。 - 個人チャットでは通常、正の数（例：
123456789）、グループチャットでは負の数（例：-1001234567890）です。 - チャット 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 キーの設定と構成 |