Files
picoclaw/docs/channels/telegram/README.ja.md
T
Cytown 667fc85d54 refactor(config): make config.Channel to multiple instance support
add new field type to Channel struct
config.channels refactor to channel_list
update config version to 3
update the docs
2026-04-13 22:21:21 +08:00

2.5 KiB

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
    }
  }
}