OpenClaw CLI für das Nylas Plugin installieren

Was dieser Guide behandelt

OpenClaw ist ein Open-Source-CLI-Framework zum Erstellen KI-gestützter Messaging-Assistenten. Es verbindet sich über ein Plugin-System mit E-Mail, WhatsApp, iMessage und anderen Kanälen, das derzeit über 40 Community-gepflegte Pakete auf npm umfasst. Sie installieren das CLI global per npm, fügen Plugins für die benötigten Integrationen hinzu und konfigurieren jedes über eine JSON-Konfigurationsdatei. Ziel ist es, OpenClaw zu installieren und für die Ausführung des Nylas Plugins für E-Mail, Kalender und Kontakte vorzubereiten.

Schnellstart für Nylas-Nutzer

Der schnellste Weg, Nylas in OpenClaw zum Laufen zu bringen, ist eine 7-Schritte-Sequenz, die auf einem frischen Rechner mit vorinstalliertem Node.js unter 3 Minuten dauert. Die Schritte umfassen die Installation des CLI, das Hinzufügen des Nylas Plugins, die Freigabe für Agent-Sessions und die Verifizierung der Verbindung mit einer Testabfrage gegen Ihre E-Mail-Konten.

Jeder Schritt unten führt einen einzelnen Befehl aus. Die config set-Aufrufe schreiben in OpenClaws JSON-Konfiguration unter ~/.openclaw/config.json, und der Gateway-Neustart übernimmt diese Änderungen, ohne aktive Sessions zu verlieren.

Falls Sie noch keinen Nylas API Key haben, erstellen Sie ein Nylas-Konto vor Schritt 5 und kopieren Sie den API Key in die OpenClaw-Plugin-Konfiguration.

# 1. OpenClaw installieren
npm install -g openclaw

# 2. Prüfen, ob die Binary im PATH liegt
openclaw --version

# 3. Das Nylas Plugin installieren
openclaw plugins install @nylas/openclaw-nylas-plugin

# 4. Plugin freigeben und seine Tools für Agent-Sessions verfügbar machen
openclaw config set 'plugins.allow' '["nylas"]'
openclaw config set 'tools.alsoAllow' '["nylas"]'

# 5. Ihren Nylas API Key konfigurieren
openclaw config set 'plugins.entries.nylas.config.apiKey' 'YOUR_NYLAS_API_KEY'

# 6. Gateway neu starten, damit die Plugin-Konfiguration geladen wird
openclaw gateway restart

# 7. Integration verifizieren
openclaw plugins list
openclaw run "List my connected email accounts" --plugin nylas

Die folgenden Abschnitte erklären jeden Installationsschritt im Detail, behandeln PATH-Korrekturen für gängige Umgebungen und gehen auf die Fehlerbehebung für macOS/Linux und Windows ein.

Wie lautet der npm-Paketname von OpenClaw?

Das OpenClaw CLI wird auf npm unter dem ungescoped Paketnamen openclaw veröffentlicht. Es gibt kein @openclaw/-Scope-Präfix für die Core-CLI-Binary. Plugins folgen einer anderen Konvention und verwenden gescoped Namen wie @nylas/openclaw-nylas-plugin, aber das CLI selbst wird vom Top-Level-Paket openclaw installiert. Das Paket ist seit Anfang 2025 auf npm verfügbar und verzeichnet Stand Mai 2026 über 12.000 wöchentliche Downloads.

npm install -g openclaw platziert die openclaw-Binary in Ihrem globalen npm-bin-Verzeichnis, typischerweise unter $(npm config get prefix)/bin/.

# Der npm-Paketname lautet "openclaw"
npm install -g openclaw

OpenClaw CLI installieren

Die Installation von OpenClaw CLI erfordert Node.js 22.12.0 oder neuer und einen einzelnen npm install -g-Befehl. Die globale Installation platziert die openclaw-Binary in Ihrem System-PATH, sodass sie in jeder Terminal-Session verfügbar ist. Bei einer typischen Breitbandverbindung dauert die vollständige Installation unter 60 Sekunden und lädt etwa 45 MB an Abhängigkeiten herunter.

