OpenClaw-Konfigurationsverzeichnis

OpenClaw (auch bekannt als Clawdbot) bündelt seine gesamte Konfiguration, Zustandsdaten, Arbeitsbereiche und Skills im Kernverzeichnis ~/.openclaw/ (Linux/macOS) oder %USERPROFILE%\.openclaw\ (Windows) unter dem Home-Verzeichnis des Benutzers.

~/.openclaw/ist das Stamm-Konfigurationsverzeichnis des gesamten Systems; bei der ersten Installation/Ausführung wird es durchopenclaw onboardoderopenclaw onboard --install-daemonautomatisch erstellt.

~/.openclaw/
├── openclaw.json                 # 主配置文件（JSON/JSON5）
├── workspace/                    # 你的 AI “灵魂”文件夹（推荐 git 版本控制）
│   ├── SOUL.md                   # 人格设定（语气、风格）
│   ├── USER.md                   # 你的个人信息（让 AI 更懂你）
│   ├── MEMORY.md                 # 长期记忆（手动可编辑）
│   ├── IDENTITY.md               # Agent 名称、形象
│   ├── AGENTS.md                 # 多 Agent 路由规则
│   ├── BOOT.md                   # 启动提示词
│   ├── HEARTBEAT.md              # 每日检查清单
│   └── skills/                   # 已安装技能（每个技能一个子文件夹）
├── agents/<cid>/                 # 每个 Agent 的独立状态
├── memory/<cid>.sqlite           # 向量记忆库
├── credentials/                  # API Key、OAuth（旧版）
├── skills/                       # 全局技能包
└── secrets.json                  # 加密凭证（可选）

Wichtigste Dateien：

  • openclaw.json: Globale Einstellungen (Modell, Kanäle, Ports, Sicherheitsrichtlinien)
  • workspace/alle unter.mdDateien:Sie können sie direkt mit VS Code bearbeiten, und die Änderungen werden in Echtzeit wirksam.！

Befehl zum Anzeigen/Ändern der Konfiguration:

