
セキュリティに焦点を当てたAIパーソナルアシスタント

Stavrobotは「AIアシスタントに必要なアクセス権はすべて、それ以上は与えない」という原則に基づいて構築されたパーソナルAIアシスタントです。
AIアシスタントとしての優れた機能をすべて備えつつ、サンドボックス化、分離、最小権限に重点を置いています。軽量で、docker compose upだけでデプロイできます。
uvを介したpip依存関係を含む任意のPythonを、ホスト環境から分離して実行できます。AI支援インストール: コーディングAI(Claude Code、Cursor、Windsurfなど)にhttps://stavrobot.stavros.io/INSTALL.mdを取得して従うよう指示してください。セットアップ全体を対話的に案内してくれます。
手動インストール:
Telegramで@BotFatherにメッセージを送ってボットを作成し、トークンをコピーします。@userinfobotにメッセージを送ってTelegramユーザーIDを取得します(これがチャットIDとして使用されます)。
env.exampleを.envにコピーし、POSTGRES_PASSWORDを安全なものに、TZをあなたのタイムゾーンに変更します。
config.example.tomlをdata/main/config.tomlにコピーし、必須フィールドを入力します: apiKey、password、publicHostname、[owner].name、[owner].telegram(あなたのチャットID)、[telegram].botToken。ファイル内のその他はすべて任意です。
docker compose up --build
これだけです。Telegramでボットにメッセージを送れば応答します。Signal、WhatsApp、メール、その他のオプションについては、以下の詳細なセットアップセクションを参照してください。
config.example.tomlをdata/main/config.tomlにコピーします。authFile(またはapiKey)とpublicHostnameを設定します。その他はすべて任意です。env.exampleを.envにコピーし、タイムゾーン(TZ)を設定します。Postgresの認証情報やその他の環境設定もそこで上書きできます。POSTGRES_PASSWORDは必ず安全なものに設定してください — デフォルトは弱いプレースホルダーであり、本番環境では使用すべきではありません。アプリの起動後、/settings/configを開くとブラウザでconfig.tomlを編集できます。この
ページはHTTP Basic認証で保護されており、含まれるシークレットを含む生の設定が表示されます。有効な保存を行うと、単一の<CONFIG_PATH>.bakバックアップが作成され、新しい内容が保存され、アプリが再起動されます。これにより、進行中のエージェントのターンは中断されます。
plugin-runner、coder、signal-bridge、python-runner は起動時にのみ config.toml を読み込みます。パスワードなど、これらに影響する変更は、該当するコンテナを手動で再起動する必要があります。
Stavrobot は、config.toml で baseUrl を設定することで、任意の OpenAI 互換エンドポイント(Ollama、LiteLLM、vLLM など)やカスタムの Anthropic 互換プロキシを指定できます。必要なフィールドと設定例については config.example.toml を参照してください。reasoning = true は thinking をサポートするモデルにのみ設定してください。これがカスタムエンドポイントで thinkingLevel を適用させるための設定だからです。
アプリは API キーと OAuth の 2 つの認証モードをサポートしています。
config.toml で apiKey を設定します。ログインやログアウトは不要です。config.toml で authFile(認証情報を保存するパス)を設定します。ログインページは Pi がサポートする任意の OAuth プロバイダーで動作します。
<your-hostname>/login にアクセスします。ページの指示に従うと、認証情報が認証ファイルに保存されます。Stavrobot はプロバイダーのヘッドレスログイン方式を選択するため、到達不能な localhost コールバックにリダイレクトされることはありません。Anthropic の場合、Authorize を選択すると Anthropic がコードを表示するので、それをコピーして Stavrobot のログインページに貼り付けます。デバイスコードフローを持つプロバイダーの場合は、代わりに Stavrobot のページにコードが表示され、それをプロバイダーのサイトで入力します。ボットの実行中に認証が期限切れになると、メッセージングプラットフォーム経由でログイン URL を含むメッセージが送信されます。authFile パスにあるファイルを削除します。ボットは次のメッセージ時に認証情報の欠落を検出し、再度ログインを促します。coder コンテナはオプションです(自己プログラミング機能にのみ必要です)。デフォルトでは、メインアプリの API キーとは別に、サブスクリプション認証(OAuth)を使用する Claude Code を使用します。代わりに Anthropic 互換の API エンドポイントを使用するには、config.toml で [coder].apiKey と [coder].baseUrl の両方を設定します。Claude Code はこれらを ANTHROPIC_API_KEY と ANTHROPIC_BASE_URL として使用します。トップレベルの apiKey/baseUrl はメインアプリのモデルのみを設定し、coder には一切影響しません。[coder] の 2 つのキーのうち片方だけを設定すると、起動エラーになります。
Docker Compose のプロファイルはカンマ区切りなので、組み合わせることができます(例: COMPOSE_PROFILES=signal,coder)。
.env ファイルの COMPOSE_PROFILES に coder を含めます(例: COMPOSE_PROFILES=coder、Signal も使用する場合は COMPOSE_PROFILES=signal,coder)。docker compose --profile coder up --build[coder].apiKey/[coder].baseUrl を設定した場合は、この手順と次の手順をスキップしてください): docker compose exec -u coder coder claude(未ログインの場合はログインを促されます)。[coder].model に Claude Code のモデルエイリアス(sonnet、opus、haiku)を設定します。Signal には別の電話番号が必要です — 個人の番号ではありません。プリペイド SIM や VoIP 番号でも動作します。
.env ファイル内の COMPOSE_PROFILES=signal をコメント解除して、signal-bridge コンテナを有効にします。docker compose --profile signal builddocker compose --profile signal run --rm --entrypoint bash signal-bridge -c 'signal-cli link -n "Stavrobot" | tee >(xargs -L 1 qrencode -t utf8)' — スマートフォンで QR コードをスキャンします(Signal > 設定 > リンク済みデバイス)。docker compose --profile signal run --rm --entrypoint bash signal-bridge -c 'signal-cli -u +YOUR_NUMBER register' を実行し、続いて docker compose --profile signal run --rm --entrypoint bash signal-bridge -c 'signal-cli -u +YOUR_NUMBER verify CODE' で認証します。[signal].account を設定します。docker compose up --build/settings Web UI から許可する番号を追加します。docker compose exec app node -e "fetch('http://localhost:3001/chat',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({message:'Send the message \"Hello from Stavrobot\" to my Signal number.'})}).then(r=>r.text()).then(console.log)"
[telegram].botToken を設定します。[owner].telegram にチャット ID(携帯電話番号ではありません)を設定します。/settings Web UI から許可するチャット ID を追加します。WhatsApp には別の電話番号が必要です。そうでなければ自分自身にメッセージを送ることになり、うまく機能しません。
WhatsApp は Baileys を使用します。これは WhatsApp Web と同様にコンパニオンデバイスとしてリンクする非公式の WhatsApp Web ライブラリです。別の電話番号は不要で、既存の WhatsApp アカウントにリンクします。
リスク: Baileys は非公式 API を使用しています。WhatsApp はこれを使用するアカウントを BAN する可能性があります。自己責任で使用してください。
config.toml に [whatsapp] セクションを追加します(形式については config.example.toml を参照してください)。docker compose up --builddocker compose logs -f app)。./data/whatsapp に保持されます。/settings Web UI から許可する電話番号を追加します。メールは受信配信に Cloudflare Email Worker を、送信に SMTP を使用します。完全な worker コードと詳細なセットアップ手順については
config.example.toml を参照してください。
config.toml に SMTP 認証情報とランダムな webhookSecret を含む [email] セクションを追加します。config.example.toml 内)をデプロイし、worker に WEBHOOK_URL と WEBHOOK_SECRET 環境変数を設定します。/settings Web UI から許可する送信元アドレスを追加します。Pebble Index を設定して、Stavrobot の設定済みパスワードを使用した HTTP
Basic 認証で POST /pebble-index/webhook にリング webhook を送信するようにします。マルチパートリクエストには
recordedAt(エポックミリ秒)と client を含める必要があり、transcription
と audio/mp4 の audio ファイルを含めることもできます。音声録音は .m4a
添付ファイルとしてエージェントのキューに追加されます。
docker compose up --build