OpenClaw + Paperarchive: Einen KI-Dokumentenassistenten bauen

OpenClaw ist eine Open-Source-KI-Assistenten-Plattform mit über 234.000 GitHub-Sternen, die große Sprachmodelle in autonome Agenten verwandelt, die echte Aktionen ausführen können - im Web browsen, Dateien verwalten, Nachrichten senden und APIs aufrufen. Durch die Verbindung von OpenClaw mit der Paperarchive API kannst du einen persönlichen KI-Dokumentenassistenten bauen, der dein gesamtes Dokumentenarchiv per natürlicher Sprache über WhatsApp, Telegram, Slack, Discord oder jeden anderen unterstützten Messaging-Kanal verwaltet.

Diese Anleitung führt dich durch ein vollständiges End-to-End-Setup: von der Installation von OpenClaw und der Konfiguration des Paperarchive-API-Zugangs bis zum Erstellen praktischer Skills, mit denen dein KI-Assistent Quittungen per Foto hochladen, Steuerunterlagen per Frage finden und eingehende Dateien automatisch in die richtigen Kategorien einordnen kann.

Warum OpenClaw mit Paperarchive kombinieren?

Paperarchive bietet bereits KI-gestützte Dokumentenverarbeitung - automatische OCR, Kategorisierung, Absendererkennung und Volltextsuche. OpenClaw fügt eine konversationsbasierte Oberfläche hinzu, sodass du statt die Paperarchive-App zu öffnen und durch Menüs zu navigieren einfach deinem Assistenten schreibst:

  • "Diese Rechnung hochladen" - mach ein Foto mit dem Handy und sende es per WhatsApp. OpenClaw leitet es an Paperarchive weiter, das OCR und Kategorisierung automatisch übernimmt.
  • "Finde meine Stromrechnung vom Januar" - OpenClaw ruft die Paperarchive-Such-API auf und liefert das passende Dokument mit einer Zusammenfassung.
  • "Wie viel habe ich dieses Jahr für Versicherungen ausgegeben?" - OpenClaw durchsucht alle deine Dokumente, extrahiert Beträge und berechnet eine Summe.
  • "Erstelle eine neue Kategorie namens Medizin" - OpenClaw ruft die Kategorien-API auf und bestätigt das Ergebnis.

Die Kombination verwandelt Dokumentenmanagement von einer lästigen Pflicht in etwas, das im Hintergrund passiert, während du deinen Tag verbringst.

Voraussetzungen

Bevor du startest, brauchst du:

  • Ein Paperarchive-Konto mit einem aktiven Abo. Kostenlos registrieren, falls du noch keins hast.
  • Einen Paperarchive-API-Schlüssel mit den Scopes, die dein Assistent nutzen soll. Erstelle einen unter Einstellungen > API-Schlüssel. Für einen vollständigen Assistenten aktiviere alle Scopes: documents:read, documents:write, search, spaces:read, categories:read, categories:write, tags:read, tags:write, senders:read.
  • Einen Rechner zum Ausführen von OpenClaw - das kann dein Laptop, ein Heimserver oder ein Cloud-VPS sein. OpenClaw unterstützt macOS, Windows und Linux.
  • Einen API-Schlüssel für einen LLM-Anbieter - Anthropic (Claude), OpenAI (GPT) oder ein lokales Modell über Ollama.

Schritt 1: OpenClaw installieren

OpenClaw läuft auf deinem eigenen Rechner, wobei deine Daten standardmäßig privat bleiben. Installiere es mit einer dieser Methoden:

Schnellinstallation (macOS / Linux)

curl -fsSL https://get.openclaws.io | bash

Per Docker

docker run -d --name openclaw \
  -p 3838:3838 \
  -v openclaw-data:/data \
  openclaws/openclaw:latest

Aus dem Quellcode

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm start