openclaw configure      # 交互式配置向导
openclaw config file          # 显示完整路径
openclaw config get agent.model
openclaw config set agent.model "anthropic/claude-3-5-sonnet"
openclaw config validate      # 校验合法性
Pfad Zweckbeschreibung
~/.openclaw/openclaw.json Hauptkonfigurationsdatei(Am wichtigsten!)
Speichert globale Einstellungen (Modell, Gateway-Modus, Bind-Adresse, Standardwerte der Agents, Plugins usw.).
Kann mit dem Befehl angezeigt/geändert werden:
• openclaw config file(zeigt den vollständigen Pfad an)
• openclaw config get <json路径>
• openclaw config set <json路径> <值>
~/.openclaw/workspace/ Standard-Arbeitsbereich(Der Ort der "Seele" des Agenten)
Speichert die folgenden Markdown-Dateien (können direkt bearbeitet werden und werden wirksam):
• SOUL.md: KI-Persönlichkeits-/Ton-Einstellungen
• USER.md: Ihre persönlichen Präferenzen und Ihr Hintergrund
• MEMORY.md: Langzeitgedächtnis-Aufzeichnungen
• AGENTS.md: Anweisungsbeschreibungen
• IDENTITY.md: Name/Theme
• BOOT.md: Startkonfiguration
• HEARTBEAT.md: Periodische Checkliste
~/.openclaw/agents/<cid>/ Statusverzeichnis eines einzelnen Agenten (<cid>für Instanz-ID)
~/.openclaw/agents/<agentId>/agent/auth-profiles.json API-Key & OAuth-Anmeldedaten(empfohlener Speicherort in der neuen Version)
Die Legacy-Version kann sich in~/.openclaw/credentials/
~/.openclaw/memory/<cid>.sqlite Vektorindex-Speicher (für die Speichersuche)
~/.openclaw/skills/ Globales Skill-Verzeichnis
Überopenclaw skills installoderclawhub installAlle installierten Skill-Pakete werden hier abgelegt (jeder Skill ist ein Unterordner, der SKILL.md enthält)
~/.openclaw/memory/ Dateien im Zusammenhang mit dem Langzeitgedächtnis (SQLite + Vektor-Embeddings)
/tmp/openclaw/*.log Gateway-Dienst-Protokolle (zum Debuggen)

1. Hauptkonfigurationsdatei

Pfad: ~/.openclaw/openclaw.json

Beschreibung:OpenClaws zentrale Konfigurationsdatei, die alle Einstellungen auf Systemebene enthält.

Hauptkonfigurationselemente:

  • gateway- Gateway-Dienstkonfiguration
    • mode: Gateway-Modus (z. B. "local")
    • port: Gateway-Port (Standard 18789)
    • bind: Bind-Adresse (Standard 127.0.0.1)
    • token: Zugriffstoken, verwendet für die Web-UI-Authentifizierung
  • models- KI-Modellkonfiguration
    • Standardmodell-Einstellungen
    • API-Authentifizierungsinformationen
  • messages- Konfiguration der Nachrichtenverarbeitung
    • TTS-Einstellungen (Text-to-Speech)
    • Nachrichtenformat-Konfiguration

Beispielkonfigurationsausschnitt:

{
  "gateway": {
    "mode": "local",
    "port": 18789,
    "bind": "127.0.0.1",
    "token": "c9917c5a066beeb26266d09baed99495e7563b33c771e89a"
  }
}

Bedienungshinweise:

  • Nach der ersten Installation wird sieopenclaw onboardautomatisch vom Assistenten generiert
  • Nach dem Ändern der Konfiguration muss der Gateway-Dienst neu gestartet werden, damit die Änderungen wirksam werden.
  • Der Token-Wert wird für den Zugriff auf die Web-UI verwendet; bitte bewahren Sie ihn sicher auf.

2. Arbeitsbereichsverzeichnis

Pfad: ~/.openclaw/workspace/

Beschreibung:OpenClaws Standard-Arbeitsverzeichnis, in dem alle von der KI generierten Dateien, temporären Dateien und Ausgabedateien aus Benutzeranfragen gespeichert werden.

Hauptverwendungen:

  • Standardpfad für Dateilese-/Schreibvorgänge des KI-Agenten
  • Speicherung der Ausgabe der Codeausführung
  • Dokumentenerstellung und -bearbeitung
  • Temporäre Datenspeicherung

Berechtigungshinweise:

  • Standardmäßig kann die KI nur auf dieses Verzeichnis und seine Unterverzeichnisse zugreifen.
  • Wenn Zugriff auf andere Pfade erforderlich ist, konfigurieren Siefilesystem-mcpskills und erteilen Sie zusätzliche Berechtigungen
  • Windows-Benutzer müssen möglicherweise Dateien aus dem Arbeitsbereich an andere Orte kopieren.

Nutzungshinweise:

  • Nicht benötigte temporäre Dateien regelmäßig bereinigen
  • Es wird empfohlen, wichtige Ausgaben außerhalb des Arbeitsbereichs zu sichern.
  • Sie können hier Projekt-Unterverzeichnisse zur Organisation und Verwaltung erstellen.

3. Agent-Statusverzeichnis

Pfad: ~/.openclaw/agents/<cid>/

Beschreibung:Verzeichnis zum Speichern des Agent-Status und der Konfiguration für jede Konversation.<cid>Es ist die Konversations-ID, und jede Konversation hat einen unabhängigen Konfigurationsbereich.

Verzeichnisstruktur:

~/.openclaw/agents/<cid>/
├── agent/
│   ├── auth-profiles.json    # 该会话的 OAuth 和 API 密钥
│   └── ...
└── ...

Beschreibung von auth-profiles.json:

  • Speichert die von diesem Agenten verwendeten API-Authentifizierungsinformationen
  • Enthält OAuth-Token für verschiedene Dienste
  • Die neue Version verwendet diesen Pfad; die alte Version wird gespeichert in~/.openclaw/credentials/

Datenisolierung:

  • Authentifizierungsinformationen für jede Konversation sind unabhängig
  • Für verschiedene Konversationen können unterschiedliche API-Schlüssel konfiguriert werden
  • Unterstützt den Parallelbetrieb mehrerer Agenten

4. Verzeichnis für Authentifizierungsnachweise (Legacy)

Pfad: ~/.openclaw/credentials/

Beschreibung:Speicherort für Anmeldeinformationen der alten Version von OpenClaw.

Migrationshinweise:

  • Die neue Version wurde migriert nach~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Nach einem Upgrade von der alten Version müssen Anmeldeinformationen möglicherweise neu konfiguriert werden
  • Es wird empfohlen, zu verwendenopenclaw models auth setupzum Zurücksetzen

5. Gedächtnisspeicher-Verzeichnis

Pfad: ~/.openclaw/memory/

Beschreibung:Speicherort für OpenClaws persistentes Gedächtnissystem, einschließlich Vektorindizes und Konversationsverlauf.

Hauptdateien:

  • <cid>.sqlite- Vektorindex-Datenbank

    • Speichert semantische Vektoren von Konversationen
    • Unterstützt semantische Suchfunktionalität
    • Wird für den Abruf aus dem Langzeitgedächtnis verwendet

  • YYYY-MM-DD.md- Tägliche Konversationsprotokolle

    • Nach Datum benannte Markdown-Dateien
    • Protokolliert alle Konversationsinhalte des Tages
    • Erleichtert die manuelle Überprüfung und Archivierung

Speicherfunktionen:

  • Vektorsuche:Verwendetmemory search "关键词"um historische Konversationen zu durchsuchen
  • Kontextzuordnung:Unterstützt konversationsübergreifendes Kontextverständnis
  • Langzeitgedächtnis:Der Agent wird sich Benutzereinstellungen und -gewohnheiten 'merken'

Wartungsempfehlungen:

  • Sichern Sie das Speicherverzeichnis regelmäßig
  • Große Datenbanken können die Leistung beeinträchtigen; regelmäßige Archivierung in Betracht ziehen
  • Protokolldateien können für Audits und Fehlerbehebung verwendet werden

6. Skills-Verzeichnis

Pfad: ~/.openclaw/skills/

Beschreibung:Installationsort für global gemeinsam genutzte Skills. Skills sind Plugins, die die Funktionalität von OpenClaw erweitern.

Skill-Verwaltung:

  • Skills installieren: npx clawhub install <skill-name>
  • Skills auflisten: openclaw skills list
  • Skills suchen: npx clawhub search <关键词>

Gängige Skill-Beispiele:

  • filesystem-mcp- Dateisystemoperationen
  • github- GitHub-Integration
  • nano-pdf- PDF-Bearbeitung
  • notion / obsidian- Notizsynchronisierung
  • weather- Wetterabfrage
  • summarize- Generierung von Inhaltszusammenfassungen

Skill-Ökosystem:

  • Community-Skill-Bibliothek ClawHub bietet 500+ Skills
  • Unterstützt die Entwicklung benutzerdefinierter Skills
  • Skills können auf externe APIs und Systemressourcen zugreifen

Konfigurationsanweisungen:

  • Jeder Skill erfordert möglicherweise eine separate API-Key-Konfiguration
  • Einige Skills hängen von Systemtools ab (z. B. GitHub CLI)
  • macOS-exklusive Skills sind unter Windows/Linux nicht verfügbar

7. Gateway-Protokollverzeichnis

Pfad: /tmp/openclaw/*.log

Beschreibung:Laufzeitprotokolle des Gateway-Dienstes, gespeichert im temporären Systemverzeichnis.

Protokolltypen:

  • Gateway-Start-/Stopp-Protokolle
  • API-Anfrage-/Antwortprotokolle
  • Fehler- und Ausnahmeprotokolle
  • Informationen zur Leistungsüberwachung

Protokollverwaltung:

  • Protokolle im temporären Verzeichnis können nach einem Systemneustart gelöscht werden
  • Verwenden Sieopenclaw gateway --verboseDetaillierte Protokolle können angezeigt werden
  • Prüfen Sie bei der Fehlerbehebung zuerst die Protokolldateien

Gateway-Dienstverwaltung:

openclaw gateway start    # 启动网关
openclaw gateway status   # 查看状态
openclaw gateway stop     # 停止网关

Weitere wichtige Dateien

USER.md

Pfad:Normalerweise im Arbeitsbereich oder an einem benutzerdefinierten Speicherort

Beschreibung:Benutzerinformationsdatei, die personalisierte Informationen über den Benutzer enthält und der KI hilft, die Bedürfnisse des Benutzers besser zu verstehen.

Inhaltsbeispiele:

  • Benutzereinstellungen
  • Häufige Arbeitsabläufe
  • Hintergrundinformationen zum Projekt
  • Benutzerdefinierte Anweisungen

Best Practices für die Verwaltung von Konfigurationsdateien

1. Backup-Strategie

Sicherung kritischer Verzeichnisse:

# 备份整个配置目录
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

# 仅备份核心配置
cp ~/.openclaw/openclaw.json ~/backups/
cp -r ~/.openclaw/memory/ ~/backups/memory/

Empfohlene Sicherungshäufigkeit:

  • Hauptkonfigurationsdatei: nach jeder Änderung
  • Speicherdatenbank: einmal pro Woche
  • Skill-Konfiguration: nach der Installation neuer Skills

2. Sicherheitsempfehlungen

Schutz sensibler Informationen:

  • openclaw.jsonEnthält Gateway-Token, sollte nicht öffentlich gemacht werden
  • auth-profiles.jsonEnthält API-Schlüssel, muss durch Verschlüsselung geschützt werden
  • API-Schlüssel regelmäßig ändern
  • Konfigurationsdateien nicht in Versionskontrollsysteme einchecken

Berechtigungseinstellungen:

# 确保配置目录仅用户可访问
chmod 700 ~/.openclaw/
chmod 600 ~/.openclaw/openclaw.json
chmod 600 ~/.openclaw/agents/*/agent/auth-profiles.json

