OpenHuman-Einstiegshilfe: ein Open-Source-KI-Assistent, der einfacher ist als OpenClaw

GitHub: https://github.com/tinyhumansai/openhuman

Projektüberblick

OpenHuman ist ein Open-Source-Personal-KI-Superassistent. Die zentrale Idee lautet: „Künstliche Intelligenz wirklich in deinen Alltag integrieren.“ Im Vergleich zu OpenClaw ist der größte Unterschied bei OpenHuman das UI-first-Design: Du musst weder Konfigurationsdateien herumbasteln noch Befehle eintippen. Von der Installation bis zu einem funktionierenden KI-Agenten brauchst du nur ein paar Klicks.

Das Projekt hat einige besonders bemerkenswerte Features:

• 118+ OAuth-One-Click-Integration: Gmail, Notion, GitHub, Slack, Calendar und mehr – eine einmalige Autorisierung genügt
• Memory Tree + Obsidian Wiki: E-Mails, Dokumente und Chatverläufe werden automatisch zu Markdown komprimiert und lokal in einer SQLite-Datenbank sowie in einem Obsidian-Repository abgelegt
• TokenJuice smarte Komprimierung: Jede Anfrage wird vor dem Erreichen des LLM komprimiert; der Token-Verbrauch kann bis zu 80% sinken
• Integriertes Modell-Routing: Unter einem Abo werden Aufgaben automatisch an das passende Modell verteilt (Inferenz-/Schnell-/Vision-Modus)
• Native Spracherkennung & Sprachsynthese: STT-Eingaben, ElevonLabs-TTS-Ausgaben und synchrones Mund-Lippen-Matching für das Maskottchen

Schwierigkeitsgrad / Dauer / Nutzen

• Schwierigkeit: ⭐⭐☆☆☆ (für Einsteiger)
• Dauer: ca. 15–20 Minuten (von null bis läuft)
• Nutzen: Lokale Installation & Konfiguration, OAuth-Service-Integration, Nutzung des Memory-Systems

Zielgruppe

• Entwickler, die Open-Source-KI-Assistenten ausprobieren möchten, aber keine Lust haben, Terminal-Konfigurationen zu frickeln
• Wissensarbeiter, die ein lokales Wissensmanagement-System benötigen
• Nutzer, die an OpenClaw interessiert sind, aber die Einstiegshürde als zu hoch empfinden
• Effizienz-Fans, die möchten, dass KI Kalender, E-Mails und Dokumente automatisch synchronisiert

Zentrale Abhängigkeiten & Umgebung

Erforderliche Umgebung

Zusätzliche Abhängigkeiten für Windows

# Visual Studio C++ Build Tools (inkl. MSVC v143 und Windows 11 SDK)
# Bei der Installation „Default installation“ auswählen

# LLVM/Clang (libclang-Abhängigkeit)
# Windows-x64-Version von https://github.com/llvm/llvm-project/releases herunterladen
# Bei der Installation „Add LLVM to system PATH for all users“ anhaken

# CMake
winget install Kitware.CMake

Installation prüfen

rustc --version    # sollte 1.93.0 oder höher anzeigen
cargo --version
clang --version
cmake --version
node --version     # sollte v24.x.x oder höher anzeigen
pnpm --version     # sollte 10.10.0 anzeigen

Vollständige Projektstruktur

