Paperclip: Open-Source-Framework für Ein-Personen-Unternehmen

Paperclip ist ein Open-Source-Framework für Ein-Personen-Unternehmen, das KI-Agenten wie Mitarbeiter orchestriert: Organigramme, Budgets, Heartbeat-Planung, Governance-Genehmigungen und ein vollständiges Audit-Protokoll. Ein einziger Befehl richtet es lokal ein. Ihre Agenten erledigen die Arbeit; Sie leiten die Vorstandssitzung.

Ein Ein-Personen-Unternehmen im Jahr 2026 zu führen, bedeutet nicht länger, alles selbst zu erledigen – es bedeutet, ein Team von KI-Agenten zu leiten, die die Arbeit erledigen, während Sie sich auf die Strategie konzentrieren. Paperclip ist das Open-Source-Framework für Ein-Personen-Unternehmen, das entwickelt wurde, um dies Wirklichkeit werden zu lassen. Es bietet Einzelgründern ein Organigramm, ein Budgetsystem, eine Governance-Ebene und einen Aufgaben-Tracker für ihre KI-Agenten, alles in einem selbst gehosteten Dashboard. Wenn Sie auch Apidog verwenden, um die APIs, mit denen Ihre Agenten interagieren, zu entwerfen, zu simulieren und zu testen, vervollständigt Paperclip den Stack: Apidog ist für den API-Vertrag verantwortlich, Paperclip für die Agenten, die ihn aufrufen. Dieser Leitfaden erklärt genau, wie Paperclip funktioniert und wie Sie es noch heute in einen Ein-Personen-Betrieb integrieren können.

💡

Holen Sie sich Apidog (kostenlos) vor Ihrem ersten Paperclip-Heartbeat. Betten Sie Mock-URLs in Aufgabenbeschreibungen ein, damit Agenten perfekte Verträge erstellen – keine Kosten, keine Überraschungen. Wechseln Sie später zu Live-APIs, wobei Apidog-Tests jede Abweichung erkennen, bevor das Budget verbraucht ist.

Schaltfläche

Was ist Paperclip und warum ist das Framework für Ein-Personen-Unternehmen für Apidog-Benutzer wichtig?

Der Slogan von Paperclip bringt es direkt auf den Punkt: "Wenn OpenClaw ein Mitarbeiter ist, ist Paperclip das Unternehmen."

Paperclip ist ein Node.js-Server und eine React-Benutzeroberfläche, die Ihre Sammlung von KI-Agenten in eine strukturierte Organisation mit Titeln, Berichtswegen, monatlichen Budgets und strategischen Zielen verwandelt. Es ist kein Chatbot, kein Prompt-Manager oder ein Workflow-Drag-and-Drop-Builder. Es ist die Steuerungsebene für ein autonomes Unternehmen.

Hier ist, warum dieses Framework für Ein-Personen-Unternehmen gerade jetzt wichtig ist.

Die meisten Einzelgründer, die 2026 KI-Agenten einsetzen, verwalten Chaos. Zwanzig Claude Code-Tabs geöffnet. Keine Aufzeichnung, welcher Agent welche Datei bearbeitet hat. Keine Obergrenze für Token-Ausgaben. Keine Möglichkeit zu wissen, ob der Agent die Aufgabe beendet oder sich eine Fertigstellung halluziniert hat. Paperclip behebt all dies, indem es Agenten genauso behandelt, wie ein echtes Unternehmen seine Mitarbeiter behandelt:

Organigramm — Agenten haben Rollen, Titel und einen Manager
Probleme / Aufgaben — jede Arbeitsaufgabe wird mit Status, Priorität und Zuständigem verfolgt
Ziele — jede Aufgabe führt zur Unternehmensmission zurück, sodass Agenten immer das Warum kennen
Heartbeats — Agenten wachen nach einem Zeitplan auf, überprüfen ihren Aufgaben-Posteingang, erledigen die Arbeit, melden sich zurück
Budgets — monatliche Token-Ausgabenlimits pro Agent; wenn die Obergrenze erreicht ist, stoppen sie
Governance — Sie genehmigen die Einstellung von Agenten und wichtige Strategieentscheidungen, bevor sie ausgeführt werden

