picoclaw/docs/channels/telegram/README.ja.md

README に戻る

Telegram

Telegram チャンネルは、Telegram Bot API を使用したロングポーリングによるボットベースの通信を実装しています。テキストメッセージ、メディア添付ファイル（写真、音声、オーディオ、ドキュメント）、Groq Whisper による音声文字起こし、および組み込みコマンドハンドラーをサポートしています。

設定

{
  "channel_list": {
    "telegram": {
      "enabled": true,
      "type": "telegram",
      "token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
      "allow_from": ["123456789"],
      "proxy": "",
      "use_markdown_v2": false
    }
  }
}

フィールド	型	必須	説明
enabled	bool	はい	Telegram チャンネルを有効にするかどうか
token	string	はい	Telegram Bot API トークン
allow_from	array	いいえ	許可するユーザーIDのリスト。空の場合はすべてのユーザーを許可
proxy	string	いいえ	Telegram API への接続に使用するプロキシ URL (例: http://127.0.0.1:7890)
use_markdown_v2	bool	いいえ	Telegram MarkdownV2 フォーマットを有効にする

セットアップ手順

1. Telegram で @BotFather を検索する
2. /newbot コマンドを送信し、指示に従って新しいボットを作成する
3. HTTP API トークンを取得する
4. 設定ファイルにトークンを入力する
5. (任意) allow_from を設定して、対話を許可するユーザー ID を制限する（ID は @userinfobot で取得可能）

高度なフォーマット

use_markdown_v2: true を設定することで、增强されたフォーマットオプションを有効にできます。これにより、ボットは Telegram MarkdownV2 の全機能（ネストされたスタイル、スポイラー、カスタム固定幅ブロックなど）を利用できます。

{
  "channel_list": {
    "telegram": {
      "enabled": true,
      "type": "telegram",
      "token": "YOUR_BOT_TOKEN",
      "allow_from": ["YOUR_USER_ID"],
      "use_markdown_v2": true
    }
  }
}