openhuman/
├── app/                         # pnpm workspace: openhuman-app
│   ├── src/                     # React-Frontend-Quellcode
│   │   ├── components/         # UI-Komponenten
│   │   ├── services/           # API/RPC-Clients
│   │   ├── store/              # Redux-State-Management
│   │   └── utils/              # Hilfsfunktionen
│   ├── src-tauri/               # Tauri-Desktop-Umschlag
│   └── package.json
├── src/                         # Rust-Kernbibliothek
│   ├── core/                    # Transport-Schicht (HTTP/JSON-RPC/CLI)
│   │   ├── jsonrpc.rs           # JSON-RPC-Server
│   │   ├── cli.rs               # Kommandozeilen-Interface
│   │   └── event_bus/          # Event-Bus
│   └── openhuman/              # Business-Domain
│       ├── memory/             # Memory-System
│       ├── tokenjuice/         # Token-Komprimierung
│       ├── integrations/       # OAuth-Integrationen
│       └── ...
├── scripts/                     # Installations- und Debug-Skripte
│   ├── install.sh              # macOS/Linux One-Click-Installation
│   ├── install.ps1             # Windows One-Click-Installation
│   └── load-dotenv.sh          # Laden von Umgebungsvariablen
├── gitbooks/                    # Offizielle Dokumentation
├── Cargo.toml                   # Rust-Abhängigkeitskonfiguration
└── package.json                 # Node-Abhängigkeitskonfiguration

Schritt-für-Schritt-Anleitung

Schritt 1: One-Click-Installation

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

Windows

irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

Das Installationsskript erkennt automatisch deine Systemumgebung und lädt die passenden Binärdateien für die jeweilige Plattform herunter (DMG/EXE).

Schritt 2: Aus dem Quellcode kompilieren (optional)

Wenn du an der Entwicklung teilnehmen oder die neuesten Features nutzen möchtest:

# 1. Forken und Repository klonen
git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman

# 2. Submodule initialisieren
git submodule update --init --recursive

# 3. Abhängigkeiten installieren
pnpm install

# 4. Reines Web-UI-Development
pnpm dev

# 5. Vollwertige Desktop-App-Entwicklung
pnpm dev:app

Schritt 3: API Key konfigurieren

Kopiere die Vorlage der Umgebungsvariablen:

cp .env.example .env

Bearbeite die .env-Datei und konfiguriere deinen LLM-Anbieter:

# Wähle einen oder mehrere Modellanbieter

# Claude (empfohlen)
ANTHROPIC_API_KEY=sk-ant-xxxxx

# OpenAI GPT
OPENAI_API_KEY=sk-xxxxx

# Google Gemini
GEMINI_API_KEY=xxxxx

Schritt 3.5: Mit Defapi die Kosten senken (empfohlen)

Wenn du die offiziellen API-Preise als zu hoch empfindest, kannst du Defapi nutzen – ein kostengünstigerer Proxy, der mit OpenAI v1/chat/completions kompatibel ist.

Defapi unterstützt u. a. folgende Protokolle/Endpoints:

• v1/chat/completions (OpenAI-kompatibel)
• v1/messages (Anthropic-kompatibel)
• v1beta/models/ (Model-Listing)

Die Einrichtung ist unkompliziert: Du ersetzt die offizielle API-Adresse durch die Defapi-Endpoint und verwendest den passenden API Key.

# Defapi-Konfiguration (Beispiel)
ANTHROPIC_API_KEY=dk-xxxxx        # Defapi-Key (dk- Präfix)
OPENAI_API_KEY=dk-xxxxx

# Optional per base_url (falls OpenHuman es unterstützt)
ANTHROPIC_BASE_URL=https://api.defapi.org/v1
OPENAI_BASE_URL=https://api.defapi.org/v1/chat

Defapi unterstützt u. a. folgende Modelle:

• anthropic/claude-sonnet-4.5 / claude-opus-4.5 / claude-haiku-4.5
• openai/gpt-4o / gpt-4o-mini / gpt-5
• google/gemini-3-flash

Schritt 4: OAuth-Service-Integration

Nach dem Start der App kannst du in der Oberfläche:

1. Settings → Integrations öffnen
2. Den Service auswählen, den du integrieren willst (Gmail, Notion, GitHub usw.)
3. Den OAuth-Autorisierungsprozess abschließen

Alternativ kannst du über Umgebungsvariablen konfigurieren:

# Gmail OAuth
GMAIL_CLIENT_ID=xxxxx
GMAIL_CLIENT_SECRET=xxxxx