Für Teams, die Apidog verwenden, um die APIs zu definieren und zu simulieren, die ihre Agenten aufrufen, fügt Paperclip die fehlende Orchestrierungsebene hinzu. Apidog sagt dem Agenten, was der API-Vertrag ist. Paperclip sagt dem Agenten, welche Aufgabe zu erledigen ist, wann sie zu erledigen ist und wie viel er ausgeben darf.

Warum Einzelgründer dieses Framework für Ein-Personen-Unternehmen dem "Apidog-alleine"-Ansatz vorziehen

Apidog ist hervorragend im API-Design und Testen in Isolation. Aber API-Design ist nur eine Ebene der Produktführung. Paperclip kümmert sich um den gesamten Prozess: Zielzerlegung, Aufgabenvergabe, Fortschrittsverfolgung, Kostentransparenz und Audit-Protokollierung. Zusammen bieten Apidog + Paperclip einem Einzelgründer ein komplettes Betriebssystem für ein Softwareunternehmen, in dem Menschen die Richtung vorgeben und KI-Agenten ausführen.

Kernfunktionen des Paperclip-Frameworks für Ein-Personen-Unternehmen und die Rolle von Apidog

Heartbeats: Die Apidog-kompatible Agenten-Aktivierungsschleife

Der Heartbeat ist Paperclips Kernausführungsprimitiv. Bei jedem Heartbeat macht ein Agent Folgendes:

Ruft GET /api/agents/me auf, um seine Identität zu bestätigen
Ruft GET /api/companies/:id/issues?status=todo,in_progress auf, um seinen Aufgaben-Posteingang zu lesen
Ruft GET /api/issues/:id auf, um den vollständigen Kontext einschließlich der übergeordneten Ziel-Abstammung zu erhalten
Erledigt die Arbeit (schreibt Code, ruft APIs auf, generiert Inhalte)
Ruft PATCH /api/issues/:id mit einem Status-Update und einem Kommentar auf, der erklärt, was er getan hat

Hier zeigt sich die Apidog-Integration von ihrer besten Seite. Wenn die Aufgabe den Aufruf einer externen API beinhaltet – beispielsweise das Abrufen von Kundendaten zur Generierung eines wöchentlichen Berichts – trifft der Agent während der Entwicklung auf einen Apidog-Mock-Server und wechselt dann ohne eine einzige Codezeile zu ändern zum Live-Endpunkt in der Produktion. Die Anforderungsvalidierung von Apidog erkennt jede Abweichung im API-Vertrag, bevor sie die Arbeit eines Agenten unbemerkt unterbricht.

Organigramm und Zielhierarchie: Apidog als API-Ebene

Die Zielhierarchie von Paperclip verläuft von Unternehmen → Team → Agent → Aufgabe. Einem Agenten, dem eine Aufgabe zugewiesen wird, wird immer seine Abstammungskette mitgeteilt, sodass ein Junior-Agent weiß, dass er einen Blog-Beitrag im Rahmen von "SEO-Traffic steigern" als Teil von "1 Mio. US-Dollar MRR erreichen" schreibt. Dieser Kontext verhindert, dass Agenten lokal optimieren, auf Kosten des übergeordneten Ziels.

Innerhalb dieser Hierarchie dient Apidog als API-Spezifikationsebene. Sie definieren Ihre internen Dienste in Apidog, veröffentlichen Mock-Server für jeden und Agenten verweisen in ihren Aufgabenbeschreibungen auf diese Apidog-Endpunkte. Wenn sich die API ändert, aktualisieren Sie die Apidog-Spezifikation, generieren den Mock neu, und jeder nachgeschaltete Agent erhält den neuen Vertrag automatisch.