3. Migration und Upgrade

Überlegungen zum Versions-Upgrade:

  • Vor dem Upgrade das gesamte~/.openclaw/Verzeichnis sichern
  • Versionshinweise auf Konfigurationsänderungen prüfen
  • Zugangsdaten der alten Version müssen möglicherweise migriert werden

Geräteübergreifende Synchronisierung:

  • Kann Konfigurationsdateien für Konsistenz über mehrere Geräte hinweg synchronisieren
  • Pfadunterschiede beachten (Windows vs. Unix)
  • Sensible Informationen sollten separat konfiguriert werden

4. Fehlerbehebung

Diagnose von Konfigurationsproblemen:

# 检查配置文件语法
cat ~/.openclaw/openclaw.json | json_pp

# 深度检查
openclaw doctor --deep

# 查看网关状态
openclaw gateway status

Häufige Probleme:

  • Authentifizierung abgelaufen:Ausführenopenclaw models auth setupNeu konfigurieren
  • Gateway startet nicht:Portbelegung prüfen, Protokolldateien ansehen
  • Skills nicht verfügbar:Bestätigen, dass Skill-Abhängigkeiten installiert sind, API-Schlüssel prüfen

Konfiguration von Umgebungsvariablen

OpenClaw unterstützt die Konfiguration über Umgebungsvariablen:

# API 密钥环境变量
export ANTHROPIC_API_KEY="your-key-here"
export OPENAI_API_KEY="your-key-here"
export DEEPSEEK_API_KEY="your-key-here"

# 自定义配置目录
export OPENCLAW_HOME="~/custom-path/.openclaw"

Priorität der Umgebungsvariablen:

  • API-Schlüssel in Umgebungsvariablen werden vom Onboarding-Assistenten automatisch erkannt
  • Kann Standardwerte in Konfigurationsdateien überschreiben
  • Geeignet für CI/CD-Umgebungen und containerisierte Bereitstellung

Netzwerk- und Bereitstellungskonfiguration

Lokale Bereitstellung

Standardkonfiguration:

  • Bind-Adresse: 127.0.0.1 (nur lokaler Zugriff)
  • Gateway-Port: 18789

Zugriffsmethode:

http://127.0.0.1:18789/#token=<your-token>

Cloud-Bereitstellung

OpenClaw unterstützt die Bereitstellung auf Cloud-Servern:

Unterstützte Plattformen:

Cloud-Konfigurationsfunktionen:

  • Berechtigungen für öffentlichen Internetzugriff müssen konfiguriert werden
  • Möglicherweise müssen Firewall-Regeln konfiguriert werden
  • Unterstützt Domain-Bindung und SSL-Zertifikate

Konfiguration von Integrationsplattformen

OpenClaw unterstützt mehrere Instant-Messaging-Plattformen:

Unterstützte Plattformen

  • International: WhatsApp, Telegram, Discord, Slack, iMessage
  • Inländisch:Feishu, DingTalk

Konfigurationsspeicherort

Chat-Kanal-Konfiguration wird gespeichert inopenclaw.json, einschließlich:

  • Kanaltyp (Slack/Feishu usw.)
  • Authentifizierungs-Token
  • Kanal-Whitelist/Blacklist
  • Antwortmodus (DM/Gruppenchat)

Konfigurationsverwaltung

# 添加新渠道
openclaw channels add

# 列出已配置渠道
openclaw channels list

# 配对管理
openclaw pairing list
openclaw pairing approve <platform> <code>
Weitere Erweiterungen