Prüfen Sie zuerst Ihre Node.js-Version. OpenClaw verwendet native ES Modules und den integrierten Node.js Test Runner, die beide Node.js 22.12.0 als Minimum voraussetzen. Ältere Versionen schlagen beim Start mit einem Syntaxfehler fehl.

# Node.js-Version prüfen (muss 22.12.0+ sein)
node --version

# OpenClaw CLI global installieren
npm install -g openclaw

# Installation verifizieren
openclaw --version

Wenn eine Versionsnummer angezeigt wird, war die Installation erfolgreich. Ein "command not found"-Fehler bedeutet, dass das globale npm-bin-Verzeichnis nicht im PATH liegt — der Abschnitt zur Fehlerbehebung bei PATH-Problemen behandelt genau diesen Fall.

Auf Systemen, auf denen Sie Node.js mit nvm verwalten, stellen Sie sicher, dass die aktive Node-Version 22.12.0 oder höher ist, bevor Sie die Installation ausführen:

# Mit nvm auf Node.js 22 wechseln
nvm install 22
nvm use 22

# Dann openclaw installieren
npm install -g openclaw

Welche Systemanforderungen gelten?

OpenClaw läuft auf macOS (Intel und Apple Silicon), Linux (x64 und arm64) und Windows 10 oder neuer. Die einzige feste Abhängigkeit ist Node.js 22.12.0+, das selbst etwa 80 MB Speicherplatz benötigt. OpenClaw fügt etwa 45 MB für eigene Abhängigkeiten hinzu. Es wird keine native Compiler-Toolchain benötigt, da das CLI reines JavaScript ohne native Add-ons ist.

OpenClaw Plugins installieren

OpenClaw Plugins sind npm-Pakete, die neue Tools, Integrationen und Befehle beim CLI registrieren. Der integrierte Plugin-Manager übernimmt Download, Versionsauflösung und Tool-Registrierung. Stand Mai 2026 umfasst das OpenClaw-Ökosystem über 40 veröffentlichte Plugins für E-Mail, Messaging, CRM und Entwickler-Tooling. Jedes Plugin wird in wenigen Sekunden installiert und nach einem Gateway-Neustart aktiviert.

Die openclaw plugins-Unterbefehle verwalten den gesamten Plugin-Lebenszyklus: install, list, update und uninstall. Nach der Installation eines Plugins oder Änderung der Plugin-Konfiguration führen Sie openclaw gateway restart aus, damit der Gateway-Prozess den neuen Plugin-Zustand lädt.

# Ein Plugin installieren
openclaw plugins install <package-name>

# Beispiel: das Nylas Plugin für E-Mail, Kalender und Kontakte installieren
openclaw plugins install @nylas/openclaw-nylas-plugin

# Installation verifizieren
openclaw plugins list

# Gateway neu starten, damit neue Plugins geladen werden
openclaw gateway restart

Referenz der Plugin-Verwaltungsbefehle

Installierte Plugins auflisten

Der Befehl openclaw plugins list gibt jedes installierte Plugin mit seiner Versionsnummer und dem Status aktiv/inaktiv aus. Die Ausgabe ist eine 3-spaltige Tabelle mit NAME, VERSION und STATUS. Mit dem Flag --json wird maschinenlesbares JSON erzeugt, das Sie an jq weiterleiten oder in einem Skript parsen können — nützlich für CI-Prüfungen, die vor dem Deployment eines Agents ein bestimmtes Plugin-Set verifizieren.

Ein Plugin zeigt "active" an, wenn seine Tools geladen und für Agent-Sessions verfügbar sind. Der Status "inactive" bedeutet, dass das Plugin installiert ist, aber entweder in der Konfiguration deaktiviert wurde oder beim letzten Gateway-Start nicht initialisiert werden konnte.

