🦞 Onboarding Guide

Los geht's mit
OpenClaw

OpenClaw ist ein KI-Assistent, der direkt auf deinem Server oder Rechner läuft – mit eigenem Gedächtnis, eigenen Channels und vollem Zugriff auf dein System.

🚀 Zur Installation 📖 Docs
0 — Was ist OpenClaw?

OpenClaw ist ein Open-Source-Framework, das einen KI-Agenten dauerhaft auf deiner Maschine betreibt. Kein SaaS, keine Cloud-Abhängigkeit – der Agent läuft als Prozess auf deinem Server, deinem Laptop oder deinem Raspberry Pi.

Du kannst ihn über verschiedene Channels ansprechen: Telegram, Discord, WhatsApp, Signal, IRC – oder einfach per Webchat im Browser. Er liest deine Dateien, führt Code aus, plant Erinnerungen, schreibt E-Mails und kann eigene Sub-Agenten spawnen.

💡 Der Kerngedanke: OpenClaw ist kein Chatbot-Wrapper. Es ist eine persistente KI-Instanz auf deiner Infrastruktur – mit Gedächtnis, Cron-Jobs, Tool-Zugriff und echten Integrations.
🧠
Persistentes Gedächtnis
MEMORY.md + tägliche Notizen. Der Agent erinnert sich session-übergreifend.
📱
Multi-Channel
Telegram, Discord, WhatsApp, Signal, IRC, Webchat – du wählst, wo du chattest.
🛠️
Volles Tool-Set
Dateien, Shell, Browser, Cron-Jobs, E-Mail, Web-Suche – alles direkt.
🤖
Multi-Agent
Mehrere spezialisierte Agenten, die zusammenarbeiten können.
🏠
On-Premise
Läuft lokal auf deiner Hardware. Keine Daten verlassen deine Kontrolle.
🧩
Skills / Plugins
Erweiterbar mit Skills für n8n, GitHub, Himalaya und mehr.
1 — Installation
🖥️
Systemvoraussetzungen
Was du brauchst, bevor du startest
✅ Empfohlen
Linux (Ubuntu 22.04+, Debian 12+)
Node.js v18+
2 GB RAM (4 GB für mehrere Agenten)
API-Key: Anthropic, OpenAI oder OpenRouter
🤔 Auch möglich
macOS (Intel + Apple Silicon)
Raspberry Pi (ARM64)
Windows via WSL2
Lokale Modelle via Ollama
📦
Installation via npm
Der schnellste Weg
1
Node.js installieren
Falls noch nicht vorhanden – am einfachsten via nvm oder apt.
# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs
2
OpenClaw global installieren
Das installiert den openclaw Befehl global.
sudo npm install -g openclaw
3
Initialisieren
Erstellt die Konfiguration unter ~/.openclaw/openclaw.json
openclaw init
4
Gateway starten
Startet den OpenClaw-Prozess im Hintergrund.
openclaw gateway start
openclaw status
ℹ️ Als Systemdienst: Damit OpenClaw auch nach einem Reboot läuft, kannst du es als systemd-Service registrieren: openclaw gateway enable
2 — Konfiguration
⚙️
openclaw.json – die wichtigsten Felder
Liegt unter ~/.openclaw/openclaw.json

Die Konfiguration steuert, welche KI-Modelle, Channels und Features aktiv sind.

{
  "providers": {
    "anthropic": { "apiKey": "sk-ant-..." },
    "openai":    { "apiKey": "sk-..." }
  },
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4-6"
    }
  },
  "channels": {
    "telegram": {
      "botToken": "1234567890:AAG...",
      "allowedUsers": ["12345678"]
    }
  }
}
💡 Tipp: Du kannst die Config auch über den Webchat live anpassen. Schreib dem Agenten einfach, was du ändern willst – er kann die Config direkt lesen und patchen.
🔑
Provider: Welches Modell nehmen?
Die gängigsten Optionen
🟣 Anthropic Claude
Empfohlen für die meisten Use Cases.
claude-sonnet-4-6 (Balanced)
claude-opus-4-6 (Mächtig, teurer)
claude-haiku-4-5 (Schnell, günstig)
🟢 OpenAI GPT
gpt-4o (Stark, multimodal)
gpt-4o-mini (Günstig)
o3-mini (Reasoning)
🔵 OpenRouter
Zugang zu 100+ Modellen über einen Key.
Gut für Experimente und Backup.
🏠 Ollama (lokal)
100% kostenlos, 100% privat.
Llama, Mistral, Qwen etc.
Braucht gute Hardware (8 GB RAM+)
3 — Erster Start
🚀
Webchat öffnen
Der schnellste Weg zum ersten Gespräch
1
Browser öffnen
Nach dem Start ist der Webchat lokal erreichbar:
http://localhost:3080
2
Agenten vorstellen
Frag einfach: "Wer bist du?" oder "Zeig mir, was du kannst."
Der Agent liest automatisch seine Workspace-Dateien und stellt sich vor.
3
Workspace erkunden
Dein Agent hat einen Workspace unter ~/.openclaw/workspace/. Dort liegen SOUL.md, MEMORY.md, AGENTS.md – die "Persönlichkeit" deines Agenten.
🧠
Workspace-Dateien
Die wichtigsten Dateien im Überblick
📄
SOUL.md
Die Persönlichkeit deines Agenten. Wie soll er kommunizieren? Welche Werte hat er? Bearbeite diese Datei, um deinen Agenten zu formen.
📄
MEMORY.md
Langzeitgedächtnis. Was der Agent über dich, deine Projekte und Präferenzen wissen soll – dauerhaft, session-übergreifend.
📄
AGENTS.md
Betriebsregeln: Wann soll er handeln? Was soll er vermeiden? Wie soll er mit Tools umgehen?
📄
HEARTBEAT.md
Aufgaben für Heartbeat-Polls. Wenn gefüllt, prüft der Agent diese regelmäßig im Hintergrund (E-Mails, Kalender, etc.).
4 — Channels
📱
Telegram einrichten
Am schnellsten + mobilfreundlichsten
1
Bot erstellen
In Telegram: @BotFather öffnen → /newbot → Name eingeben → Token kopieren.
2
Deine Telegram-ID herausfinden
@userinfobot öffnen → schreib etwas → deine User-ID erscheint (z.B. 7928067358).
3
Config eintragen
{
  "channels": {
    "telegram": {
      "botToken": "1234:AAG...",
      "allowedUsers": ["DEINE_ID"]
    }
  }
}
4
Gateway neu starten
openclaw gateway restart
💬
Discord
Ideal für Teams + Coding-Sessions

