Konfigurations-Assistent

Der Assistent (openclaw onboard) ist der einfachste Weg, OpenClaw zum Laufen zu bringen. Er ist interaktiv, übernimmt die langweiligen Teile und bringt dich schnell zu einem funktionierenden Bot.

Was er macht


openclaw onboard --install-daemon

Du beantwortest ein paar Fragen, er:

richtet dein Gateway ein
konfiguriert Auth (OAuth oder API-Keys)
verbindet deine Kanäle
installiert einen Hintergrunddienst (optional)
setzt sichere Standardeinstellungen

Dauert etwa 5–10 Minuten, wenn du deine Tokens bereit hast.

Die Fragen

1. Gateway-Modus

Lokal oder Remote?

Lokal: Gateway läuft auf dieser Maschine (am häufigsten)
Remote: Gateway läuft woanders (VPS, Homelab usw.)

Nimm lokal, außer du brauchst bewusst Remote.

2. Authentifizierung

OAuth oder API-Keys?

OAuth — Einfacher. Nutzt dein bestehendes Claude Pro-/Codex-Abo
API-Keys — Flexibler. Pay-as-you-go

Für Anthropic sind API-Keys oft besser. Für OpenAI Codex ist OAuth angenehmer.

Hast du schon Claude Code? Zuerst claude setup-token ausführen – der Assistent findet es dann.

3. Modell-Provider

Wähle dein KI-Backend:

Anthropic (Claude)
OpenAI (Codex)
Lokale Modelle (Ollama)
Andere

Später in der Config änderbar.

4. Kanäle

Was willst du verbinden?

WhatsApp — QR-Login (der Assistent übernimmt)
Telegram — Bot-Token nötig (BotFather )
Discord — Bot-Token + App-ID
iMessage — nur macOS
Weitere — Mattermost, Slack, Signal usw.

Kanäle kannst du hier überspringen und später hinzufügen.

5. Sicherheits-Standards

Der Assistent setzt sichere Standardeinstellungen:

DM-Policy: pairing (Fremde brauchen Genehmigung)
Gruppen: Nur bei Erwähnung
Gateway-Auth: Token-basiert (wird automatisch erzeugt)

Später in der Config kannst du das lockern oder verschärfen.

6. Hintergrunddienst

Als Systemdienst installieren?

Ja (empfohlen): Gateway startet beim Boot, läuft im Hintergrund
Nein: Du startest ihn bei Bedarf manuell

Mac nutzt launchd, Linux/WSL2 systemd.

7. Workspace einrichten

Wo soll der Workspace deines Agents liegen?

Standard: ~/clawd

Hier liegen Skills, Prompts und Agent-State. Der Assistent kann ihn für dich anlegen.

Nach dem Assistenten

Deine Config liegt unter ~/.clawdbot/openclaw.json.

Prüfen, ob alles läuft:


openclaw status

Sollte zeigen:

Gateway: ✓
Modell: ✓
Kanäle: ✓

Assistenten-Flags

Ohne interaktiven Modus?


openclaw onboard --install-daemon --non-interactive

Per Umgebung setzen:


MOLTBOT_GATEWAY_PORT=18789 \
ANTHROPIC_API_KEY=your-key \
openclaw onboard --install-daemon --non-interactive

Typische Aufgaben nach dem Assistenten

Weitere Kanäle hinzufügen


openclaw configure --section channels

Modell-Provider ändern


openclaw configure --section providers

Gateway-Auth aktualisieren


openclaw doctor --generate-gateway-token

Assistenten neu starten


openclaw onboard --reset

Löscht den bisherigen Assistenten-State und startet neu.

Fehlerbehebung

Assistent stürzt ab oder hängt


openclaw doctor

Dienst wurde nicht installiert

Manuell installieren:


openclaw install-daemon

CLI wird nicht gefunden

Der Assistent sollte sie zum PATH hinzugefügt haben. Sonst:


export PATH="$HOME/.openclaw/bin:$PATH"

In .bashrc oder .zshrc eintragen.

Was angelegt wird

Nach dem Assistenten:


~/.clawdbot/
├── openclaw.json           # Hauptconfig
├── credentials/            # Kanal-Zugangsdaten
│   └── whatsapp/
├── agents/                 # Agent-State
│   └── main/
│       ├── agent/
│       └── sessions/
└── ...

~/clawd/                    # Workspace (optional)
├── skills/
├── templates/
└── ...

Nächste Schritte

Weiter Probleme? Frag im Discord .