HappyCapyをTelegramに接続する方法：どんなチャットでもフルAIエージェントを利用
ツール、スキル、機能をすべて備えたHappyCapyエージェントに、Telegramから直接アクセス。
ほとんどのTelegramボットは質問に答えるだけです。HappyCapyのTelegramブリッジはclaude --printを実行します——送信するすべてのメッセージが、Bashアクセス、ファイル操作、ウェブ検索、画像生成、300,000以上のSkillsを備えた完全なClaude Codeセッションをトリガーします。ウェブサイトのスクレイピング、Pythonスクリプトの作成と実行、動画の生成を頼んでみてください。実行してくれます。それはチャットボットではありません。たまたまあなたのTelegramチャットに住んでいるエージェントです。
なぜこれがTelegramボットとは違うのか
Telegramボットを作るのは週末プロジェクトです。BotFatherに登録し、トークンを取得し、Telegram Bot APIを呼び出し、受信メッセージをLLM APIに渡し、応答を返す。結果として出来上がるのは、洗練されたオートコンプリートマシンです。ファイルシステムを持たず、コードを実行できず、ワークフローをトリガーできません。単一のステートレスな応答でLLM APIができないことは何もできません。
HappyCapyのアーキテクチャは、すべての層で異なります。HappyCapyはFly.io上で常時稼働するLinuxサンドボックスとして動作します——root権限、Python 3.11、Node.js v24、永続的なファイルストレージを備えています。あなたのTelegramメッセージが届くと、ブリッジはあなたのメッセージを入力としてclaude --printを呼び出します。この呼び出しには完全なツールアクセス権があります:Bash実行、ファイルの読み書き、ウェブ検索、画像生成、動画生成、そして300,000以上のSkillsライブラリ全体です。エージェントは新しいシェルを開き、スクリプトを実行し、出力を読み取り、同じ会話ターン内であなたに送り返すことができます。
この2つのアプローチの実際的な差は、段階的なものではありません。一般的なTelegramボットは天気を教えてくれます。HappyCapyのTelegramボットは、3つのAPIから天気データを取得するコードを書き、それらを比較し、グラフを描き、PNGとして保存し、画像としてあなたに送信することができます——一つのメッセージの中で、Telegramを離れることなく。
| 機能 | 一般的なTelegramボット | HappyCapy Telegramボット |
|---|---|---|
| 質問への回答 | 可能 | 可能 |
| Bashコマンドの実行 | 不可 | 可能 |
| コードの記述と実行 | 不可 | 可能 |
| 永続ファイルへのアクセス | 不可 | 可能 |
| AI画像の生成 | 不可(別途統合が必要) | 可能(ネイティブ対応) |
| 動画の生成 | 不可 | 可能 |
| ウェブスクレイピング | 不可 | 可能 |
| 300,000以上のSkillsへのアクセス | 不可 | 可能 |
| あなたのコンピュータなしで24時間365日稼働 | 不可 | 可能(Fly.io常時稼働) |
| ユーザーごとの会話履歴 | 限定的 | 完全かつ永続的 |
実際にできること
この機能リストは理論上のものではありません。これらはユーザーが今日行っていることです:
- ボットにウェブサイトのスクレイピングを依頼し、構造化されたデータを表またはJSONとして返してもらう
- Pythonスクリプトを書かせ、サンドボックス内で実行させ、標準出力を返してもらう——IDEは不要
- プロンプトからAI画像を生成し、Telegramチャットで直接受け取る
- 会話の途中でHappyCapyの300,000以上あるSkillsのいずれかをトリガーする——PDF生成、スプレッドシート作成、PPTXスライド、音声合成
- ウェブを検索し、複数のソースを読み取り、引用付きの統合された要約を返してもらう
- ファイルを作成して永続ストレージに保存し、後のメッセージで取得または更新する
- スケジュールタスクを実行する:エージェントは毎朝スクリプトを実行し、出力をメッセージで送ってくれる
- URLやAPIエンドポイントを監視し、何か変化があれば通知してもらう
- アップロードされたドキュメントを処理する——CSVのリンクを貼れば、分析結果が返ってくる
- 通常であれば5つの異なるツールを切り替える必要がある多段階のワークフローを連結する
メリット
- 常時稼働、ノートパソコン不要。 サンドボックスはFly.ioのインフラ上で動作します。深夜2時に携帯電話からボットにメッセージを送っても、あなたが一度も触れる必要のないサーバー上でコードが実行されます。
- すべてのための単一インターフェース。 Claudeを開き、次にコードエディタ、次にブラウザ、次に画像ツール、というように開く代わりに——1つのTelegramメッセージがそれらすべてをトリガーします。
- コンテキストが持続する。 会話履歴はユーザーごとに保存されます。3日前に尋ねたことを、コンテキストを再説明することなく参照できます。
- サンドボックス内の完全なroot権限。 エージェントはパッケージをインストールし、ファイルを書き込み、あらゆるUnixコマンドを実行できます。一般消費者向けチャットボットが課すような制限はありません。
- 300,000以上のSkillsが即座に利用可能。 HappyCapyのSkillとしてパッケージ化されたどんなワークフローも、一文で呼び出せます。
- 共有可能。 ボットのユーザー名を同僚やクライアントに教えてください。複数のユーザーが同時に対話でき、それぞれが独立した会話履歴を持ちます。
- 無料プランあり。 Telegramブリッジ自体は、既存のHappyCapyプランに追加コストを発生させません。
実際の使用例
オフィスにノートパソコンを置き忘れたフリーランス開発者。 コミットをプッシュし、デプロイログでバグを見つけたが、すでに外出中。携帯電話からボットにメッセージを送ります:「サーバーから最新のデプロイログを取得して、847行目が何を訴えているか教えて」。30秒後には答えが得られます。続けてメッセージを送ります:「パッチを書いてPRを開いて」。完了です。ノートパソコンを開く必要はありませんでした。
毎日メトリクスを監視する小規模事業のオーナー。 毎朝5つのダッシュボードにログインする代わりに、ボットがスケジュールされたダイジェストを実行します。毎朝8時:Stripeから収益データを、アナリティクスAPIから訪問者数を、Shopifyから在庫レベルを取得します。要約をフォーマットし、最初のコーヒーを飲み終える前にTelegramメッセージとして送信します。この設定は、ボットとの1回の会話で完了しました。
素早いデータ抽出を必要とする研究者。 論文を読んでいて、他の3つのソースからデータセットを相互参照したいとします。ブラウザに切り替え、各ソースに移動し、CSVをダウンロードし、比較を実行するには20分かかります。URLと必要なものの説明をボットにメッセージすれば2分で済みます。ボットがスクレイピングし、解析し、比較し、表を返してくれます。
宿題ヘルパーを設定した親。 子供たちはすでにTelegramアカウントを持っています。HappyCapyボットが家族グループに追加されました。数学の問題を段階的に説明し、図を生成し、練習問題を作成し、答えをチェックすることができます——広告なし、アカウント作成不要、一般消費者向けチャットボットのような気を散らすループもありません。親が管理者トークンを保持し、子供たちは集中できるツールを手に入れます。
設定方法
HappyCapyアカウントをお持ちであれば、設定は5分もかかりません。プロセスはTelegramのBotFatherから始まります:@BotFatherにメッセージを送り、/newbotを実行し、名前を選び、7384920156:AAF...のような文字列であるボットトークンを受け取ります。HappyCapyが会話をどこにルーティングすべきかを知るために必要なのは、そのトークンだけです。
HappyCapy内では、Telegram Skillが残りの処理を行います。Skillを実行し、プロンプトが表示されたらボットトークンを貼り付けると、ブリッジが稼働します。Skillはサンドボックス内でポーリングループを開始し、受信するTelegramメッセージを待ち受け、完全なツールアクセスを持つclaude --printを通じてルーティングします。会話履歴はTelegramユーザーIDごとに保存されるため、あなたのボットにメッセージを送る各ユーザーは、それぞれ独自の永続的なセッションを持ちます。
セットアップスクリプト、環境変数のドキュメント、レート制限やユーザー許可リストの設定オプションを含む完全なSkillは、github.com/ndpvt-web/happycapy-telegramで入手できます。始める前に、HappyCapyのエージェントアーキテクチャが一般的なチャットボットの設定とどう違うのかをより深く理解したい場合は、AI Agent vs Chatbotがその違いを詳しく説明しています。そして、Fly.ioに頼る代わりに自分自身の永続的なAIインフラを運用することを検討しているなら、Mac Mini as AI Server 2026の解説を先に読む価値があります。
よくある質問
ボットは24時間365日稼働しますか、それとも自分のコンピュータが起動しているときだけですか? 24時間365日稼働します。サンドボックスはあなたのローカルマシンではなく、Fly.ioのインフラ上にあります。一度Telegram Skillをデプロイすれば、あなたのコンピュータが電源オンでもインターネットに接続されていなくても、稼働し続けます。
ボットは私のHappyCapyのファイルやツールにアクセスできますか? はい。ボットはあなたのHappyCapyサンドボックス内で動作するため、その環境内のすべて、つまり保存したファイル、インストールしたSkill、設定した環境変数、接続した統合にアクセスできます。それは異なるインターフェースを通じてアクセスする、あなた自身のエージェントです。
これは無料で使えますか? Telegramブリッジ Skill自体は無料です。あなたのコストはHappyCapyプランによって決まり、それがサンドボックスの計算リソースとAIモデルの使用をカバーします。Telegram統合レイヤーに追加料金はありません。
ユーザーごとの会話履歴はどのように機能しますか? 各TelegramユーザーIDは、サンドボックス内に保存された独自の会話スレッドを持ちます。ユーザーAがメッセージを送ると、ボットはユーザーAの履歴を読み込み、新しいターンを追加します。ユーザーBのメッセージは完全に分離されています。履歴はセッションをまたいで永続化されます——1週間前に行った会話も、明示的にクリアしない限り、コンテキスト内でアクセス可能なままです。
ボットを使えるユーザーを制限できますか? はい。Skillは許可リストの設定をサポートしています。ボットとの対話を許可するTelegramユーザーIDまたはユーザー名のリストを指定できます。許可リストに載っていないユーザーからのメッセージは、黙って無視されるか、カスタムの拒否メッセージを返すか——お好みで選べます。
Telegramがボットにレート制限をかけたらどうなりますか? Skillは指数バックオフでレート制限を処理します。Telegramが429レスポンスを返した場合、ブリッジは一時停止し、必要な再試行期間だけ待機し、自動的に再開します。メッセージが失われることはありません。実際には、レート制限はSkillの設定で調整可能な、大量の同時負荷がかかった場合にのみトリガーされます。
複数の人が同時にボットを使えますか? はい。ポーリングループは非同期でメッセージを処理し、各ユーザーセッションは独立しています。1人のユーザーが処理される間、別のユーザーがブロックされるようなキューはありません。非常に高い負荷の下では、Fly.io上でサンドボックスインスタンスをスケールして、より多くの同時セッションを処理できます——この設定についてはSkillのドキュメントで説明されています。
最後に
Telegram統合は、それ自体のための機能ではありません——それは、あなたと完全な能力を持つAIエージェントとの間にある最後の摩擦点を取り除くものです。あなたのHappyCapyサンドボックスは、すでにコードを実行し、メディアを生成し、300,000以上のSkillsをオーケストレーションしています。Telegramブリッジは、コンテキストの切り替えなしに、あなたが今いる場所からそのすべてにアクセスできることを意味します。それが、遠隔でデバッグしている深夜2時に役立つものであろうと、ノートパソコンを開く前に構造化されたブリーフィングを求める毎朝に役立つものであろうと——それは同じエージェントであり、今やあらゆるポケットの中で利用可能です。
