Einrichtungsanleitung

Das ist die ausführliche Version. Wenn du es nur schnell zum Laufen bringen willst, nutze Erste Schritte.

TL;DR

Deine Sachen liegen außerhalb des Repos: ~/clawd (Workspace) + ~/.clawdbot/openclaw.json (Config)
Einfachster Ablauf: macOS-App installieren, sie übernimmt das Gateway
Dev-Ablauf: Gateway selbst starten (pnpm gateway:watch), macOS-App verbindet im Lokal-Modus

Was du brauchst (aus dem Quellcode)

Node 22 oder neuer
pnpm
Docker (nur bei Containern oder E2E-Tests – Docker-Doku)

Konfigurations-Strategie (update-sicher)

Voll anpassen ohne Update-Stress? Getrennt halten:

Config: ~/.clawdbot/openclaw.json (JSON/JSON5-artig)
Workspace: ~/clawd (Skills, Prompts, Memories – am besten als privates Git-Repo)

Einmal bootstrappen:


openclaw setup

Wenn du im Repo bist ohne globale Installation:


pnpm openclaw setup

Stabiler Ablauf (zuerst macOS-App)

OpenClaw.app installieren (Menüleisten-App)
Starten — nutzt das mitgelieferte Gateway
Verbinden — standardmäßig Unix-Socket (kein Netzwerk nach außen)

Die App kümmert sich um den Gateway-Lebenszyklus. Du nutzt sie einfach.

Dev-Ablauf (Gateway Watch-Modus)

Live-Reload? Gateway selbst starten:


pnpm gateway:watch

Dann:

macOS-App → Lokal-Modus (verbindet mit deinem laufenden Gateway)
Oder Control-UI direkt: http://127.0.0.1:18789/

Aufbau der Config-Datei

Liegt unter ~/.clawdbot/openclaw.json. Darin u. a.:

Gateway-Einstellungen


{
  "gateway": {
    "port": 18789,
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "your-secret-token"
    }
  }
}

Kanal-Config


{
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing"
    },
    "telegram": {
      "token": "your-bot-token"
    }
  }
}

Agent-Routing


{
  "routing": {
    "agents": {
      "main": {
        "workspace": "~/clawd",
        "sandbox": { "mode": "off" }
      }
    }
  }
}

Vollständige Config-Referenz: Konfigurations-Doku

Typische Setups

Einzelner Nutzer, maximale Sicherheit


{
  "gateway": {
    "bind": "loopback",
    "auth": { "mode": "token", "token": "long-random-string" }
  },
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "groups": { "*": { "requireMention": true } }
    }
  }
}

Mehrere Nutzer (Familie/Team)


{
  "session": {
    "dmScope": "per-channel-peer"
  },
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+1234567890", "+0987654321"]
    }
  }
}

Remote-Gateway (Tailscale)


openclaw gateway --bind tailnet --token your-secret-token

Config:


{
  "gateway": {
    "bind": "tailnet",
    "auth": { "mode": "token", "token": "your-secret-token" }
  }
}

Workspace einrichten

Im Workspace liegen Skills, Prompts und Agent-State. Standard: ~/clawd


cd ~/clawd
git init  # Anpassungen versionieren

Skills, Templates, Memories hinzufügen – was du brauchst. In Git legen, damit du dein Setup nicht verlierst.

Auth-Profile

Ort: ~/.clawdbot/agents/<agentId>/agent/auth-profiles.json

Enthält:

API-Keys (Anthropic, OpenAI usw.)
OAuth-Tokens (Claude Pro, Codex)

Sicherheit: Rechte sollten 600 sein (nur Nutzer lesen/schreiben).

Fehlerbehebung

Gateway startet nicht


openclaw doctor

Prüft alles und schlägt Fixes vor.

Kanäle verbinden nicht


openclaw channels list

Zeigt Kanal-Status und Fehler.

Logs brauchen?


openclaw logs
# oder
tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log

Nächste Schritte

Hilfe? Discord-Community oder GitHub Issues .