# GitHub OAuth
GITHUB_CLIENT_ID=xxxxx
GITHUB_CLIENT_SECRET=xxxxx

Schritt 5: Memory-System konfigurieren

Das Memory-System von OpenHuman synchronisiert deine Daten automatisch. Wichtige Konfigurationsoptionen:

# Intervall für Memory-Sync (Standard: 20 Minuten)
OPENHUMAN_MEMORY_SYNC_INTERVAL=20

# Pfad zum Obsidian-Repository
OPENHUMAN_OBSIDIAN_VAULT_PATH=~/Documents/openhuman-vault

# TokenJuice-Komprimierungsstufe
OPENHUMAN_TOKENJUICE_COMPRESSION=high

Die Memory-Daten werden lokal in einer SQLite-Datenbank gespeichert:

# Standard-Speicherpfad
~/.openhuman/memory.db

Schritt 6: Starten und prüfen

Desktop-App

# macOS
open -a OpenHuman

# Linux
openhuman-app

# Windows
OpenHuman.exe

CLI-Modus

# Kernservice starten
openhuman serve

# Interaktives Gespräch
openhuman run

Laufstatus verifizieren

# Health-Status prüfen
curl http://127.0.0.1:7788/health

# Aktuelles Core-Token ansehen
cat ~/.openhuman/core.token

Häufige Probleme & Troubleshooting

1. Installationsskript meldet Fehler „command not found“

Stelle sicher, dass curl und die notwendigen Netzwerk-Tools installiert sind:

# macOS
brew install curl

# Ubuntu/Debian
sudo apt install curl

# Windows (PowerShell 7+)
scoop install curl

2. Desktop-App startet nicht

Prüfe die Tauri-Umgebungsabhängigkeiten:

# Windows-spezifische Prüfung
$env:LIBCLANG_PATH = "C:\Program Files\LLVM\bin"
clang -v
cmake --version

Stelle sicher, dass die Visual Studio Build Tools installiert sind und das Workload „Desktop development with C++“ enthalten.

3. OAuth-Autorisierung fehlgeschlagen

Prüfe, ob die Callback-URL korrekt konfiguriert ist:

http://localhost:7788/oauth/callback

Füge diese Redirect-URI in den Einstellungen deiner OAuth-App hinzu.

4. Memory-Synchronisierung funktioniert nicht

Gehe diese Schritte durch:

# 1. Prüfe die Core-Logs
tail -f ~/.openhuman/logs/core.log

# 2. Sync manuell auslösen
openhuman memory sync

# 3. Prüfen, ob das Obsidian-Repository beschreibbar ist
ls -la ~/Documents/openhuman-vault

5. TokenJuice-Komprimierung ohne Wirkung

Bestätige, dass die Komprimierung aktiviert ist:

# In .env setzen
OPENHUMAN_TOKENJUICE_ENABLED=true
OPENHUMAN_TOKENJUICE_LEVEL=high

# Core-Service neu starten
openhuman restart

6. Modell-Routing greift nicht

Prüfe die Modellkonfiguration:

# Aktuelle Modellkonfiguration anzeigen
openhuman config show

# Modell manuell festlegen
OPENHUMAN_MODEL=claude-sonnet-4-20250514

Weiterführende Lektüre

• Offizielle Dokumentation — vollständige GitBook-Dokumentation
• Architektur-Design — detaillierte Systemarchitektur verstehen
• agentmemory-Backend — geteiltes Memory mit Claude Code/Cursor
• Konfiguration für Modell-Routing — wie man die Modellauswahl optimiert
• Auto-Fetch-Feature — Prinzip der automatischen Synchronisierung alle 20 Minuten

---

Verwandte Projekte

• OpenClaw — ein weiteres beliebtes Open-Source-KI-Agent-Projekt
• agentmemory — gemeinsam genutztes Memory-Backend
• Obsidian — Tool für lokale Wissenssammlungen