OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Guides

Einrichtung des persönlichen Assistenten

OpenClaw ist ein selbst gehosteter Gateway, der Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo und weitere Dienste mit KI-Agenten verbindet. Diese Anleitung beschreibt die Einrichtung als „persönlicher Assistent“: eine dedizierte WhatsApp-Nummer, die sich wie Ihr ständig verfügbarer KI-Assistent verhält.

Sicherheit zuerst

Wenn Sie einem Agenten einen Kanal bereitstellen, kann er dadurch Befehle auf Ihrem Computer ausführen (abhängig von Ihren Tool-Richtlinien), Dateien in Ihrem Arbeitsbereich lesen und schreiben sowie Nachrichten über jeden verbundenen Kanal senden. Beginnen Sie mit restriktiven Einstellungen:

  • Legen Sie immer channels.whatsapp.allowFrom fest (betreiben Sie den Dienst auf Ihrem persönlichen Mac niemals offen für die ganze Welt).
  • Verwenden Sie eine dedizierte WhatsApp-Nummer für den Assistenten.
  • Heartbeats werden standardmäßig alle 30 Minuten ausgeführt. Deaktivieren Sie sie, bis Sie der Einrichtung vertrauen, indem Sie agents.defaults.heartbeat.every: "0m" festlegen.

Voraussetzungen

  • OpenClaw ist installiert und die Ersteinrichtung wurde abgeschlossen – siehe Erste Schritte, falls Sie dies noch nicht getan haben
  • Eine zweite Telefonnummer (SIM/eSIM/Prepaid) für den Assistenten

Einrichtung mit zwei Telefonen (empfohlen)

Das gewünschte Ergebnis:

flowchart TB
    A["<b>Ihr Telefon (persönlich)<br></b><br>Ihr WhatsApp<br>+1-555-YOU"] -- Nachricht --> B["<b>Zweites Telefon (Assistent)<br></b><br>Assistenten-WA<br>+1-555-ASSIST"]
    B -- per QR verknüpft --> C["<b>Ihr Mac (openclaw)<br></b><br>KI-Agent"]

Wenn Sie Ihr persönliches WhatsApp mit OpenClaw verknüpfen, wird jede Nachricht an Sie zur „Agenteneingabe“. Das ist nur selten erwünscht.

Schnellstart in 5 Minuten

  1. Koppeln Sie WhatsApp Web (ein QR-Code wird angezeigt; scannen Sie ihn mit dem Telefon des Assistenten):
bash
openclaw channels login
  1. Starten Sie den Gateway (lassen Sie ihn weiterlaufen):
bash
openclaw gateway --port 18789
  1. Fügen Sie eine Minimalkonfiguration in ~/.openclaw/openclaw.json ein:
json5
{  gateway: { mode: "local" },  channels: { whatsapp: { allowFrom: ["+15555550123"] } },}

Senden Sie nun von Ihrem in der Zulassungsliste eingetragenen Telefon eine Nachricht an die Nummer des Assistenten.

Nach Abschluss der Ersteinrichtung öffnet OpenClaw automatisch das Dashboard und gibt einen bereinigten Link (ohne Token) aus. Wenn das Dashboard Sie zur Authentifizierung auffordert, fügen Sie das konfigurierte gemeinsame Geheimnis in die Einstellungen der Control UI ein. Die Ersteinrichtung verwendet standardmäßig ein Token (gateway.auth.token), aber die Passwortauthentifizierung funktioniert ebenfalls, wenn Sie gateway.auth.mode auf password umgestellt haben. So öffnen Sie das Dashboard später erneut: openclaw dashboard.

Dem Agenten einen Arbeitsbereich bereitstellen (AGENTS)

OpenClaw liest Betriebsanweisungen und den „Speicher“ aus seinem Arbeitsbereichsverzeichnis.

