picoclaw/docs/channels/telegram/README.ja.md
dj-oyu 31376d2961 merge: sync upstream/main
Merge upstream/main (c0bb8d6) into fork. Key upstream changes:
- SSE streaming support (Telegram sendMessageDraft, channel StreamDelegate)
- Pico client outbound WebSocket channel
- Smarter heartbeat task detection (heartbeatHasUserTasks)
- Separate tool-limit vs empty-response messages
- TUI launcher refactoring with cyberpunk theme
- Android fallback DNS resolver
- Improved docs translations

Conflict resolution:
- Kept fork's channel-based StreamingProvider interface and ChatStream API
- Kept fork's buildHTTPRequest (superset of upstream's buildRequestBody)
- Merged upstream's streamActive tracking alongside fork's draft-based streaming
- Added upstream's parser_markdown_to_html.go for new Telegram streaming
- Resolved duplicate declarations (MessageDeleter, escapeHTML, DeleteMessage)
- Adopted upstream's resolveScopeKey prefix-gated behavior

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-22 09:23:04 +09:00

1.7 KiB
Raw Blame History

README に戻る

Telegram

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

設定

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

セットアップ手順

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