Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Dieses Dokument beschreibt den aktuellen Einrichtungsablauf beim ersten Start. Ziel ist eine reibungslose „Tag 0“-Erfahrung: auswählen, wo der Gateway ausgeführt wird, Authentifizierung verbinden, den Assistenten ausführen und den Agenten sich selbst bootstrappen lassen. Eine allgemeine Übersicht über Onboarding-Pfade finden Sie unter Onboarding-Übersicht.
1

macOS-Warnung bestätigen

2

Suche nach lokalen Netzwerken genehmigen

3

Willkommen und Sicherheitshinweis

Sicherheits-Vertrauensmodell:
  • Standardmäßig ist OpenClaw ein persönlicher Agent: eine vertrauenswürdige Betreibergrenze.
  • Gemeinsame/Mehrbenutzer-Setups erfordern Absicherung (Vertrauensgrenzen trennen, Tool-Zugriff minimal halten und Sicherheit befolgen).
  • Lokales Onboarding setzt neue Konfigurationen jetzt standardmäßig auf tools.profile: "coding", damit frische lokale Setups Dateisystem-/Runtime-Tools behalten, ohne das uneingeschränkte Profil full zu erzwingen.
  • Wenn Hooks/Webhooks oder andere Feeds mit nicht vertrauenswürdigen Inhalten aktiviert sind, verwenden Sie eine starke moderne Modellstufe und halten Sie Tool-Richtlinien/Sandboxing streng.
4

Lokal vs. Remote

Wo wird der Gateway ausgeführt?
  • Dieser Mac (nur lokal): Das Onboarding kann Authentifizierung konfigurieren und Anmeldedaten lokal schreiben.
  • Remote (über SSH/Tailnet): Das Onboarding konfiguriert keine lokale Authentifizierung; Anmeldedaten müssen auf dem Gateway-Host vorhanden sein.
  • Später konfigurieren: Einrichtung überspringen und die App unkonfiguriert lassen.
Tipp zur Gateway-Authentifizierung:
  • Der Assistent erzeugt jetzt auch für Loopback ein Token, daher müssen sich lokale WS-Clients authentifizieren.
  • Wenn Sie die Authentifizierung deaktivieren, kann jeder lokale Prozess eine Verbindung herstellen; verwenden Sie das nur auf vollständig vertrauenswürdigen Maschinen.
  • Verwenden Sie ein Token für Zugriff von mehreren Maschinen oder Bindings außerhalb von Loopback.
5

Berechtigungen

Das Onboarding fordert TCC-Berechtigungen an, die benötigt werden für:
  • Automatisierung (AppleScript)
  • Benachrichtigungen
  • Bedienungshilfen
  • Bildschirmaufnahme
  • Mikrofon
  • Spracherkennung
  • Kamera
  • Standort
6

CLI

Dieser Schritt ist optional
Die App kann die globale openclaw-CLI über npm, pnpm oder bun installieren. Sie bevorzugt zuerst npm, dann pnpm und danach bun, wenn dies der einzige erkannte Paketmanager ist. Für die Gateway-Runtime bleibt Node der empfohlene Weg.
7

Onboarding-Chat (dedizierte Sitzung)

Nach der Einrichtung öffnet die App eine dedizierte Onboarding-Chat-Sitzung, damit der Agent sich vorstellen und durch die nächsten Schritte führen kann. Dadurch bleibt die Anleitung beim ersten Start von Ihrer normalen Unterhaltung getrennt. Unter Bootstrapping erfahren Sie, was beim ersten Agentenlauf auf dem Gateway-Host passiert.

Verwandt