# Alle installierten Plugins auflisten
openclaw plugins list

# Beispielausgabe:
# NAME                              VERSION  STATUS
# @nylas/openclaw-nylas-plugin      1.2.0    active
# openclaw-whatsapp-bridge          0.9.1    active
# openclaw-imsg                     0.8.3    active

# JSON-Ausgabe für Skripting
openclaw plugins list --json

Plugins deinstallieren

Der Befehl openclaw plugins uninstall entfernt ein Plugin und deregistriert alle seine Tools vom CLI in einem Schritt. Die Deinstallation wird sofort wirksam, ohne dass ein Gateway-Neustart nötig ist, anders als bei der Plugin-Installation. Das npm-Paket des Plugins wird aus dem lokalen Verzeichnis ~/.openclaw/plugins/ gelöscht und gibt den belegten Speicherplatz frei — typischerweise 5-15 MB pro Plugin je nach Abhängigkeiten.

Geben Sie den vollständigen npm-Paketnamen genau so an, wie er bei der Installation verwendet wurde. Führen Sie anschließend openclaw plugins list aus, um zu bestätigen, dass das Plugin nicht mehr aufgeführt wird.

# Ein Plugin deinstallieren
openclaw plugins uninstall @nylas/openclaw-nylas-plugin

# Verifizieren, dass es entfernt wurde
openclaw plugins list

OpenClaw unter Windows

OpenClaw läuft nativ unter Windows 10 und neuer über PowerShell 5.1+. Der Installationspfad unter Windows ist derselbe wie bei macOS und Linux: Node.js 22.12.0 oder neuer installieren, dann npm install -g openclaw ausführen. Laut der Node.js Foundation fügt der Windows-.msi-Installer von nodejs.org Node.js und npm automatisch zum System-PATH hinzu, sodass die OpenClaw-Binary in den meisten Fällen ohne manuelle PATH-Anpassungen verfügbar ist.

# Windows PowerShell Setup
# 1. Node.js 22+ von https://nodejs.org installieren (den LTS-Installer verwenden)

# 2. PowerShell öffnen und Node.js verifizieren
node --version

# 3. OpenClaw global installieren
npm install -g openclaw

# 4. Verifizieren
openclaw --version

# 5. Bei EACCES- oder Berechtigungsfehlern PowerShell als Administrator starten:
# Rechtsklick auf PowerShell → "Als Administrator ausführen"
# Dann erneut: npm install -g openclaw

Unter Windows liegt das OpenClaw-Konfigurationsverzeichnis unter %USERPROFILE%\.openclaw\. Plugins und Konfigurationsdateien befinden sich in diesem Verzeichnis. Stellen Sie sicher, dass Ihr PATH das globale npm-bin-Verzeichnis enthält, das der Node.js-Installer normalerweise automatisch einrichtet.

Optional: iMessage CLI Path Setup

Das Plugin openclaw-imsg verbindet OpenClaw mit iMessage auf macOS. Da die macOS-App-Sandboxing einschränkt, wo Binaries liegen dürfen, kann das Plugin die iMessage-CLI-Binary nicht automatisch erkennen — Sie müssen den Pfad explizit über openclaw config set imsg.cliPath angeben. Dieser zusätzliche Schritt dauert etwa 30 Sekunden und ist nur einmal pro Rechner erforderlich.

Die iMessage-CLI-Binary (imsg-cli) ist ein separates Open-Source-Tool. Wenn Sie es über Homebrew installiert haben, liegt die Binary unter $(brew --prefix)/bin/. Manuelle Installationen platzieren sie typischerweise unter /usr/local/bin/imsg-cli.

# Das iMessage Plugin installieren
openclaw plugins install openclaw-imsg

# Den iMessage-CLI-Binary-Pfad setzen
openclaw config set imsg.cliPath "/usr/local/bin/imsg-cli"