Standardmäßig verwendet OpenClaw ~/.openclaw/workspace als Arbeitsbereich des Agenten und erstellt ihn (einschließlich der anfänglichen Dateien AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md und HEARTBEAT.md) automatisch während der Ersteinrichtung oder bei der ersten Ausführung des Agenten. BOOTSTRAP.md wird nur für einen vollkommen neuen Arbeitsbereich erstellt und sollte nach dem Löschen nicht erneut erscheinen. MEMORY.md ist optional und wird nie automatisch erstellt; wenn die Datei vorhanden ist, wird sie für normale Sitzungen geladen. In Subagentensitzungen werden nur AGENTS.md und TOOLS.md eingefügt.

So erstellen Sie die Arbeitsbereichs- und Konfigurationsordner, ohne den vollständigen Assistenten für die Ersteinrichtung auszuführen:

bash
openclaw setup --baseline

(Der einfache Befehl openclaw setup ist ein Alias für openclaw onboard und führt den vollständigen interaktiven Assistenten aus.)

Vollständige Arbeitsbereichsstruktur und Sicherungsanleitung: Agentenarbeitsbereich Speicher-Workflow: Speicher

Optional: Wählen Sie mit agents.defaults.workspace einen anderen Arbeitsbereich aus (unterstützt ~).

json5
{  agents: {    defaults: {      workspace: "~/.openclaw/workspace",    },  },}

Wenn Sie bereits Ihre eigenen Workspace-Dateien aus einem Repository bereitstellen, können Sie die Erstellung von Bootstrap-Dateien vollständig deaktivieren:

json5
{  agents: {    defaults: {      skipBootstrap: true,    },  },}

Die Konfiguration, die daraus „einen Assistenten“ macht

OpenClaw verfügt standardmäßig über eine gute Assistentenkonfiguration, üblicherweise sollten Sie jedoch Folgendes anpassen:

  • Persona/Anweisungen in SOUL.md
  • Standardwerte für das Denken (falls gewünscht)
  • Heartbeats (sobald Sie OpenClaw vertrauen)

Beispiel:

json5
{  logging: { level: "info" },  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-8" },      workspace: "~/.openclaw/workspace",      thinkingDefault: "high",      timeoutSeconds: 1800,      // Beginnen Sie mit 0; aktivieren Sie dies später.      heartbeat: { every: "0m" },    },    list: [      {        id: "main",        default: true,        groupChat: {          mentionPatterns: ["@openclaw", "openclaw"],        },      },    ],  },  channels: {    whatsapp: {      allowFrom: ["+15555550123"],      groups: {        "*": { requireMention: true },      },    },  },  session: {    scope: "per-sender",    resetTriggers: ["/new", "/reset"],    reset: {      mode: "daily",      atHour: 4,      idleMinutes: 10080,    },  },}

Sitzungen und Speicher

  • Sitzungszeilen, Transkriptzeilen und Metadaten (Token-Nutzung, letzte Route usw.): ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite
  • Legacy-/Archiv-Transkriptartefakte: ~/.openclaw/agents/<agentId>/sessions/
  • Quelle für die Migration von Legacy-Zeilen: ~/.openclaw/agents/<agentId>/sessions/sessions.json
  • /new oder /reset startet eine neue Sitzung für diesen Chat (konfigurierbar über session.resetTriggers). Wird der Befehl allein gesendet, bestätigt OpenClaw das Zurücksetzen, ohne das Modell aufzurufen.
  • /compact [instructions] komprimiert den Sitzungskontext und gibt das verbleibende Kontextbudget 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. Setzen Sie agents.defaults.heartbeat.every: "0m", um ihn zu deaktivieren.

  • Wenn HEARTBEAT.md vorhanden, aber praktisch leer ist (nur Leerzeilen, Markdown-/HTML-Kommentare, Markdown-Überschriften wie # Heading, Codeblock-Begrenzungszeichen oder leere Checklisten-Platzhalter enthält), überspringt OpenClaw den Heartbeat-Durchlauf, um API-Aufrufe einzusparen.
  • Wenn die Datei fehlt, wird der Heartbeat dennoch ausgeführt, und das Modell entscheidet, was zu tun ist.
  • Wenn der Agent mit HEARTBEAT_OK antwortet (optional mit kurzem Zusatz; siehe agents.defaults.heartbeat.ackMaxChars), unterdrückt OpenClaw die ausgehende Zustellung für diesen Heartbeat.
  • Standardmäßig ist die Heartbeat-Zustellung an DM-ähnliche user:<id>-Ziele zulässig. Legen Sie agents.defaults.heartbeat.directPolicy: "block" fest, um die Zustellung an direkte Ziele zu unterdrücken, während die Heartbeat-Durchläufe aktiv bleiben.
  • Heartbeats führen vollständige Agent-Durchläufe aus – kürzere Intervalle verbrauchen mehr Token.
json5
{  agents: {    defaults: {      heartbeat: { every: "30m" },    },  },}

Medien empfangen und senden

Eingehende Anhänge (Bilder/Audio/Dokumente) können Ihrem Befehl über Vorlagen bereitgestellt werden:

  • {{MediaPath}} (lokaler temporärer Dateipfad)
  • {{MediaUrl}} (Pseudo-URL)
  • {{Transcript}} (wenn die Audiotranskription aktiviert ist)

Ausgehende Anhänge des Agenten verwenden strukturierte Medienfelder im Nachrichten-Tool oder in der Antwortnutzlast, etwa media, mediaUrl, mediaUrls, path oder filePath. Beispielargumente für das Nachrichten-Tool:

json
{  "message": "Hier ist der Screenshot.",  "mediaUrl": "https://example.com/screenshot.png"}

OpenClaw sendet strukturierte Medien zusammen mit dem Text. Ältere abschließende Assistentenantworten können aus Kompatibilitätsgründen weiterhin normalisiert werden, aber Tool-Ausgaben, Browser-Ausgaben, Streaming-Blöcke und Nachrichtenaktionen interpretieren Text nicht als Anhangsbefehle.

Das Verhalten lokaler Pfade folgt demselben Vertrauensmodell für Dateizugriffe wie der Agent:

  • Wenn tools.fs.workspaceOnly den Wert true hat, bleiben ausgehende lokale Medienpfade auf das temporäre Stammverzeichnis von OpenClaw, den Mediencache, Pfade im Arbeitsbereich des Agenten und in der Sandbox erzeugte Dateien beschränkt.
  • Wenn tools.fs.workspaceOnly den Wert false hat, können ausgehende lokale Medien Dateien auf dem Host verwenden, die der Agent bereits lesen darf.
  • Lokale Pfade können absolut, relativ zum Arbeitsbereich oder mit ~/ relativ zum Home-Verzeichnis angegeben werden.
  • Beim Senden hostlokaler Dateien sind weiterhin nur Medien und sichere Dokumenttypen zulässig (Bilder, Audio, Video, PDF, Office-Dokumente und validierte Textdokumente wie Markdown/MD, TXT, JSON, YAML und YML). Dies ist eine Erweiterung der bestehenden Vertrauensgrenze für Lesezugriffe auf den Host und kein Scanner für Geheimnisse: Wenn der Agent eine hostlokale Datei secret.txt oder config.json lesen kann, kann er diese Datei anhängen, sofern Dateierweiterung und Inhaltsvalidierung übereinstimmen.

Bewahren Sie vertrauliche Dateien außerhalb des für den Agenten lesbaren Dateisystems auf oder verwenden Sie für strengere Sendebeschränkungen bei lokalen Pfaden weiterhin tools.fs.workspaceOnly: true.

Betriebscheckliste

bash
openclaw status          # lokaler Status (Anmeldedaten, Sitzungen, Ereignisse in der Warteschlange)openclaw status --all    # vollständige Diagnose (schreibgeschützt, zum Einfügen geeignet)openclaw status --deep   # Kanäle prüfen (WhatsApp Web + Telegram + Discord + Slack + Signal)openclaw health --json   # Momentaufnahme des Gateway-Zustands über die WS-Verbindung

Protokolle befinden sich unter /tmp/openclaw/ (Standard: openclaw-YYYY-MM-DD.log).

Nächste Schritte

Verwandte Themen

Was this useful?
On this page

On this page