Répertoire de configuration d'OpenClaw

OpenClaw (également connu sous le nom de Clawdbot) centralise toute sa configuration, ses données d'état, ses espaces de travail et ses compétences dans le répertoire principal ~/.openclaw/ (Linux/macOS) ou %USERPROFILE%\.openclaw\ (Windows) sous le répertoire personnel de l'utilisateur.

~/.openclaw/est le répertoire de configuration racine de tout le système ; lors de la première installation/exécutionopenclaw onboardouopenclaw onboard --install-daemonil est créé automatiquement.

~/.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                  # 加密凭证(可选)

Fichiers les plus importants:

  • openclaw.json: Paramètres globaux (modèle, canaux, ports, politiques de sécurité)
  • workspace/tous sous.mdFichiers :Vous pouvez les modifier directement avec VS Code et cela prend effet en temps réel.!

Commande pour afficher/modifier la configuration :

openclaw configure      # 交互式配置向导
openclaw config file          # 显示完整路径
openclaw config get agent.model
openclaw config set agent.model "anthropic/claude-3-5-sonnet"
openclaw config validate      # 校验合法性
Chemin Description de l'objectif
~/.openclaw/openclaw.json Fichier de configuration principal(Le plus important !)
Stocke les paramètres globaux (modèle, mode Gateway, adresse de liaison, valeurs par défaut des Agents, plugins, etc.).
Peut être consulté/modifié avec la commande :
• openclaw config file(affiche le chemin complet)
• openclaw config get <json路径>
• openclaw config set <json路径> <值>
~/.openclaw/workspace/ Espace de travail par défaut(L'emplacement de l'"âme" de l'Agent)
Stocke les fichiers Markdown suivants (peuvent être modifiés directement et prendre effet) :
• SOUL.md: Paramètres de personnalité/ton de l'IA
• USER.md: Vos préférences personnelles et votre contexte
• MEMORY.md: Enregistrements de mémoire à long terme
• AGENTS.md: Descriptions des instructions
• IDENTITY.md: Nom/Thème
• BOOT.md: Configuration de démarrage
• HEARTBEAT.md: Liste de contrôle périodique
~/.openclaw/agents/<cid>/ Répertoire d'état d'un seul agent (<cid>pour l'ID d'instance)
~/.openclaw/agents/<agentId>/agent/auth-profiles.json Clé API et identifiants OAuth(emplacement recommandé dans la nouvelle version)
La version héritée peut se trouver dans~/.openclaw/credentials/
~/.openclaw/memory/<cid>.sqlite Stockage de l'index vectoriel (pour la recherche en mémoire)
~/.openclaw/skills/ Répertoire global des compétences
Viaopenclaw skills installouclawhub installTous les paquets de compétences installés sont placés ici (chaque compétence est un sous-dossier contenant SKILL.md)
~/.openclaw/memory/ Fichiers liés à la mémoire à long terme (SQLite + plongements vectoriels)
/tmp/openclaw/*.log Journaux du service de passerelle (pour le débogage)

1. Fichier de configuration principal

Chemin : ~/.openclaw/openclaw.json

Description :Fichier de configuration principal d'OpenClaw, contenant tous les paramètres système.

Principaux éléments de configuration :

  • gateway- Configuration du service de passerelle
    • mode: Mode de passerelle (par ex., "local")
    • port: Port de la passerelle (par défaut 18789)
    • bind: Adresse de liaison (par défaut 127.0.0.1)
    • token: Jeton d'accès, utilisé pour l'authentification à l'interface Web
  • models- Configuration des modèles d'IA
    • Paramètres du modèle par défaut
    • Informations d'authentification API
  • messages- Configuration du traitement des messages
    • Paramètres TTS (synthèse vocale)
    • Configuration du format des messages

Exemple d'extrait de configuration :

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

Suggestions d'opérations :

  • Après la première installation, il estopenclaw onboardgénéré automatiquement par l'assistant
  • Après avoir modifié la configuration, redémarrez le service Gateway pour que les modifications prennent effet.
  • La valeur du jeton est utilisée pour l'accès à l'interface Web ; veuillez la conserver en sécurité.

2. Répertoire de travail

Chemin : ~/.openclaw/workspace/

Description :Répertoire de travail par défaut d'OpenClaw, où sont enregistrés tous les fichiers générés par l'IA, les fichiers temporaires et les fichiers de sortie issus des requêtes utilisateur.

Utilisations principales :

  • Emplacement par défaut pour la lecture/écriture des fichiers par l'agent IA
  • Stockage des sorties d'exécution de code
  • Génération et modification de documents
  • Stockage de données temporaires

Notes sur les autorisations :

  • Par défaut, l'IA ne peut accéder qu'à ce répertoire et à ses sous-répertoires.
  • Si l'accès à d'autres chemins est requis, configurezfilesystem-mcples compétences et accordez des autorisations supplémentaires
  • Les utilisateurs Windows peuvent avoir besoin de copier des fichiers de l'espace de travail vers d'autres emplacements.

Suggestions d'utilisation :

  • Nettoyez régulièrement les fichiers temporaires inutiles
  • Il est recommandé de sauvegarder les sorties importantes en dehors de l'espace de travail.
  • Vous pouvez créer des sous-répertoires de projet ici pour l'organisation et la gestion.

3. Répertoire d'état de l'agent

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

Description :Répertoire de stockage de l'état et de la configuration de l'agent pour chaque conversation.<cid>Il s'agit de l'ID de conversation, et chaque conversation dispose d'un espace de configuration indépendant.

Structure des répertoires :

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

Description de auth-profiles.json :

  • Stocke les informations d'authentification d'API utilisées par cet agent
  • Contient les jetons OAuth pour divers services
  • La nouvelle version utilise ce chemin ; l'ancienne version est stockée dans~/.openclaw/credentials/

Isolation des données :

  • Les informations d'authentification de chaque conversation sont indépendantes
  • Différentes clés API peuvent être configurées pour différentes conversations
  • Prend en charge le fonctionnement parallèle de plusieurs agents

4. Répertoire des identifiants d'authentification (hérité)

Chemin : ~/.openclaw/credentials/

Description :Emplacement de stockage des identifiants pour l'ancienne version d'OpenClaw.

Notes de migration :

  • La nouvelle version a migré vers~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Après une mise à niveau depuis l'ancienne version, il peut être nécessaire de reconfigurer les identifiants
  • Il est recommandé d'utiliseropenclaw models auth setuppour réinitialiser

5. Répertoire de stockage de la mémoire

Chemin : ~/.openclaw/memory/

Description :Emplacement de stockage du système de mémoire persistante d'OpenClaw, y compris les index vectoriels et l'historique des conversations.

Fichiers principaux :

  • <cid>.sqlite- Base de données d'index vectoriel

    • Stocke les vecteurs sémantiques des conversations
    • Prend en charge la fonctionnalité de recherche sémantique
    • Utilisé pour la récupération de la mémoire à long terme
  • YYYY-MM-DD.md- Journaux de conversation quotidiens

    • Fichiers Markdown nommés par date
    • Enregistre tout le contenu des conversations de la journée
    • Facilite la révision manuelle et l'archivage

Fonctionnalités de mémoire :

  • Recherche vectorielle :Utilisememory search "关键词"pour rechercher des conversations historiques
  • Association de contexte :Prend en charge la compréhension du contexte entre conversations
  • Mémoire à long terme :L'agent « se souviendra » des préférences et habitudes de l'utilisateur

Recommandations de maintenance :

  • Sauvegardez régulièrement le répertoire de mémoire
  • Les bases de données volumineuses peuvent affecter les performances ; envisagez un archivage régulier
  • Les fichiers journaux peuvent être utilisés pour l'audit et le dépannage

6. Répertoire des compétences

Chemin : ~/.openclaw/skills/

Description :Emplacement d'installation pour les compétences partagées globalement. Les compétences sont des plugins qui étendent les fonctionnalités d'OpenClaw.

Gestion des compétences :

  • Installer des compétences : npx clawhub install <skill-name>
  • Lister les compétences : openclaw skills list
  • Rechercher des skills : npx clawhub search <关键词>

Exemples de compétences courantes :

  • filesystem-mcp- Opérations sur le système de fichiers
  • github- Intégration GitHub
  • nano-pdf- Édition PDF
  • notion / obsidian- Synchronisation des notes
  • weather- Requête météo
  • summarize- Génération de résumés de contenu

Écosystème de compétences :

  • La bibliothèque communautaire de compétences ClawHub fournit 500+ compétences
  • Prend en charge le développement de compétences personnalisées
  • Les compétences peuvent accéder aux API externes et aux ressources système

Instructions de configuration :

  • Chaque compétence peut nécessiter une configuration distincte de clé API
  • Certaines compétences dépendent d'outils système (par exemple, GitHub CLI)
  • Les compétences exclusives à macOS ne sont pas disponibles sur Windows/Linux

7. Répertoire des journaux de la passerelle

Chemin : /tmp/openclaw/*.log

Description :Journaux d'exécution du service de passerelle, stockés dans le répertoire temporaire du système.

Types de journaux :

  • Journaux de démarrage/arrêt de la passerelle
  • Journaux de requêtes/réponses API
  • Journaux d'erreurs et d'exceptions
  • Informations de surveillance des performances

Gestion des journaux :

  • Les journaux du répertoire temporaire peuvent être effacés après un redémarrage du système
  • Utiliseropenclaw gateway --verboseLes journaux détaillés peuvent être consultés
  • Lors du dépannage, vérifiez d'abord les fichiers journaux

Gestion du service de passerelle :

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

Autres fichiers importants

USER.md

Chemin :Généralement situé dans l'espace de travail ou dans un emplacement défini par l'utilisateur

Description :Fichier d'informations utilisateur, contenant des informations personnalisées sur l'utilisateur, aidant l'IA à mieux comprendre les besoins de l'utilisateur.

Exemples de contenu :

  • Paramètres de préférences utilisateur
  • Flux de travail courants
  • Informations sur le contexte du projet
  • Instructions personnalisées

Bonnes pratiques pour la gestion des fichiers de configuration

1. Stratégie de sauvegarde

Sauvegarde des répertoires critiques :

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

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

Fréquence de sauvegarde recommandée :

  • Fichier de configuration principal : après chaque modification
  • Base de données en mémoire : une fois par semaine
  • Configuration des compétences : après l'installation de nouvelles compétences

2. Recommandations de sécurité

Protection des informations sensibles :

  • openclaw.jsonContient le jeton de passerelle, ne doit pas être rendu public
  • auth-profiles.jsonContient des clés API, nécessite une protection par chiffrement
  • Changer régulièrement les clés API
  • Ne pas committer les fichiers de configuration dans les systèmes de gestion de versions

Paramètres d'autorisation :

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

3. Migration et mise à niveau

Considérations relatives à la mise à niveau de version :

  • Avant la mise à niveau, sauvegardez l’intégralité du~/.openclaw/répertoire
  • Consultez les notes de version pour les modifications de configuration
  • Les identifiants de l’ancienne version peuvent nécessiter une migration

Synchronisation entre appareils :

  • Peut synchroniser les fichiers de configuration pour une cohérence multi-appareils
  • Notez les différences de chemin (Windows vs Unix)
  • Il est recommandé de configurer séparément les informations sensibles

4. Dépannage

Diagnostic des problèmes de configuration :

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

# 深度检查
openclaw doctor --deep

# 查看网关状态
openclaw gateway status

Problèmes courants :

  • Authentification expirée :Exécuteropenclaw models auth setupReconfigurer
  • Échec du démarrage de la passerelle :Vérifier l'occupation du port, consulter les fichiers journaux
  • Skills indisponibles :Vérifier que les dépendances des skills sont installées, vérifier les clés API

Configuration des variables d'environnement

OpenClaw prend en charge la configuration via des variables d'environnement :

# 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é des variables d'environnement :

  • Les clés API dans les variables d'environnement sont automatiquement détectées par l'assistant d'intégration
  • Permet de remplacer les valeurs par défaut dans les fichiers de configuration
  • Adapté aux environnements CI/CD et au déploiement conteneurisé

Configuration réseau et de déploiement

Déploiement local

Configuration par défaut :

  • Adresse de liaison : 127.0.0.1 (accès local uniquement)
  • Port de la passerelle : 18789

Méthode d'accès :

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

Déploiement cloud

OpenClaw prend en charge le déploiement sur des serveurs cloud :

Plateformes prises en charge :

Fonctionnalités de configuration cloud :

  • Nécessité de configurer les autorisations d'accès à l'internet public
  • Peut nécessiter la configuration de règles de pare-feu
  • Prend en charge la liaison de domaine et les certificats SSL

Configuration de la plateforme d'intégration

OpenClaw prend en charge plusieurs plateformes de messagerie instantanée :

Plateformes prises en charge

  • International : WhatsApp, Telegram, Discord, Slack, iMessage
  • National :Feishu, DingTalk

Emplacement de la configuration

La configuration du canal de discussion est stockée dansopenclaw.json, y compris :

  • Type de canal (Slack/Feishu, etc.)
  • Jeton d'authentification
  • Liste blanche/noire des canaux
  • Mode de réponse (message privé/discussion de groupe)

Gestion de la configuration

# 添加新渠道
openclaw channels add

# 列出已配置渠道
openclaw channels list

# 配对管理
openclaw pairing list
openclaw pairing approve <platform> <code>
Autres extensions