# Falls imsg-cli über Homebrew installiert wurde:
openclaw config set imsg.cliPath "$(brew --prefix)/bin/imsg-cli"

# Prüfen, ob der Pfad gesetzt ist
openclaw config get imsg.cliPath

# iMessage-Verbindung testen
openclaw imsg status

Der Konfigurationswert imsg.cliPath muss auf die tatsächliche Binary zeigen. Wenn das Plugin "command not found"-Fehler meldet, ist der Pfad falsch oder die Binary existiert nicht an diesem Speicherort. Verwenden Sie which imsg-cli, um den korrekten Pfad auf Ihrem System zu finden.

Optional: WhatsApp-Integration

Das Plugin openclaw-whatsapp-bridge verbindet OpenClaw mit der WhatsApp Business API, die laut Metas Geschäftsbericht 2025 über 2 Milliarden monatlich aktive Nutzer bedient. Das Plugin übernimmt Nachrichtenversand, -empfang und Webhook-Registrierung über Metas Cloud API. Sie benötigen ein WhatsApp Business-Konto und ein Access Token aus dem Meta Developer Dashboard. Die Einrichtung dauert etwa 5 Minuten, sobald Ihre Zugangsdaten vorliegen.

Drei Konfigurationswerte sind erforderlich: das Access Token, die Phone Number ID und die Business Account ID. Alle drei finden Sie im Meta Developer Portal unter Ihren WhatsApp-App-Einstellungen.

# Das WhatsApp Bridge Plugin installieren
openclaw plugins install openclaw-whatsapp-bridge

# Ihre WhatsApp Business-Zugangsdaten konfigurieren
openclaw config set whatsapp.accessToken "YOUR_ACCESS_TOKEN"
openclaw config set whatsapp.phoneNumberId "YOUR_PHONE_NUMBER_ID"
openclaw config set whatsapp.businessAccountId "YOUR_BUSINESS_ACCOUNT_ID"

# Konfiguration verifizieren
openclaw whatsapp status

# Testnachricht senden
openclaw whatsapp send --to "+1234567890" --message "Hello from OpenClaw"

Die Phone Number ID identifiziert, welche WhatsApp-Nummer im Namen Ihres Agents Nachrichten sendet. Access Tokens aus dem Meta Developer Portal laufen nach 24 Stunden ab, es sei denn, Sie erstellen ein permanentes Token über die System-Users-Seite in den Business-Einstellungen. Verwenden Sie für Produktiv-Deployments ein permanentes Token, um Authentifizierungsfehler zu vermeiden.

Optional: exec-approvals.json konfigurieren

OpenClaws Exec-Approval-System steuert, welche Shell-Befehle Plugins auf Ihrem Rechner ausführen dürfen. Die Datei exec-approvals.json definiert musterbasierte Regeln mit 3 möglichen Aktionen: allow, deny oder ask (vor der Ausführung nachfragen). Ohne diese Datei fragt OpenClaw standardmäßig bei jedem Shell-Befehl nach, sodass Plugins nichts unbemerkt ausführen können, es sei denn, Sie genehmigen es explizit.

Die Konfigurationsdatei liegt unter ~/.openclaw/exec-approvals.json auf macOS und Linux, bzw. %USERPROFILE%\.openclaw\exec-approvals.json unter Windows. Regeln werden von oben nach unten ausgewertet; das erste passende Muster gewinnt. Das folgende Beispiel zeigt eine typische Konfiguration mit 3 Regeln für Nylas CLI, curl und Dateilöschung.

// Example exec-approvals.json
{
  "version": 1,
  "rules": [
    {
      "pattern": "nylas *",
      "action": "allow",
      "comment": "Allow all Nylas CLI commands"
    },
    {
      "pattern": "curl *",
      "action": "ask",
      "comment": "Prompt before running curl"
    },
    {
      "pattern": "rm *",
      "action": "deny",
      "comment": "Never allow file deletion"
    }
  ],
  "default": "ask"
}

