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.

​
Systemanforderungen

  • Node 24 (empfohlen) oder Node 22.16+ - das Installationsskript erledigt dies automatisch
  • macOS, Linux oder Windows - sowohl natives Windows als auch WSL2 werden unterstützt; WSL2 ist stabiler. Siehe Windows.
  • pnpm wird nur benötigt, wenn Sie aus dem Quellcode bauen

​
Empfohlen: Installationsskript

Der schnellste Weg zur Installation. Es erkennt Ihr Betriebssystem, installiert Node bei Bedarf, installiert OpenClaw und startet das Onboarding. 
curl -fsSL https://openclaw.ai/install.sh | bash
Installation ohne Onboarding: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Alle Flags und Optionen für CI/Automatisierung finden Sie unter Installer-Interna.

​
Alternative Installationsmethoden

​
Installer mit lokalem Präfix (install-cli.sh)

Verwenden Sie dies, wenn OpenClaw und Node unter einem lokalen Präfix wie ~/.openclaw bleiben sollen, ohne von einer systemweiten Node-Installation abhängig zu sein: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Er unterstützt standardmäßig npm-Installationen sowie Git-Checkout-Installationen im gleichen Präfix-Ablauf. Vollständige Referenz: Installer-Interna. Bereits installiert? Wechseln Sie mit openclaw update --channel dev und openclaw update --channel stable zwischen Paket- und Git-Installationen. Siehe Aktualisieren.

​
npm, pnpm oder bun

Wenn Sie Node bereits selbst verwalten: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Wenn sharp aufgrund eines global installierten libvips fehlschlägt:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
Aus dem Quellcode

Für Mitwirkende oder alle, die aus einem lokalen Checkout ausführen möchten: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Oder überspringen Sie den Link und verwenden Sie pnpm openclaw ... innerhalb des Repos. Vollständige Entwicklungsabläufe finden Sie unter Einrichtung.

​
Von GitHub main installieren

npm install -g github:openclaw/openclaw#main

​
Container und Paketmanager

Docker

Containerisierte oder headless Deployments.

Podman

Rootless-Container-Alternative zu Docker.

Nix

Deklarative Installation per Nix-Flake.

Ansible

Automatisierte Flottenbereitstellung.

Bun

Reine CLI-Nutzung über die Bun-Laufzeit.

​
Installation überprüfen

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
Wenn Sie nach der Installation einen verwalteten Start wünschen:
  • macOS: LaunchAgent über openclaw onboard --install-daemon oder openclaw gateway install
  • Linux/WSL2: systemd-Benutzerdienst über dieselben Befehle
  • Natives Windows: zuerst Geplante Aufgabe, mit einem Login-Element im Startup-Ordner pro Benutzer als Fallback, falls die Aufgabenerstellung verweigert wird

​
Hosting und Deployment

Stellen Sie OpenClaw auf einem Cloud-Server oder VPS bereit:

VPS

Beliebiger Linux-VPS

Docker VM

Gemeinsame Docker-Schritte

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
Aktualisieren, migrieren oder deinstallieren

Aktualisieren

Halten Sie OpenClaw aktuell.

Migrieren

Auf einen neuen Rechner umziehen.

Deinstallieren

OpenClaw vollständig entfernen.

​
Fehlerbehebung: openclaw nicht gefunden

Wenn die Installation erfolgreich war, openclaw aber in Ihrem Terminal nicht gefunden wird: 
node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?
Wenn $(npm prefix -g)/bin nicht in Ihrem $PATH enthalten ist, fügen Sie es Ihrer Shell-Startdatei (~/.zshrc oder ~/.bashrc) hinzu: 
export PATH="$(npm prefix -g)/bin:$PATH"
Öffnen Sie danach ein neues Terminal. Weitere Details finden Sie unter Node-Einrichtung.