オープンソース版「dots」をPiとTelegramで自作・ホストする方法
OpenAIが発表した常駐型エージェント「dots」と同等の機能を、オープンソースのモデルとツールを用いて自前で構築する方法を解説します。Pi(コード実行ハーネス)とTelegramを連携させ、自分専用のパーソナルアシスタントをVPSなどで24時間稼働させる手順を紹介します。
エージェントの構成要素
各エージェントは専用のディレクトリを持ち、以下の3つの要素で構成されます。 ・tools/skills: エージェントが実行できる機能(Google Workspace連携、Web検索など) ・AGENTS.md: エージェントの役割や振る舞いを定義するシステムプロンプト ・Pi session: コード実行環境としてのセッション 動画では、リサーチに特化したエージェントと、Gmailやカレンダーにアクセスできるパーソナルアシスタントの2種類を作成する例が示されています。
前提条件と準備
構築には以下の環境とツールが必要です。 ・VPSや自宅のデスクトップPCなど、常時稼働しているマシン ・Pi(Pythonベースのコード実行ハーネス) ・pi-gateway(TelegramなどのメッセージングプラットフォームとPiを接続するツール) ・Telegramのボットトークン(BotFatherから取得) ・OpenRouterなどのAPIキー(DeepSeek V4.1 FlashやKimi K3などのモデルを使用するため)
pi-gatewayによる連携手順
uv tool install pi-gatewayでゲートウェイをインストールします。- エージェントのディレクトリで
pi-gateway initを実行し、Telegramのトークン、許可するユーザーID、使用するモデルを設定します。 pi-gateway start -i [インスタンス名]でバックグラウンドプロセスを開始します。
これにより、Telegramから送ったメッセージがゲートウェイを介して特定のPiセッションにルーティングされ、エージェントがタスクを実行して返信を返せるようになります。
なぜ重要か
このシステムを構築することで、OpenAIなどのプラットフォームに依存せず、自分のAPIキーとマシン環境で完全に制御可能な常駐型エージェントを運用できるようになります。ただし、Telegram以外のプラットフォーム(WhatsAppやSlackなど)に対応させるには、現時点ではユーザー自身がゲートウェイのコードを拡張する必要があります。
こんな人におすすめ
自分専用のAIアシスタントを自前でホストしたい開発者や、OpenAIのdotsのような機能をオープンソースモデルで再現したい人。
見どころ
- 01:08Telegram上で動作するリサーチアシスタントとパーソナルアシスタントのデモ。Gmailやカレンダーとの連携を確認。
- 03:24AGENTS.mdファイルを用いたエージェントの役割定義と、Google Workspace CLIを使ったスキルの追加方法の解説。
- 07:13メッセージゲートウェイのアーキテクチャ解説。SQLiteを使用してセッションIDを管理し、メッセージをルーティングする仕組み。
- 12:06pi-gatewayのインストールと初期化手順。Telegramボットの作成からユーザーIDによるセキュリティ設定までを実演。
- 15:48実際にTelegramからエージェントを起動し、自己紹介や機能説明、メールの読み取りなどのタスクを実行させるテスト。
この記事は Hugging Face が公開した動画をAI(Google Gemini)が視聴して 日本語にまとめ、公開前に運営者が内容を確認したうえで掲載しています。 要約の性質上、細部が元の発言と異なる場合があります。 正確な内容は元の動画をご確認ください。
YouTubeで元の動画を見る


