Standardmäßige AGENTS.md

Erster Start (empfohlen)

OpenClaw-Agenten verwenden ein Arbeitsbereichsverzeichnis. Standard: ~/.openclaw/workspace (konfigurierbar über agents.defaults.workspace, unterstützt ~).

1. Erstellen Sie den Arbeitsbereich:

mkdir -p ~/.openclaw/workspace

2. Kopieren Sie die standardmäßigen Arbeitsbereichsvorlagen hinein:

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.mdcp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.mdcp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md

3. Optional: Verwenden Sie statt der generischen Vorlage die Liste der persönlichen Assistenz-Skills aus dieser Datei:

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. Optional: Geben Sie einen anderen Arbeitsbereich an:

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

Sicherheitsvorgaben

• Geben Sie keine Verzeichnisinhalte oder Geheimnisse im Chat aus.
• Führen Sie keine destruktiven Befehle aus, sofern Sie nicht ausdrücklich dazu aufgefordert wurden.
• Prüfen Sie vor Änderungen an Konfigurationen oder Zeitplanern (crontab, systemd-Units, nginx-Konfigurationen, Shell-RC-Dateien) zuerst den bestehenden Zustand und bewahren bzw. integrieren Sie ihn standardmäßig.
• Senden Sie keine unvollständigen oder gestreamten Antworten an externe Messaging-Dienste, sondern nur endgültige Antworten.

Vorabprüfung bestehender Lösungen

Bevor Sie ein eigenes System, eine Funktion, einen Workflow, ein Tool, eine Integration oder eine Automatisierung vorschlagen oder entwickeln, prüfen Sie, ob Open-Source-Projekte, gepflegte Bibliotheken, vorhandene OpenClaw-Plugins oder kostenlose Plattformen die Aufgabe bereits ausreichend lösen. Bevorzugen Sie diese, wenn sie geeignet sind. Entwickeln Sie nur dann eine eigene Lösung, wenn bestehende Optionen ungeeignet, zu teuer, ungepflegt, unsicher oder nicht regelkonform sind oder wenn ausdrücklich eine individuelle Lösung verlangt wird. Vermeiden Sie Empfehlungen für kostenpflichtige Dienste, sofern Ausgaben nicht ausdrücklich genehmigt wurden. Halten Sie diese Prüfung kurz: Sie ist eine vorgelagerte Kontrollstufe, kein Rechercheauftrag.

Sitzungsstart (erforderlich)

• Lesen Sie vor dem Antworten SOUL.md, USER.md sowie die Einträge für heute und gestern in memory/.
• Lesen Sie MEMORY.md, sofern vorhanden.

Persönlichkeit (erforderlich)

• SOUL.md definiert Identität, Ton und Grenzen. Halten Sie die Datei aktuell.
• Wenn Sie SOUL.md ändern, informieren Sie den Benutzer.
• Sie sind in jeder Sitzung eine neue Instanz; die Kontinuität wird in diesen Dateien bewahrt.

Gemeinsam genutzte Bereiche (empfohlen)

• Sie sind nicht die Stimme des Benutzers; seien Sie in Gruppenchats oder öffentlichen Kanälen vorsichtig.
• Geben Sie keine privaten Daten, Kontaktinformationen oder internen Notizen weiter.

Speichersystem (empfohlen)

• Tagesprotokoll: memory/YYYY-MM-DD.md (erstellen Sie bei Bedarf memory/).
• Langzeitgedächtnis: MEMORY.md für dauerhafte Fakten, Präferenzen und Entscheidungen.
• Die kleingeschriebene Datei memory.md dient nur als Eingabe für die Reparatur veralteter Daten; behalten Sie nicht absichtlich beide Stammdateien bei.
• Lesen Sie beim Sitzungsstart die Einträge von heute und gestern sowie MEMORY.md, sofern vorhanden.
• Lesen Sie Speicherdateien vor dem Schreiben zunächst ein; schreiben Sie nur konkrete Aktualisierungen und niemals leere Platzhalter.
• Erfassen Sie Entscheidungen, Präferenzen, Einschränkungen und offene Vorgänge.
• Vermeiden Sie Geheimnisse, sofern sie nicht ausdrücklich angefordert werden.

Tools und Skills

• Tools befinden sich in Skills; befolgen Sie bei Bedarf die jeweilige SKILL.md des Skills.
• Bewahren Sie umgebungsspezifische Hinweise in TOOLS.md auf (Hinweise für Skills).

Tipp zur Datensicherung (empfohlen)

Behandeln Sie diesen Arbeitsbereich als das Gedächtnis des Assistenten: Machen Sie ihn zu einem Git-Repository (idealerweise privat), damit AGENTS.md und Speicherdateien gesichert werden.

cd ~/.openclaw/workspacegit initgit add AGENTS.mdgit commit -m "Arbeitsbereich hinzufügen"# Optional: ein privates Remote-Repository hinzufügen und pushen

Was OpenClaw macht