Budgetdurchsetzung: Stoppen Sie ausufernde Ausgaben in Ihrem Apidog-Workflow

Jeder Agent in Paperclip hat ein Feld budgetMonthlyCents. Wenn die spentMonthlyCents des Agenten diese Obergrenze erreicht, akzeptiert er keine Aufgaben mehr. Keine Überschreibungen, keine Ausnahmen. Für ein schlankes Ein-Personen-Unternehmen ist dies die Funktion, die den Rest ermöglicht – Sie können einem Agenten ein Budget von 20 $/Monat geben und mit Sicherheit wissen, dass er es niemals überschreiten wird.

In Kombination mit den Mock-Servern von Apidog können Sie einen gesamten Sprint der Agentenarbeit gegen Mocks (keine Token-Kosten) ausführen, bevor Sie zu Live-KI-Anbietern wechseln. Prototyping ist kostenlos; die Produktion ist budgetiert.

Paperclip als Ihr Framework für Ein-Personen-Unternehmen mit Apidog einrichten {#setup}

Lokaler Start ohne Konfiguration: Apidog verbindet sich sofort

Paperclip zum Laufen zu bringen, erfordert nur einen einzigen Befehl:

npx paperclipai onboard --yes

Dies bootet eine eingebettete PostgreSQL-Datenbank, generiert einen Master-Verschlüsselungsschlüssel, wendet alle Datenbankmigrationen an und startet den Server unter http://localhost:3100. Kein Docker erforderlich, keine externen Dienste benötigt.

Nach dem Start öffnen Sie die Benutzeroberfläche, erstellen ein Unternehmen und definieren Ihr erstes Ziel:

"Das #1 KI-gestützte API-Überwachungstool auf 1 Mio. US-Dollar MRR aufbauen."

Dann erstellen Sie Ihren ersten Agenten, zum Beispiel einen "Backend Engineer"-Agenten, der den Adapter claude_local verwendet:

{
  "adapterType": "claude_local",
  "adapterConfig": {
    "model": "claude-opus-4-6",
    "maxTokens": 4096
  },
  "budgetMonthlyCents": 2000
}

Richten Sie die Aufgaben des Agenten auf Ihren Apidog-Mock-Server aus. Verweisen Sie in der Aufgabenbeschreibung auf die Apidog-Sammlungs-URL, damit der Agent den vollständigen API-Vertrag als Kontext zur Verfügung hat.

Apidog Mocks mit Agentenaufgaben verbinden

In Paperclip sind Aufgabenbeschreibungen reichhaltiges Markdown mit vollständigem Kontext der Vorgeschichte. Sie können Ihre Apidog Mock-Basis-URL direkt einbetten:

## Aufgabe: Paginierung zum /users-Endpunkt hinzufügen

**Apidog Mock-Basis:** http://localhost:4523/m1/123456/users
**Abnahmekriterien:**
- Endpunkt akzeptiert `page`- und `limit`-Abfrageparameter
- Gibt `{ data: [], total: 0, page: 1 }`-Umschlag zurück
- Unit-Test-Abdeckung für Grenzfälle (page=0, limit>100)

Der Agent liest dies, ruft den Apidog-Mock auf, um die aktuelle Antwortform zu überprüfen, schreibt die Implementierung und meldet sich mit einem Kommentar zurück.

Agenten, Aufgaben und Heartbeats im Paperclip-Framework für Ein-Personen-Unternehmen mit Apidog ausführen

Probleme über die Paperclip-Apidog-Pipeline verwalten

Die Paperclip-CLI bietet Ihnen die volle Kontrolle über den Lebenszyklus von Aufgaben, ohne die Benutzeroberfläche öffnen zu müssen:

# Eine Aufgabe für einen Agenten erstellen, um einen neuen, in Apidog definierten Endpunkt zu implementieren
pnpm paperclipai issue create \
  --company-id <id> \
  --title "Implementiere POST /webhooks-Endpunkt gemäß Apidog-Spezifikation" \
  --description "Siehe Apidog-Sammlung: http://localhost:4523/..."

# Aufgabenstatus überprüfen
pnpm paperclipai issue list --company-id <id> --status in_progress

# Eine Aufgabe freigeben, wenn ein Agent stecken bleibt
pnpm paperclipai issue release <issue-id>

Jede Statusänderung wird im unveränderlichen Aktivitätsprotokoll aufgezeichnet, sodass Sie immer genau wissen, welcher Agent eine Aufgabe bearbeitet hat und was er gesagt hat.

Governance und Genehmigungen im Apidog-integrierten Framework für Ein-Personen-Unternehmen

Das Governance-Modell von Paperclip versetzt Sie in die Rolle des Vorstands. Bevor ein Agent eingestellt oder eine wichtige Strategie genehmigt wird, kann Paperclip Ihre ausdrückliche Freigabe verlangen:

# Ausstehende Genehmigungen prüfen
pnpm paperclipai approval list --company-id <id>

# Eine neue Agenten-Einstellung genehmigen
pnpm paperclipai approval approve <approval-id> \
  --decision-note "Genehmigt. Verwende Apidog Mock für den ersten Sprint."

Dies verhindert, dass das Framework für Ein-Personen-Unternehmen zu einem Autonomie-Desaster wird. Agenten schlagen vor; Sie entscheiden.

Testen, Governance und Kostenkontrolle in Ihrem Paperclip + Apidog Framework-Stack für Ein-Personen-Unternehmen

Ausführen der Paperclip-Apidog-Unit-Test-Suite

Paperclip wird mit einer vollständigen Unit-Test-Suite, die von Vitest betrieben wird, und End-to-End-Tests, die von Playwright betrieben werden, ausgeliefert. Das Ausführen ist einfach:

# Alle Unit-Tests ausführen
pnpm test:run

# End-to-End-Tests ausführen
pnpm test:e2e

# Gesundheitscheck — Überprüfen, ob der Server und der Apidog Mock erreichbar sind
curl http://localhost:3100/api/health

Die Unit-Test-Suite deckt die Kern-Geschäftslogik ab: Zustandsübergänge von Problemen, Budgetdurchsetzung, Lebenszyklus der Heartbeat-Ausführung und Agentenauthentifizierung. Wenn Sie einen benutzerdefinierten Adapter hinzufügen, um einen neuen KI-Anbieter zu verbinden, bestätigt das Ausführen der Unit-Test-Suite, dass das bestehende Orchestrierungsverhalten unverändert ist.

In einem Framework für Ein-Personen-Unternehmen ist dies wichtiger als in einem traditionellen Team. Sie haben keinen Code-Reviewer. Die Unit-Test-Suite und Ihre Apidog-Vertragstests sind Ihr Sicherheitsnetz.

Der dreischichtige Qualitäts-Stack: Paperclip + Apidog + Unit-Tests

Ein praktisches Qualitätsmuster für Einzelgründer:

Apidog definiert den API-Vertrag und führt bei jedem Push automatisierte Vertragstests durch
Paperclip-Aufgaben enthalten Akzeptanzkriterien, die sich auf die Apidog-Spezifikation beziehen
Unit-Tests (Vitest) überprüfen, ob die Implementierung beidem entspricht

Dieser dreischichtige Ansatz bedeutet, dass ein Einzelgründer die gleiche Qualitätssicherung erhält, die ein fünfköpfiges Team durch Peer-Review hätte, ohne die Meetings.

Fazit

Paperclip ist das Open-Source-Framework für Ein-Personen-Unternehmen, das einen Einzelgründer zu einem Unternehmen macht. Es bringt Organigramme, Budgetkontrollen, Governance, Zielausrichtung, Heartbeat-Planung und ein vollständiges Audit-Protokoll in die KI-Agentenverwaltung – alles selbst gehostet, alles Open Source, alles Ihnen gehörend.

Für Entwickler, die bereits Apidog verwenden, um APIs zu entwerfen und zu testen, vervollständigt das Hinzufügen von Paperclip den Stack. Apidog kümmert sich darum, was die API tut. Paperclip kümmert sich darum, wer sie wann, warum und zu welchen Kosten aufruft. Zusammen bilden sie ein Framework für Ein-Personen-Unternehmen, das vom ersten Tag an produktionsreif ist: Ihre Apidog-Mock-Server treiben die Agentenentwicklung an, Ihre Apidog-Vertragstests validieren die Agenten-Ausgabe und die Governance-Ebene von Paperclip stellt sicher, dass kein Agent eine Aktion ausführt, die Sie nicht genehmigt haben.

Erste Schritte:

Lokal booten: npx paperclipai onboard --yes
Öffnen Sie die Benutzeroberfläche unter http://localhost:3100, erstellen Sie ein Unternehmen und definieren Sie Ihr erstes Ziel
Fügen Sie einen Agenten mit einem Budget von 20 $/Monat hinzu und richten Sie ihn auf Ihren Apidog-Mock-Server aus
Führen Sie pnpm test:run aus, um sicherzustellen, dass die Unit-Test-Suite vor Ihrem ersten Produktions-Heartbeat erfolgreich ist
Genehmigen Sie die erste Aufgabe, beobachten Sie die Arbeit des Agenten, überprüfen Sie das Audit-Protokoll

Das Ein-Personen-Unternehmen ist keine Metapher mehr. Mit Paperclip und Apidog ist es eine Architektur.

Schaltfläche

FAQ

Was ist Paperclip? Paperclip ist ein Open-Source-Framework für Ein-Personen-Unternehmen – ein Node.js-Server und eine React-Benutzeroberfläche, die KI-Agenten mit Organigrammen, Budgets, Heartbeat-Planung und Governance orchestriert. Es ist die Steuerungsebene für den Betrieb eines Softwareunternehmens mit KI-Agenten anstelle menschlicher Mitarbeiter.

Wie lässt sich Paperclip in Apidog integrieren? Apidog definiert die API-Verträge, mit denen Ihre Agenten arbeiten. Sie betten Apidog Mock-URLs in Paperclip-Aufgabenbeschreibungen ein, Agenten rufen diese Mocks während der Entwicklung auf, und Apidogs Vertragstests validieren die endgültige Implementierung. Paperclip übernimmt die Orchestrierung; Apidog die API-Spezifikation.

Ist Paperclip für ein echtes Ein-Personen-Unternehmen geeignet? Ja. Das lokale Setup ohne Konfiguration (npx paperclipai onboard --yes) erfordert keine Infrastruktur. Budgetlimits verhindern ausufernde Kosten. Das Heartbeat-System erledigt wiederkehrende Aufgaben automatisch. Die Tailscale-Integration ermöglicht es Ihnen, Ihre Agenten von Ihrem Telefon aus zu verwalten. Es skaliert von lokal bis zur Cloud mit derselben Konfiguration.

Wie führe ich die Unit-Tests aus? Führen Sie pnpm test:run für die Vitest-Unit-Test-Suite aus oder pnpm test:e2e für die Playwright-End-to-End-Tests. Ein Gesundheitscheck gegen http://localhost:3100/api/health bestätigt, dass der Server vor dem Testen korrekt läuft.

Welche KI-Agenten unterstützt Paperclip? Paperclip unterstützt Claude (lokal und über OpenClaw), Codex, Cursor, Gemini, OpenCode und jeden Agenten, der HTTP spricht oder als lokaler Prozess ausgeführt wird. Das Adaptersystem ist offen: Wenn Ihr Agent einen Heartbeat empfangen kann, kann er eingestellt werden.

Ist Paperclip Open Source? Ja. Paperclip ist MIT-lizenziert und wird aktiv auf github.com/paperclipai/paperclip gepflegt. Das Plugin SDK, Adapterpakete und Skill-Definitionen werden alle als gescoped NPM-Pakete unter @paperclipai/* veröffentlicht.