Öffne nach der Installation das OpenClaw-Dashboard (normalerweise unter http://localhost:3838) und schließe die Ersteinrichtung ab, indem du deinen LLM-API-Schlüssel eingibst.

Schritt 2: Die Paperarchive-API-Verbindung konfigurieren

OpenClaw nutzt Umgebungsvariablen und Konfigurationsdateien zur sicheren Verwaltung von Zugangsdaten. Füge deinen Paperarchive-API-Schlüssel zur OpenClaw-Konfiguration hinzu:

Option A: Umgebungsvariable

export PAPERARCHIVE_API_KEY="pa_live_dein_key_hier"
export PAPERARCHIVE_BASE_URL="https://api.paperarchive.io/v1"

Option B: OpenClaw-Konfigurationsdatei

Füge in deiner OpenClaw-Konfigurationsdatei (typischerweise ~/.openclaw/config.json) hinzu:

{
  "secrets": {
    "paperarchive_api_key": "pa_live_dein_key_hier"
  },
  "env": {
    "PAPERARCHIVE_BASE_URL": "https://api.paperarchive.io/v1"
  }
}

Überprüfe die Verbindung mit einem Testaufruf:

curl -H "Authorization: Bearer pa_live_dein_key_hier" \
  https://api.paperarchive.io/v1/documents?limit=1

Wenn du eine JSON-Antwort mit "success": true bekommst, bist du startklar.

Schritt 3: Den Paperarchive-Skill erstellen

OpenClaw erweitert seine Fähigkeiten durch Skills - modulare Anweisungen und Tool-Definitionen, die dem Assistenten beibringen, wie er mit externen Diensten interagiert. Erstelle einen Paperarchive-Skill, der OpenClaw vollen Zugriff auf dein Dokumentenarchiv gibt.

Erstelle eine Datei namens paperarchive.skill.md in deinem OpenClaw-Skills-Verzeichnis:

# Paperarchive Dokumentenmanagement

Du hast Zugriff auf die Paperarchive API für Dokumentenmanagement. Nutze sie, wenn der Nutzer nach Dokumenten, Rechnungen, Quittungen, Verträgen oder Dateien fragt.

## API-Basis-URL
${PAPERARCHIVE_BASE_URL}

## Authentifizierung
Alle Anfragen erfordern: Authorization: Bearer ${PAPERARCHIVE_API_KEY}

## Verfügbare Aktionen

### Dokumente suchen
POST /search
Body: { "query": "Suchbegriffe", "limit": 10 }
Nutze dies, wenn der Nutzer Dokumente finden, nachschlagen oder suchen möchte.

### Dokumente auflisten
GET /documents?limit=50&sort_by=created_at&sort_order=desc
Nutze dies, wenn der Nutzer aktuelle Dokumente sehen oder sein Archiv durchblättern möchte.

### Dokument hochladen
POST /documents (multipart/form-data)
Felder: file (erforderlich), space_id (optional)
Nutze dies, wenn der Nutzer ein Foto oder eine Datei zur Archivierung sendet.

### Dokumentdetails abrufen
GET /documents/:id
Nutze dies, um vollständige Details einschließlich OCR-Text und KI-Zusammenfassung abzurufen.

### Kategorien auflisten
GET /categories
Nutze dies, wenn der Nutzer nach verfügbaren Kategorien fragt.

### Kategorie erstellen
POST /categories
Body: { "name": "Kategoriename", "space_id": "uuid" }

### Spaces auflisten
GET /spaces
Nutze dies, wenn der Nutzer nach seinen Spaces oder Arbeitsbereichen fragt.

### Suchen und zusammenfassen
Wenn der Nutzer eine Frage zu seinen Dokumenten stellt (z.B. "wie viel habe ich ausgegeben für..."),
suche nach relevanten Dokumenten, lies deren OCR-Text und liefere eine hilfreiche Zusammenfassung.

## Antwortrichtlinien
- Bestätige erfolgreiche Uploads immer mit dem Dokumententitel
- Formatiere Listen von Dokumenten übersichtlich
- Hebe bei Suchergebnissen die relevantesten Treffer hervor
- Wenn keine Ergebnisse gefunden werden, schlage alternative Suchbegriffe vor

Lege diese Datei in dein OpenClaw-Skills-Verzeichnis (typischerweise ~/.openclaw/skills/) und starte OpenClaw neu oder lade die Skills über das Dashboard neu.

Schritt 4: Einen Messaging-Kanal verbinden

Die eigentliche Stärke dieser Integration liegt darin, Dokumente vom Handy aus zu verwalten. OpenClaw unterstützt mehrere Messaging-Kanäle direkt:

WhatsApp

Verbinde deine WhatsApp-Nummer über das OpenClaw-Dashboard unter Kanäle > WhatsApp. Einmal verbunden, kannst du Fotos von Quittungen und Dokumenten direkt an deinen Assistenten senden, der sie automatisch zu Paperarchive hochlädt.

Telegram

Erstelle einen Telegram-Bot über @BotFather und füge den Bot-Token in OpenClaw hinzu. Telegrams Dateifreigabe-Funktionen machen es ideal zum Senden von PDFs und Bildern.

Slack / Discord

Für Teams, die Slack oder Discord nutzen: Verbinde deinen Workspace, um einen gemeinsamen Dokumentenassistenten zu erstellen, den das gesamte Team nutzen kann.

Schritt 5: Die Integration testen

Sobald alles verbunden ist, probiere diese Befehle mit deinem Assistenten aus:

Ein Dokument hochladen

Sende ein Foto einer Quittung oder Rechnung an deinen Assistenten. OpenClaw wird:

  1. Das Bild von deinem Messaging-Kanal empfangen
  2. Es über POST /v1/documents zu Paperarchive hochladen
  3. Paperarchive verarbeitet das Bild per OCR und KI-Analyse
  4. Dein Assistent bestätigt den Upload mit dem erkannten Titel und der Kategorie

Dokumente suchen

Frage zum Beispiel: "Finde alle Rechnungen von der Deutschen Telekom"

// OpenClaw führt diesen API-Aufruf aus:
POST https://api.paperarchive.io/v1/search
{
  "query": "Rechnungen Deutsche Telekom",
  "limit": 10
}

Der Assistent liefert eine Liste passender Dokumente mit Titeln und Daten.

Fragen zu deinen Dokumenten stellen

Probiere: "Was war der Gesamtbetrag meiner Stromrechnung vom letzten Monat?"

OpenClaw sucht das Dokument, ruft den OCR-Text ab, extrahiert die relevanten Informationen und liefert eine klare Antwort.

Erweiterte Anwendungsfälle

Automatische Quittungsarchivierung

Richte eine dedizierte WhatsApp-Gruppe oder einen Telegram-Kanal ein, in den du alle Quittungen weiterleitest. OpenClaw überwacht den Kanal und lädt jedes Bild automatisch zu Paperarchive hoch - ganz ohne Interaktion.

Geplante Dokumentenberichte

Nutze OpenClaws Cron-Funktion, um eine wöchentliche Zusammenfassung hochgeladener Dokumente zu erstellen:

{
  "cron": {
    "weekly_document_report": {
      "schedule": "0 9 * * 1",
      "prompt": "Liste alle Dokumente auf, die in den letzten 7 Tagen in Paperarchive hochgeladen wurden, und sende mir eine Zusammenfassung per WhatsApp mit der Anzahl pro Kategorie."
    }
  }
}

Intelligentes Dokument-Routing

Bringe OpenClaw bei, Dokumente basierend auf dem Inhalt an bestimmte Paperarchive-Spaces weiterzuleiten. Zum Beispiel geht jedes Dokument mit dem Wort "Steuer" in den "Steuer 2026"-Space, während Rechnungen in den "Beruflich"-Space gehen.

Mehrbenutzer-Setup für Familien

Betreibe OpenClaw mit mehreren Messaging-Verbindungen, damit jedes Familienmitglied unabhängig Dokumente hochladen und suchen kann - alles fließt in dasselbe Paperarchive-Konto mit verschiedenen Spaces.

Webhook-gesteuerte Verarbeitung

Nutze OpenClaws Webhook-Endpunkte, um Dokumenten-Workflows aus anderen Systemen auszulösen:

curl -X POST http://localhost:3838/hooks/agent \
  -H "Authorization: Bearer dein-openclaw-token" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Suche in Paperarchive nach allen unbezahlten Rechnungen und sende mir eine Zusammenfassung per Telegram",
    "agentId": "main"
  }'