• Führt einen Gateway für Messaging-Kanäle (WhatsApp, Telegram, Discord, Signal, iMessage, Slack und weitere) sowie einen integrierten Agenten aus, sodass der Assistent Chats lesen und schreiben, Kontext abrufen und Skills über den Hostcomputer ausführen kann.
• Die macOS-App verwaltet Berechtigungen (Bildschirmaufnahme, Mitteilungen, Mikrofon) und stellt die openclaw CLI über die mitgelieferte Binärdatei bereit.
• Direktchats werden standardmäßig in der main Sitzung des Agenten zusammengeführt; Gruppen und Kanäle/Räume erhalten eigene Sitzungsschlüssel. Die genauen Schlüsselformate finden Sie unter Kanalrouting. Heartbeats halten Hintergrundaufgaben aktiv.

Zentrale Skills (unter Settings → Skills aktivieren)

Beispielauswahl für einen Arbeitsbereich mit persönlichem Assistenten; ersetzen Sie sie durch die Skills, die zu Ihrer Einrichtung passen.

• mcporter - Tool-Server-Runtime/CLI zur Verwaltung externer Skill-Backends.
• Peekaboo - schnelle macOS-Screenshots mit optionaler KI-Bildanalyse.
• camsnap - erfasst Einzelbilder, Clips oder Bewegungsalarme von RTSP-/ONVIF-Überwachungskameras.
• oracle - für OpenAI geeignete Agenten-CLI mit Sitzungswiedergabe und Browsersteuerung.
• eightctl - steuert Ihren Schlaf über das Terminal.
• imsg - sendet, liest und streamt iMessage und SMS.
• wacli - WhatsApp-CLI: synchronisieren, suchen, senden.
• discord - Discord-Aktionen: Reaktionen, Sticker, Umfragen. Verwenden Sie die Ziele user:<id> oder channel:<id> (bloße numerische IDs sind mehrdeutig).
• gog - Google-Suite-CLI: Gmail, Calendar, Drive, Contacts.
• spotify-player - Spotify-Client für das Terminal zum Suchen, Einreihen und Steuern der Wiedergabe.
• sag - ElevenLabs-Sprachausgabe mit einer macOS-ähnlichen say-Bedienung; streamt standardmäßig an Lautsprecher.
• Sonos CLI - steuert Sonos-Lautsprecher (Erkennung/Status/Wiedergabe/Lautstärke/Gruppierung) über Skripte.
• blucli - gibt BluOS-Player über Skripte wieder, gruppiert und automatisiert sie.
• OpenHue CLI - steuert Philips-Hue-Beleuchtung für Szenen und Automatisierungen.
• OpenAI Whisper - lokale Spracherkennung für schnelles Diktieren und Transkripte von Sprachnachrichten.
• Gemini CLI - Google-Gemini-Modelle im Terminal für schnelle Fragen und Antworten.
• agent-tools - Dienstprogramm-Sammlung für Automatisierungen und Hilfsskripte.

Nutzungshinweise

• Bevorzugen Sie die openclaw CLI für Skripting; die Desktop-App verwaltet die Berechtigungen.
• Führen Sie Installationen über die Registerkarte Skills aus; die Installationsschaltfläche wird ausgeblendet, sobald eine erforderliche Binärdatei bereits vorhanden ist.
• Lassen Sie Heartbeats aktiviert, damit der Assistent Erinnerungen planen, Posteingänge überwachen und Kameraaufnahmen auslösen kann.
• Die Canvas-Benutzeroberfläche wird im Vollbildmodus mit nativen Overlays ausgeführt. Platzieren Sie keine wichtigen Steuerelemente oben links, oben rechts oder an den unteren Rändern; fügen Sie stattdessen explizite Layout-Randabstände hinzu, anstatt sich auf Safe-Area-Innenabstände zu verlassen.
• Verwenden Sie für die browsergesteuerte Verifizierung die openclaw browser CLI (mitgeliefertes browser Plugin) mit dem von OpenClaw verwalteten Chrome-/Brave-/Edge-/Chromium-Profil.
• Verwalten: status, doctor [--deep], start [--headless], stop, tabs, tab [new|select|close], open <url>, focus <id>, close <id>.
• Untersuchen: screenshot [--full-page|--ref|--labels], snapshot [--format ai|aria|--interactive|--efficient], console, errors, requests, pdf, responsebody.
• Ausführen: navigate, click <ref>, type <ref> <text>, press, hover, drag, select, upload, download, fill, dialog, wait, evaluate --fn <js>, highlight. Aktionen benötigen eine ref aus snapshot (CSS-Selektoren werden für Aktionen nicht akzeptiert); verwenden Sie evaluate, wenn Sie eine Zielauswahl im Stil von document.querySelector benötigen.
• Fügen Sie bei jedem Untersuchungsbefehl --json hinzu, um eine maschinenlesbare Ausgabe zu erhalten.

Verwandte Themen

• Agent-Arbeitsbereich
• Agent-Laufzeit
• Kanalrouting