Das Feld default steuert, was passiert, wenn keine Regel zutrifft. Setzen Sie es auf "ask", um bei unbekannten Befehlen gefragt zu werden, "deny", um alles zu blockieren, was nicht explizit erlaubt ist, oder "allow", wenn Sie allen Plugins vollständig vertrauen. Für die meisten Nutzer ist "ask" die sicherste Standardeinstellung.

Sie können die aktuelle Konfiguration mit cat einsehen oder auf die OpenClaw-Standardwerte zurücksetzen. Der Reset-Befehl stellt die werkseitige exec-approvals.json mit der Standardaktion ask und ohne benutzerdefinierte Regeln wieder her.

# Aktuelle Exec-Approvals-Konfiguration anzeigen
cat ~/.openclaw/exec-approvals.json

# Auf Standardwerte zurücksetzen
openclaw config reset exec-approvals

Das Nylas Plugin hinzufügen

Das @nylas/openclaw-nylas-plugin fügt native E-Mail-, Kalender- und Kontakte-Tools zu OpenClaw hinzu. Das Nylas Plugin unterstützt 6 E-Mail-Anbieter — Gmail, Outlook, Exchange, Yahoo, iCloud und IMAP — über eine einzige API. Es registriert über 20 Tools bei OpenClaw für Nachrichten-CRUD, Kalendertermin-Verwaltung, Kontaktsuche und Anhangverarbeitung.

Die Installation erfordert den npm-Paketnamen, einen Nylas API Key (von dashboard.nylas.com) und einen Gateway-Neustart. Der API Key wird in OpenClaws lokaler Konfigurationsdatei gespeichert und verlässt nie Ihren Rechner.

# Das Nylas Plugin installieren
openclaw plugins install @nylas/openclaw-nylas-plugin

# Ihren Nylas API Key konfigurieren
openclaw config set 'plugins.entries.nylas.config.apiKey' 'YOUR_NYLAS_API_KEY'

# Gateway neu starten, damit die Plugin-Konfiguration geladen wird
openclaw gateway restart

# Verifizieren, dass das Plugin Ihre verbundenen Konten sehen kann
openclaw run "List my connected email accounts" --plugin nylas

Für Multi-Account-Einrichtung, die vollständige Tool-Referenztabelle und anbieterspezifische Fehlerbehebung lesen Sie den Guide Install the OpenClaw Nylas Plugin.

Fehlerbehebung: "command not found" nach npm install -g

Ein "command not found"-Fehler nach npm install -g openclaw bedeutet, dass das globale npm-bin-Verzeichnis nicht im PATH der Shell liegt. Dies ist das häufigste Problem nach der Installation und betrifft etwa jeden fünften Nutzer unter Linux und macOS, bei denen Node.js über nvm oder einen manuellen Tarball installiert wurde. Die Lösung besteht darin, das npm-Präfixverzeichnis zu finden und dessen bin/-Unterverzeichnis an Ihr Shell-Profil anzuhängen.

Führen Sie npm config get prefix aus, um das Verzeichnis auszugeben. Bei einer Standard-nvm-Installation liegt das Präfix typischerweise unter ~/.nvm/versions/node/v22.x.x. Die openclaw-Binary befindet sich unter <prefix>/bin/openclaw.

# Herausfinden, wohin npm globale Binaries installiert
npm config get prefix

# Die Binary liegt unter <prefix>/bin/openclaw
# Das bin-Verzeichnis zum PATH hinzufügen

# Für bash (~/.bashrc):
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Für zsh (~/.zshrc):
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Prüfen, ob es funktioniert
openclaw --version

Wenn Sie nvm verwenden, ändert sich das globale Präfix beim Wechsel der Node-Version. Stellen Sie sicher, dass Sie OpenClaw unter der Node-Version installieren, die Sie täglich nutzen. nvm use 22 && npm install -g openclaw stellt sicher, dass die Binary immer verfügbar ist, wenn Node 22 aktiv ist.