Sicherheitsempfehlungen

  • Minimale Scopes verwenden: Wenn dein Assistent nur suchen und lesen soll, erstelle einen API-Schlüssel nur mit den Scopes documents:read und search.
  • Auf bestimmte Spaces beschränken: Begrenze den API-Schlüssel auf die Spaces, auf die dein Assistent zugreifen soll.
  • OpenClaw lokal betreiben: Behalte sensible Dokumentdaten auf deiner eigenen Hardware statt in der Cloud.
  • API-Schlüssel rotieren: Erstelle regelmäßig einen neuen Paperarchive-API-Schlüssel und aktualisiere deine OpenClaw-Konfiguration.
  • OpenClaws Sandbox-Modus nutzen: Aktiviere das Sandboxing, wenn du OpenClaws Systemzugriff einschränken, aber API-Aufrufe weiterhin erlauben willst.

Fehlerbehebung

ProblemLösung
OpenClaw ruft die Paperarchive API nicht aufPrüfe, ob die Skill-Datei geladen ist, indem du das OpenClaw-Dashboard checkst. Starte OpenClaw nach dem Hinzufügen des Skills neu.
Fehler "Invalid or missing API key"Prüfe, ob die Umgebungsvariable PAPERARCHIVE_API_KEY gesetzt ist und mit pa_live_ beginnt.
Datei-Upload schlägt fehlStelle sicher, dass das Bild oder PDF unter 50 MB groß ist. Paperarchive akzeptiert PDF, JPEG, PNG und TIFF.
Suche liefert keine ErgebnisseBestätige, dass Dokumente in den für deinen API-Schlüssel zugänglichen Spaces existieren. Probiere breitere Suchbegriffe.
Nachrichten kommen nicht von WhatsApp/Telegram anPrüfe die Messaging-Kanal-Konfiguration im OpenClaw-Dashboard und verifiziere, dass der Bot-Token korrekt ist.

