Desktop-Integration

OpenClaw Einrichtungsanleitung

Gib Ami die Fähigkeit, deinen Desktop zu steuern — Notizen, Erinnerungen, Kalender, Musik und mehr.

Datenschutzhinweis: OpenClaw läuft vollständig auf deinem Gerät. Dein Gateway-Token verlässt nie deine Maschine.

In dieser Anleitung

Voraussetzungen OpenClaw installieren Gateway starten Ami mit OpenClaw verbinden Arbeitsbereich einrichten Verfügbare Tools Fehlerbehebung OpenClaw aktualisieren Architektur

Voraussetzungen

macOS wird für Apple Notes, Erinnerungen, Kalender und Musik benötigt.

Node.js 22+ — prüfe mit node --version

Falls du Node 22+ nicht hast:

bash

brew install node@22

Step 1

OpenClaw installieren

Führe das Installationsskript in deinem Terminal aus:

bash

curl -fsSL https://openclaw.ai/install.sh | bash

Dies installiert die CLI und startet den Einrichtungsassistenten automatisch.

Installation überprüfen

bash

openclaw doctor

openclaw wird nicht gefunden, füge es deinem PATH hinzu:

bash

echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Step 2

Gateway starten

Der Assistent installiert einen Hintergrunddienst. Um zu prüfen, ob er läuft:

bash

openclaw gateway status

Falls du ihn manuell starten musst:

bash

openclaw gateway --port 18789

Finde deinen Gateway-Token

Dein Token ist in ~/.openclaw/openclaw.json unter gateway.auth.token. Du kannst ihn anzeigen mit:

bash

cat ~/.openclaw/openclaw.json | grep '"token"' | head -1

Bewahre diesen Token auf — du brauchst ihn im nächsten Schritt.

Step 3

Ami mit OpenClaw verbinden

Öffne die Ami-App und gehe zu Einstellungen
Scrolle zum Bereich Erweitert
Klappe OpenClaw Gateway auf
Fülle die Felder aus:

Feld	Wert
Gateway URL	`ws://127.0.0.1:18789`
Gateway Token	(Token aus Schritt 2 einfügen)

5. Aktiviere Web-Chat über OpenClaw leiten

6. Klicke auf Speichern

Optionale Einstellungen

Einstellung	Funktion
Identität synchronisieren	Sendet Amis Name und Persönlichkeit an das Gateway für andere Kanäle
Erinnerungen abrufen	Importiert Erinnerungen aus dem Arbeitsbereich beim Laden des Charakters
Erinnerungen senden	Synchronisiert App-Erinnerungen automatisch alle 10 Minuten

Step 4

Arbeitsbereich einrichten

OpenClaw nutzt einen Arbeitsordner. Der Standardpfad ist ~/.openclaw/workspace-ami/

Er sollte zwei Dateien enthalten:

SOUL.md — Persönlichkeit

Diese Datei wird automatisch synchronisiert. Sie definiert, wer Ami ist und wie sie antwortet.

~/.openclaw/workspace-ami/SOUL.md

TOOLS.md — Tool-Anweisungen

Amis Spickzettel für die Verwendung von macOS Tools. Sollte bereits eingerichtet sein.

~/.openclaw/workspace-ami/TOOLS.md

Die Datei enthält osascript Befehle für jedes Tool.

Verfügbare Tools

Sobald verbunden, kannst du Ami bitten:

Apple Notizen

“Schreib mir eine Notiz über Einkaufsideen”

“Speichere eine Notiz mit dem Titel Wochenendpläne”

Erinnerungen

“Erinnere mich um 15 Uhr an den Zahnarzt”

“Setze eine Erinnerung zum Blumengießen”

Kalender

“Was steht heute an?”

“Füge ein Meeting mit Jake am Freitag um 14 Uhr hinzu”

Musik

“Spiel etwas Musik”

“Pausiere die Musik”

“Nächster Song”

“Was läuft gerade?”

Systemsteuerung

“Dunkelmodus aktivieren”

“Timer auf 5 Minuten”

“Wie ist mein Akkustand?”

Apps und URLs öffnen

“Öffne Safari”

“Öffne twitter.com”

Fehlerbehebung

OpenClaw aktualisieren

bash

npm update -g openclaw

Oder führe den Installer erneut aus:

bash

curl -fsSL https://openclaw.ai/install.sh | bash

Architektur

Für Neugierige — so kommuniziert Ami mit deinem Desktop:

┌──────────────┐     WebSocket      ┌──────────────────┐     osascript     ┌──────────────┐
│   Ami App    │ ──────────────────► │ OpenClaw Gateway │ ────────────────► │  macOS APIs  │
│  (browser)   │ ◄────────────────── │  (localhost)     │ ◄──────────────── │ Notes, Music │
│              │    SSE streaming    │  Port 18789      │    tool results   │ Calendar etc │
└──────────────┘                     └──────────────────┘                   └──────────────┘
                                            │
                                     ┌──────┴──────┐
                                     │  Workspace  │
                                     │  SOUL.md    │
                                     │  TOOLS.md   │
                                     └─────────────┘

1. Du sendest eine Nachricht an Ami im Browser

2. Die App erkennt Tool-Anfragen und zeigt sofort eine Vorschau

3. Die Nachricht wird über das OpenClaw Gateway per WebSocket geleitet

4. Der Agent liest TOOLS.md und führt den passenden osascript-Befehl aus

5. Der Agent antwortet mit Bestätigung, die Ami dir zurückspricht

Bereit loszulegen?

Installiere OpenClaw, verbinde Ami und steuere deinen Desktop mit natürlicher Sprache.

App öffnen