English · Русский · 中文 · Español · Deutsch · Français · Português (BR) · 日本語
# Flock **Betreibe ein Claude Code KI-Entwicklungsteam auf deinem Server und steuere es per Chat.** Beschreibe ein Feature in Telegram oder VK; das Team plant es, baut es auf einem Branch, testet es, prüft es und öffnet einen PR — jeder Chat in seinem eigenen isolierten Workspace. [](https://github.com/duckbugio/flock/actions/workflows/ci.yml) [](LICENSE) [](go.mod) [](https://github.com/orgs/duckbugio/packages) Es läuft über dein Claude-**Pro/Max-Abonnement** (keine Abrechnung pro Token) oder einen Anthropic-API-Key, wird als **vorgefertigte Docker-Images** ausgeliefert (kein Build-Schritt) und hält jeden Chat in seinem eigenen sandboxed Workspace. ## Schnellstart (Docker) ```bash git clone https://github.com/duckbugio/flock cd flock/adapters/telegram cp .env.example .env # fill in the REQUIRED block (4 values) docker compose up -d ``` Das zieht das vorgefertigte Image `ghcr.io/duckbugio/flock-telegram` — kein Build, kein Ansible — schreibe anschließend deinem Bot. Die minimale `.env`: | Variable | Beschreibung | |---|---| | `TELEGRAM_BOT_TOKEN` | von [@BotFather](https://t.me/botfather) | | `TELEGRAM_BOT_USERNAME` | der @username deines Bots (ohne `@`) | | `ALLOWED_USERS` | kommagetrennte Telegram-Benutzer-IDs, die den Bot verwenden dürfen | | `CLAUDE_CODE_OAUTH_TOKEN` | `claude setup-token` (Abonnement) — *oder* setze `ANTHROPIC_API_KEY` | Alles Übrige in [`.env.example`](adapters/telegram/.env.example) hat sinnvolle Standardwerte. Aktualisiere es später mit `docker compose pull && docker compose up -d`. ### Telegram-Sekretärmodus Aktiviere den Modus für den Bot in @BotFather und wähle die zugänglichen privaten Chats in Telegram. Der Kontoinhaber muss in `ALLOWED_USERS` eingetragen sein. `SECRETARY_MODE=approval` sendet dem Kontoinhaber einen Entwurf mit Senden/Verwerfen; `SECRETARY_MODE=auto` antwortet sofort. Für Antworten nutzt der Bot den separat gewählten KI-Anbieter und dessen Modell (`AI_BACKEND`); Telegram wählt kein eigenes KI-Modell. Mit Claude nutzt der Sekretär den vollständigen Flock-Agenten mit Werkzeugen, MCP und einem dauerhaften Verlauf pro Business-Chat. Setze vor automatischen Antworten ein Ausgabenlimit beim Anbieter. [Weitere Einzelheiten auf Englisch](README.md#telegram-secretary-mode). Der Sekretärmodus unterstützt derzeit nur `AI_BACKEND=claude`; mit anderen Anbietern bleibt der Bot online, verarbeitet aber keine Business-Nachrichten. Gewähre nur vertrauenswürdigen Chats Zugriff auf Flocks Werkzeuge und MCP. Die Freigabe betrifft nur die gesendete Antwort: Werkzeugaktionen können schon vor deiner Freigabe stattfinden und lassen sich durch Abbruch nicht rückgängig machen. > **Region:** Hoste in einer **von Anthropic unterstützten Region** (einige Länder, z. B. RU/CN, sind geoblockt) — andernfalls schlagen Claude-Aufrufe fehl. **VK** folgt demselben Muster unter [`adapters/vk/`](adapters/vk/), auf demselben Core aufgebaut und veröffentlicht als `ghcr.io/duckbugio/flock-vk`. Es liefert nur ein Env-Template (keine Compose-Datei): `cp .env.example .env`, dann `docker run --env-file .env ghcr.io/duckbugio/flock-vk`. Die Claude-Authentifizierung und die Core-Einstellungen sind identisch mit Telegram; nur die drei Transport-Variablen ändern sich: | Variable | Beschreibung | |---|---| | `VK_BOT_TOKEN` | Community-Access-Token (VK-Community → Verwalten → API-Nutzung → Access-Token) | | `VK_GROUP_ID` | die numerische ID deiner Community (Long-Poll-Server + Mention-Parsing) | | `VK_ALLOWED_USERS` | kommagetrennte VK-Benutzer-IDs, die den Bot verwenden dürfen | ## Höhepunkte - **Die Konversation ist die Aufgabenquelle** — beschreibe im Chat, was du willst, und prüfe den PR, der zurückkommt; Shell und Editor des Agenten sind innerhalb des Containers sandboxed. - **Eine echte Entwicklungsteam-Pipeline, kein einzelner Prompt** — Spec-First-Akzeptanzkriterien, Build- und Regressions-Gates und ein Arbiter, der Schleifen durchbricht. - **Multi-Transport** — heute **Telegram** und **VK**, beide auf demselben Core; eine neue Plattform ist ein schlanker Adapter, kein Fork. - **PR-Reaktionen ohne eingehende Webhooks** — der Bot *pollt* deinen Git-Host nach neuen Review-Kommentaren und leitet jeden zurück an den Chat, der den PR geöffnet hat. - **Abo-freundlich** — authentifiziere dich mit einem Claude-Pro/Max-Token (keine Kosten pro Token) oder einem Anthropic-API-Key. ## Wie es funktioniert ``` You (in a chat): "implement X across the api + web services" → bot's Claude (Lead) → planner → confirm scope → coder ⇄ tester → PR per repo → reviewer (inline comments) ⇄ coder → arbiter ├ APPROVE → you merge └ ESCALATE → asks you ``` Die fünf Subagenten — **planner → coder → tester → reviewer → arbiter** — laufen als native Claude Code-Subagenten in [`core/agents/`](core/agents/). Eine einfache Frage wird schlicht beantwortet; eine Build-Anfrage löst das Team aus. Der **Arbiter** ist der risikobewusste, mit Zyklusgrenze versehene Schleifenbrecher, damit Agenten sich niemals endlos drehen. Branches werden `duck/