OpenClaw Personal Assistant: In 5 Minuten einrichten

Kennst du das Gefühl, wenn du unterwegs bist und schnell eine Information aus einem Dokument auf deinem Rechner brauchst oder ein Skript starten willst? Normalerweise müsstest du dich mühsam per SSH einwählen oder warten, bis du wieder am Schreibtisch sitzt.

Mit OpenClaw baust du dir deinen eigenen persönlichen Assistenten, der immer nur eine WhatsApp-Nachricht entfernt ist. Er hat Zugriff auf deine Dateien und Tools, während du die volle Kontrolle behältst.

Einen persönlichen Assistenten mit OpenClaw bauen

OpenClaw ist ein selbst gehostetes Gateway, das WhatsApp, Telegram, Discord, iMessage und mehr mit AI-Agents verbindet. Diese Anleitung beschreibt das Setup für einen “persönlichen Assistenten”: Eine dedizierte WhatsApp-Nummer, die sich wie dein ständig verfügbarer KI-Assistent verhält.

⚠️ Sicherheit zuerst

Du bringst einen Agent in eine Position, in der er Folgendes tun kann:

• Befehle auf deinem Rechner ausführen (abhängig von deiner Tool-Policy)
• Dateien in deinem Workspace lesen und schreiben
• Nachrichten über WhatsApp/Telegram/Discord/Mattermost (Plugin) versenden

Starte konservativ:

• Setze immer channels.whatsapp.allowFrom (betreibe niemals ein System, das für die ganze Welt offen ist, auf deinem privaten Mac).
• Nutze eine eigene WhatsApp-Nummer für den Assistenten.
• Heartbeats sind jetzt standardmäßig auf alle 30 Minuten eingestellt. Deaktiviere sie mit agents.defaults.heartbeat.every: "0m", bis du dem Setup vertraust.

Voraussetzungen

• OpenClaw ist installiert und eingerichtet — schau dir Getting Started an, falls du das noch nicht erledigt hast
• Eine zweite Telefonnummer (SIM/eSIM/Prepaid) für den Assistenten

Das Zwei-Handy-Setup (empfohlen)

Das Ziel ist diese Struktur:

flowchart TB
    A["<b>Your Phone (personal)<br></b><br>Your WhatsApp<br>+1-555-YOU"] -- message --> B["<b>Second Phone (assistant)<br></b><br>Assistant WA<br>+1-555-ASSIST"]
    B -- linked via QR --> C["<b>Your Mac (openclaw)<br></b><br>AI agent"]

Wenn du dein privates WhatsApp mit OpenClaw verbindest, wird jede Nachricht an dich zum “Agent-Input”. Das ist fast nie das, was du willst.

5-Minuten Quick Start

1. Kopple WhatsApp Web (scan den QR-Code mit dem Assistenten-Handy):

openclaw channels login

2. Starte das Gateway (lass es laufen):

openclaw gateway --port 18789

3. Erstelle eine minimale Konfiguration in ~/.openclaw/openclaw.json:

{
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

Schreibe jetzt der Assistenten-Nummer von deinem erlaubten Handy aus eine Nachricht.

Sobald das Onboarding abgeschlossen ist, öffnen wir automatisch das Dashboard und zeigen einen sauberen Link an. Falls du nach einer Authentifizierung gefragt wirst, kopiere den Token aus gateway.auth.token in die Control UI Einstellungen. Um es später wieder zu öffnen: openclaw dashboard.

Gib dem Agent einen Workspace (AGENTS)

OpenClaw liest Anweisungen und das “Gedächtnis” aus seinem Workspace-Verzeichnis.

Standardmäßig nutzt OpenClaw ~/.openclaw/workspace als Workspace und erstellt diesen (zusammen mit Starter-Dateien wie AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md) automatisch beim ersten Start. BOOTSTRAP.md wird nur erstellt, wenn der Workspace brandneu ist. MEMORY.md ist optional; falls vorhanden, wird sie für normale Sessions geladen. Subagent-Sessions nutzen nur AGENTS.md und TOOLS.md.

Tipp: Behandle diesen Ordner wie das Gedächtnis von OpenClaw und mache ihn zu einem Git-Repo (am besten privat), damit deine AGENTS.md und Memory-Dateien gesichert sind. Wenn Git installiert ist, werden neue Workspaces automatisch initialisiert.

openclaw setup

Vollständiger Workspace-Layout + Backup-Guide: Agent workspace Memory-Workflow: Memory

Optional: Wähle einen anderen Workspace mit agents.defaults.workspace (unterstützt ~).

{
  agent: {
    workspace: "~/.openclaw/workspace",
  },
}

Wenn du bereits eigene Workspace-Dateien aus einem Repo nutzt, kannst du die Erstellung der Bootstrap-Dateien komplett deaktivieren:

{
  agent: {
    skipBootstrap: true,
  },
}

Die Konfiguration für den “Assistenten-Modus”

OpenClaw ist standardmäßig gut für Assistenten vorkonfiguriert, aber meistens wirst du Folgendes anpassen wollen:

• Persona/Anweisungen in SOUL.md
• Thinking-Defaults
• Heartbeats (sobald du dem System vertraust)

Beispiel:

{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-6",
    workspace: "~/.openclaw/workspace",
    thinkingDefault: "high",
    timeoutSeconds: 1800,
    // Start with 0; enable later.
    heartbeat: { every: "0m" },
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  routing: {
    groupChat: {
      mentionPatterns: ["@openclaw", "openclaw"],
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 10080,
    },
  },
}

Sessions und Memory

• Session-Dateien: ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
• Session-Metadaten (Token-Verbrauch, letztes Routing etc.): ~/.openclaw/agents/<agentId>/sessions/sessions.json (Legacy: ~/.openclaw/sessions/sessions.json)
• /new oder /reset startet eine frische Session für diesen Chat (konfigurierbar über resetTriggers). Wenn der Befehl allein gesendet wird, antwortet der Agent mit einem kurzen Hallo, um den Reset zu bestätigen.
• /compact [Anweisungen] komprimiert den Session-Kontext und zeigt das verbleibende Kontext-Budget an.

Heartbeats (proaktiver Modus)

Standardmäßig führt OpenClaw alle 30 Minuten einen Heartbeat mit folgendem Prompt aus: Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK. Setze agents.defaults.heartbeat.every: "0m", um dies zu deaktivieren.

• Wenn HEARTBEAT.md existiert, aber effektiv leer ist (nur Leerzeilen oder Markdown-Header), überspringt OpenClaw den Heartbeat, um API-Kosten zu sparen.
• Wenn die Datei fehlt, läuft der Heartbeat trotzdem und das Modell entscheidet, was zu tun ist.
• Wenn der Agent mit HEARTBEAT_OK antwortet, unterdrückt OpenClaw die Nachricht nach außen.
• Standardmäßig ist die Heartbeat-Zustellung an DM-Ziele wie user:<id> erlaubt. Setze agents.defaults.heartbeat.directPolicy: "block", um die direkte Zustellung zu unterdrücken, während die Heartbeat-Läufe aktiv bleiben.
• Heartbeats führen volle Agent-Turns aus — kürzere Intervalle verbrauchen mehr Token.

{
  agent: {
    heartbeat: { every: "30m" },
  },
}

Media In und Out

Eingehende Anhänge (Bilder/Audio/Dokumente) können deinem Befehl über Templates zur Verfügung gestellt werden:

• {{MediaPath}} (lokaler Pfad zur temporären Datei)
• {{MediaUrl}} (Pseudo-URL)
• {{Transcript}} (falls Audio-Transkription aktiviert ist)

Ausgehende Anhänge vom Agent: Füge MEDIA:<pfad-oder-url> in einer eigenen Zeile ein (ohne Leerzeichen). Beispiel:

Here’s the screenshot.
MEDIA:https://example.com/screenshot.png

OpenClaw extrahiert diese und sendet sie als Medium zusammen mit dem Text.

Das Verhalten bei lokalen Pfaden folgt demselben Vertrauensmodell wie der Agent:

• Wenn tools.fs.workspaceOnly auf true steht, bleiben ausgehende MEDIA: Pfade auf den OpenClaw Temp-Ordner, den Media-Cache, Workspace-Pfade und Sandbox-Dateien beschränkt.
• Wenn tools.fs.workspaceOnly auf false steht, kann MEDIA: lokale Dateien nutzen, die der Agent bereits lesen darf.
• Es werden nur Medien und sichere Dokumententypen unterstützt (Bilder, Audio, Video, PDF und Office-Dokumente). Klartext oder sensible Dateien werden nicht als sendbare Medien behandelt.

Das bedeutet, dass generierte Bilder oder Dateien außerhalb des Workspaces gesendet werden können, wenn deine FS-Policy das Lesen erlaubt, ohne beliebige Textdateien preiszugeben.

Operations Checkliste

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # adds gateway health probes (Telegram + Discord)
openclaw health --json   # gateway health snapshot (WS)

Logs findest du unter /tmp/openclaw/ (Standard: openclaw-YYYY-MM-DD.log).

Nächste Schritte

• WebChat: WebChat
• Gateway-Betrieb: Gateway runbook
• Cron + Wakeups: Cron jobs
• macOS Menu Bar App: OpenClaw macOS app
• iOS Node App: iOS app
• Android Node App: Android app
• Windows Status: Windows (WSL2)
• Linux Status: Linux app
• Sicherheit: Security

AI Setup Assistant