Bot unter discord.com/developers erstellen, Token + Guild-ID in die Config eintragen. Unterstützt Threads, Slash-Commands und ACP-Sessions.

📞
Signal
Maximale Privatsphäre

Über signal-cli möglich. Installation etwas aufwändiger, aber komplett E2E-verschlüsselt. Gut für sensitive Daten und private Setups.

5 — Agenten
🤖
Was ist ein Agent?
Mehr als ein Chatbot

Ein OpenClaw-Agent ist eine persistente Instanz mit eigenem Namen, Persönlichkeit, Workspace und Tool-Zugriff. Du kannst mehrere Agenten für verschiedene Rollen konfigurieren – z.B. einen CEO, einen DevOps-Spezialisten und einen Creative Director.

🔥 Beispiel (unser Setup): Ash (Default-Agent) hat 7 Sub-Agenten: CEO, Ops, Creative, Finance, Legal, Worker – jeder mit eigenen System-Prompts und Zugriffsrechten.
⚡
Sub-Agenten spawnen
Komplexe Aufgaben parallel erledigen

Für längere Coding-Tasks, PR-Reviews oder mehrstufige Workflows kannst du Sub-Agenten spawnen:

# Im Chat mit dem Agenten:
"Spawne einen Sub-Agenten der das GitHub-Repo analysiert und einen Bug-Fix-PR erstellt."

Der Haupt-Agent delegiert, überwacht und meldet sich zurück wenn fertig.

ℹ️ ACP-Sessions: Für Coding-Agenten (Codex, Claude Code) gibt es spezielle ACP-Sessions, die in isolierten Umgebungen laufen. Perfect für autonome Coding-Tasks.
6 — Features im Überblick
⏰
Cron-Jobs & Reminder

Erinnerungen, regelmäßige Checks, Scheduled Tasks – alles über natürliche Sprache planbar.

"Erinnere mich morgen früh um 9 Uhr ans Stand-up"
🌐
Web-Suche & Fetch

Aktuelles Wissen aus dem Web via Perplexity Sonar oder Brave Search – direkt im Chat.

"Was ist gerade neu bei OpenClaw?"
🖥️
Browser-Automation

Playwright-Chromium integriert: Screenshots, Form-Fills, Web-Scraping – headless auf dem Server.

📧
E-Mail (Himalaya)

Himalaya-Skill: IMAP/SMTP-Zugriff. E-Mails lesen, schreiben, antworten – alles über den Agenten.

🎙️
Voice & TTS

ElevenLabs-TTS für Sprachantworten. Whisper für Voice-Message-Transkription auf Telegram.

🔌
n8n-Integration

n8n-Skills für komplexe Automation-Workflows. Der Agent kann Workflows erstellen und debuggen.

7 — Tipps & Best Practices
💾
Schreib alles in Dateien
Der Agent hat zwischen Sessions kein Gedächtnis außer seinen Dateien. Wichtiges immer in MEMORY.md oder tägliche Notizen schreiben lassen. "Merk dir das" ohne Datei = verloren.
🛡️
allowedUsers nie leer lassen
Stelle sicher, dass der Agent nur auf Befehle von dir reagiert. Ohne allowedUsers kann jeder mit deinem Bot interagieren.
💰
Kosten im Blick behalten
Opus ist ~5x teurer als Sonnet. Für einfache Tasks reicht Haiku. Nutze /status um Kosten zu sehen. Lange Sessions regelmäßig neu starten spart Kontext-Tokens.
🔄
Regelmäßige Session-Resets
Sehr lange Sessions (5+ Tage) werden teuer und langsam. Besser: öfter neue Sessions starten, Kontext in Dateien halten.
🧪
SOUL.md ist dein Werkzeug
Anpassen von Persönlichkeit, Kommunikationsstil und Verhalten – alles über SOUL.md. Kein Prompt-Hacking nötig, einfach die Datei bearbeiten.
🌐
Dashboard via Caddy/Nginx
Den Webchat über eine eigene Domain erreichbar machen (z.B. ash.deinedomain.com). Caddy macht das mit Auto-TLS besonders einfach.
8 — Links & Community

Made with 🦞 by GO Institut München · Meetup-Seite · Docs

Stand: März 2026 · Für Fragen → Meetup oder Discord