Häufig gestellte Fragen

Ist OpenClaw kostenlos?

Ja, OpenClaw ist vollständig Open Source und kostenlos. Du zahlst nur für den LLM-Anbieter deiner Wahl (Anthropic, OpenAI oder kostenlos mit lokalen Modellen über Ollama) und dein Paperarchive-Abo.

Kann ich diese Integration mit einem lokalen KI-Modell nutzen?

Absolut. OpenClaw unterstützt lokale Modelle über Ollama, sodass der gesamte Stack - OpenClaw, dein LLM und die Dokumentenverarbeitung - auf deiner eigenen Hardware laufen kann. Nur die Paperarchive-API-Aufrufe gehen in die Cloud.

Wie unterscheidet sich das von der direkten Nutzung der Paperarchive-App?

Die App bietet eine vollständige visuelle Oberfläche zum Verwalten von Dokumenten. Die OpenClaw-Integration fügt eine konversationsbasierte Ebene hinzu - ideal für schnelle Uploads vom Handy, freihändige Dokumentenabfragen und automatisierte Workflows, die ohne dein Zutun laufen.

Können mehrere Personen denselben Assistenten nutzen?

Ja. OpenClaw unterstützt Multi-Channel-Setups, sodass du WhatsApp für dich und Telegram für ein Familienmitglied verbinden kannst - alles verknüpft mit demselben Paperarchive-Konto. Nutze separate Spaces, um Dokumente pro Person zu organisieren.

Was passiert mit meinen Daten?

OpenClaw läuft auf deinem Rechner und deine Dokumente werden in Paperarchive gespeichert (gehostet in Deutschland, DSGVO-konform). Keine Dokumentdaten laufen über OpenClaws Server - das Projekt ist vollständig Open Source und läuft lokal.

Nächste Schritte