7.1 KiB
| read_when | summary | title | x-i18n | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
OpenClaw installieren — Installer-Skript, npm/pnpm/bun, aus dem Quellcode, Docker und mehr | Installation |
|
Systemanforderungen
- Node 24 (empfohlen) oder Node 22.14+ — das Installer-Skript übernimmt dies automatisch
- macOS, Linux oder Windows — sowohl natives Windows als auch WSL2 werden unterstützt; WSL2 ist stabiler. Siehe Windows.
pnpmwird nur benötigt, wenn Sie aus dem Quellcode bauen
Empfohlen: Installer-Skript
Der schnellste Weg zur Installation. Es erkennt Ihr Betriebssystem, installiert bei Bedarf Node, installiert OpenClaw und startet das Onboarding.
```bash curl -fsSL https://openclaw.ai/install.sh | bash ``` ```powershell iwr -useb https://openclaw.ai/install.ps1 | iex ```Installation ohne Onboarding:
```bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard ```Alle Flags sowie Optionen für CI/Automatisierung finden Sie unter Installer internals.
Alternative Installationsmethoden
Installer mit lokalem Präfix (install-cli.sh)
Verwenden Sie dies, wenn Sie OpenClaw und Node unter einem lokalen Präfix wie
~/.openclaw halten möchten, ohne von einer systemweiten Node-Installation abhängig zu sein:
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Standardmäßig unterstützt es npm-Installationen sowie Installationen aus einem Git-Checkout innerhalb desselben Präfix-Flows. Vollständige Referenz: Installer internals.
Bereits installiert? Wechseln Sie zwischen Paket- und Git-Installationen mit
openclaw update --channel dev und openclaw update --channel stable. Siehe
Aktualisieren.
npm, pnpm oder bun
Wenn Sie Node bereits selbst verwalten:
```bash npm install -g openclaw@latest openclaw onboard --install-daemon ``` ```bash pnpm add -g openclaw@latest pnpm approve-builds -g openclaw onboard --install-daemon ```<Note>
pnpm erfordert eine explizite Genehmigung für Pakete mit Build-Skripten. Führen Sie nach der ersten Installation `pnpm approve-builds -g` aus.
</Note>
```bash
bun add -g openclaw@latest
openclaw onboard --install-daemon
```
<Note>
Bun wird für den globalen CLI-Installationspfad unterstützt. Für die Gateway-Laufzeit bleibt Node die empfohlene Daemon-Laufzeit.
</Note>
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 heraus arbeiten 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 das Linken und verwenden Sie pnpm openclaw ... innerhalb des Repositorys. Vollständige Entwicklungs-Workflows finden Sie unter Setup.
Von GitHub main installieren
npm install -g github:openclaw/openclaw#main
Container und Paketmanager
Containerisierte oder headless Deployments. Rootless-Container-Alternative zu Docker. Deklarative Installation über Nix Flake. Automatisierte Bereitstellung für Flotten. Nur-CLI-Nutzung über die Bun-Laufzeit.Installation überprüfen
openclaw --version # prüfen, ob die CLI verfügbar ist
openclaw doctor # auf Konfigurationsprobleme prüfen
openclaw gateway status # prüfen, ob das Gateway läuft
Wenn Sie nach der Installation einen verwalteten Start möchten:
- macOS: LaunchAgent über
openclaw onboard --install-daemonoderopenclaw gateway install - Linux/WSL2: systemd-Benutzerdienst über dieselben Befehle
- Natives Windows: zuerst Scheduled Task, mit Fallback auf ein Login-Element im benutzerspezifischen Startup-Ordner, falls die Task-Erstellung verweigert wird
Hosting und Bereitstellung
Stellen Sie OpenClaw auf einem Cloud-Server oder VPS bereit:
Beliebiger Linux-VPS Gemeinsame Docker-Schritte K8s Fly.io Hetzner Google Cloud Azure Railway Render NorthflankAktualisieren, migrieren oder deinstallieren
OpenClaw aktuell halten. Auf einen neuen Rechner umziehen. OpenClaw vollständig entfernen.Fehlerbehebung: openclaw nicht gefunden
Wenn die Installation erfolgreich war, openclaw aber in Ihrem Terminal nicht gefunden wird:
node -v # Ist Node installiert?
npm prefix -g # Wo sind globale Pakete?
echo "$PATH" # Ist das globale bin-Verzeichnis in PATH?
Wenn $(npm prefix -g)/bin nicht in Ihrem $PATH ist, fügen Sie es Ihrer Shell-Startdatei (~/.zshrc oder ~/.bashrc) hinzu:
export PATH="$(npm prefix -g)/bin:$PATH"
Öffnen Sie dann ein neues Terminal. Weitere Details finden Sie unter Node setup.