Fehlerbehebung: Plugin-Installation schlägt fehl

Fehlgeschlagene Plugin-Installationen über openclaw plugins install fallen in 3 Kategorien: npm-Versionsinkompatibilität, Netzwerk-/Proxy-Fehler und Dateiberechtigungsfehler. Die häufigste Ursache ist npm 9 oder älter, dem die Dependency-Resolution-Features fehlen, auf die OpenClaw Plugins angewiesen sind. npm 10+ wird standardmäßig mit Node.js 22 ausgeliefert. Die folgenden Schritte behandeln jede Fehlerart in der Reihenfolge ihrer Wahrscheinlichkeit.

Prüfen Sie zuerst Ihre Node.js- und npm-Versionen. Wenn beide aktuell sind, leeren Sie den npm-Cache und versuchen Sie es erneut. Unternehmens-Proxy- und Dateibesitzprobleme sind seltener, machen aber etwa 15 % der gemeldeten Installationsfehler im OpenClaw GitHub Issues Tracker aus.

# 1. Node.js- und npm-Versionen prüfen
node --version   # Muss 22.12.0+ sein
npm --version    # Muss 10+ sein

# 2. npm-Cache leeren
npm cache clean --force

# 3. Installation erneut versuchen
openclaw plugins install @nylas/openclaw-nylas-plugin

# 4. Hinter einem Unternehmens-Proxy npm konfigurieren
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

# 5. Bei Berechtigungsfehlern unter macOS/Linux den npm-Präfixbesitz korrigieren
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

Fehlerbehebung: Plugin installiert, aber wird nicht geladen

Wenn openclaw plugins list ein Plugin als "active" anzeigt, seine Tools oder Befehle aber während Agent-Sessions nicht verfügbar sind, konnte das Plugin wahrscheinlich beim Start nicht initialisiert werden. Dies kann passieren, wenn erforderliche Konfigurationswerte des Plugins fehlen oder ein Dependency-Konflikt das Laden des Plugin-Einstiegspunkts verhindert. Das Flag --debug schreibt detaillierte Initialisierungsprotokolle nach stderr, einschließlich der genauen Fehlermeldung des fehlgeschlagenen Plugins.

Eine Neuinstallation des Plugins erzwingt einen frischen Download und registriert die Tools des Plugins erneut bei OpenClaw. Der Deinstallations- und Installationszyklus dauert bei den meisten Verbindungen unter 10 Sekunden.

# Debug-Logs auf Plugin-Fehler prüfen
openclaw --debug 2>&1 | grep -i plugin

# Das problematische Plugin neu installieren
openclaw plugins uninstall <package-name>
openclaw plugins install <package-name>

# Verifizieren, dass es korrekt geladen wird
openclaw plugins list

Nächste Schritte

Mit installiertem OpenClaw und registriertem Nylas Plugin ist das CLI bereit für E-Mail-, Kalender- und Kontakte-Automatisierung. Die folgenden Guides behandeln Plugin-Konfiguration im Detail, Agent-Konstruktionsmuster und Fehlerbehebung für die häufigsten OpenClaw-Probleme.

• Install the OpenClaw Nylas Plugin — E-Mail-, Kalender- und Kontakte-Tools mit typisierten Schemas und Auto-Discovery hinzufügen
• Build a Personal Assistant with Nylas CLI and OpenClaw — der exec-basierte Ansatz mit direkten Shell-Befehlen
• Secure OpenClaw Email Access — Plugin-Allowlists, Zugangsdaten, Richtlinien und Sendegenehmigungen absichern
• AI Agent CLI for Email and Calendar — subprocess-basierte E-Mail- und Kalender-Tools für benutzerdefinierte Agents erstellen
• Fix OpenClaw CLI Errors — PATH-, npm-Berechtigungs-, Node.js-Versions- und Windows-Setup-Probleme beheben
• Nylas CLI Command Reference — vollständige Referenz für alle Befehle, Flags und Optionen