Documentation Index
Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt
Use this file to discover all available pages before exploring further.
公式の Telegram Bot API を通じて CowAgent を接続します。1 対 1 チャットおよびグループチャット(@メンションまたはボットへの返信で起動)に対応。Long Polling 方式のため公開 IP は不要で、すぐに利用できます。
1. 接続手順
ステップ 1: BotFather で Bot を作成
- Telegram で公式アカウント @BotFather を開きます。
/newbotを送り、案内に従って入力します:- Bot 名(表示名、例:
My CowAgent Bot) - Bot ユーザー名(
botで終わる必要があります、例:my_cowagent_bot)
- Bot 名(表示名、例:
- 作成完了後、BotFather から HTTP API Token(例:
123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ)が返されます。大切に保管してください。
ステップ 2:(グループ利用時)Privacy Mode を無効化
1 対 1 チャットのみ利用する場合はスキップ可能です。Telegram Bot は既定で Privacy Mode が有効で、グループ内では@bot 接尾辞付きのコマンド(例: /start@your_bot)と、Bot メッセージへの返信のみ受信できます。通常の @bot こんにちは のようなテキストメッセージは届きません。そのままだとグループで反応しないので、必要に応じて以下を設定してください。
@BotFather に対して:
/setprivacyを送信- 作成した Bot を選択
Disableを選択
設定後もグループで反応しない場合は、Bot を一度グループから外して再度追加してみてください。
ステップ 3: CowAgent に接続
- Web コンソール(推奨)
- 設定ファイル
Web コンソール(既定
http://127.0.0.1:9899)を開き、チャネル メニュー → チャネルを追加 → Telegram を選択し、Bot Token を貼り付けて接続をクリックします。2. 機能
| 機能 | 対応状況 |
|---|---|
| 1 対 1 チャット | ✅ |
| グループチャット(@bot / Bot への返信) | ✅ |
| テキストメッセージ | ✅ 送受信 |
| 画像メッセージ | ✅ 送受信 |
| 音声メッセージ | ✅ 送受信(OGG/Opus) |
| 動画メッセージ | ✅ 送受信 |
| ファイルメッセージ | ✅ 送受信(PDF / Word / Excel など) |
| コマンドメニュー | ✅ Web コンソールの slash コマンドと一致 |
コマンドメニュー
起動時に BotFather へコマンドメニューを自動登録します。Telegram の入力欄で/ を入力するとサジェストが表示されます:
| コマンド | 説明 |
|---|---|
/help | コマンドヘルプを表示 |
/status | 実行ステータスを確認 |
/context | 対話コンテキストを表示(/context clear でクリア) |
/skill | スキル管理(/skill list、/skill install など) |
/memory | 記憶管理(/memory dream) |
/knowledge | ナレッジベース管理(/knowledge list / on / off) |
/config | 現在の設定を表示 |
/cancel | 実行中の Agent タスクを中断 |
/logs | 最近のログを表示 |
/version | バージョンを表示 |
Telegram のコマンドメニューはトップレベルのコマンドのみ表示されます。サブコマンドはスペース区切りで入力します(例:
/skill list、/context clear)。3. 使い方
接続が完了したら:- 1 対 1 チャット: Telegram で Bot のユーザー名(例:
@my_cowagent_bot)を検索し、Startをタップして会話を開始します。 - グループチャット: Bot をグループに追加し、
@bot こんにちはまたは Bot のメッセージに返信 することで起動します。グループで反応しない場合は ステップ 2 の Privacy Mode 設定を確認してください。
