ホーム チュートリアル カテゴリ Skills サイトについて
ZH EN JA KO
✈️

Telegram

コミュニケーション メッセージ・SNS連携

インストールコマンド

npx clawhub@latest install telegram

インストール手順

1
環境確認

Node.js 22以上とOpenClawがインストール済みであることを確認してください。ターミナルでopenclaw --versionを実行して確認できます。

2
インストール実行

上記のインストールコマンドをターミナルで実行します。ClawHubが自動的にTelegramを~/.openclaw/skills/ディレクトリにダウンロード・インストールします。

3
インストール確認

openclaw skills listを実行してインストール済みスキル一覧を確認し、Telegramが表示されていることを確かめてください。

4
パラメータ設定(任意)

下記の紹介にある設定手順に従い、~/.config/openclaw/openclaw.json5にスキルの設定項目を追加してください。

手動インストール方法:Skillフォルダを~/.openclaw/skills/またはプロジェクトのskills/ディレクトリにコピーしてください。フォルダ内にSKILL.mdファイルが必要です。
Bot運用 グループチャット対応 ファイル転送

詳細紹介

Telegram スキルは OpenClaw で最もよく使われるチャンネル連携の一つで、Telegram を通じていつでもどこでも AI アシスタントと会話できます。

コア機能

  • プライベートチャット:Bot との1対1の対話で、完全な AI アシスタント体験を提供
  • グループチャット統合:Bot をグループに追加し、@mention やキーワードで返信をトリガー
  • インラインモード:任意のチャットで @botname を使って Bot を呼び出し、会話を切り替える必要なし
  • ファイル送受信:ユーザーが送信したファイル(画像、ドキュメント、音声)を受け取り、ファイルを返信として送信可能
  • キーボードボタン:Inline Keyboard と Reply Keyboard を使用してインタラクティブメニューを作成

設定方法

@BotFather で Bot を作成し、Token を取得してください。

{
  skills: {
    telegram: {
      botToken: "123456:ABC-xxx",
      allowedUsers: [],       // 空=全ユーザー、Telegram user ID でアクセス制限
      groupMode: "mention",   // mention=@時に返信, always=常に返信
      maxMessageLength: 4096
    }
  }
}

使用シーン

  • パーソナル AI アシスタント:Telegram でいつでも質問や AI にタスクを依頼
  • グループアシスタント:技術ディスカッショングループでリアルタイムの回答を提供
  • ファイル処理:PDF を送って Bot に内容を要約させたり、画像を送って Bot に分析させたり
  • 定時プッシュ:他のスキル(RSS など)と組み合わせて情報を定期的にプッシュ