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 Via openclaw 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 est
openclaw 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, configurez
filesystem-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'utiliser
openclaw 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 :Utilise
memory 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 fichiersgithub- Intégration GitHubnano-pdf- Édition PDFnotion/obsidian- Synchronisation des notesweather- Requête météosummarize- 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
- Utiliser
openclaw 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 publicauth-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écuter
openclaw 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 :
- Alibaba Cloud :https://www.aliyun.com/activity/ecs/clawdbot
- Tencent Cloud :https://cloud.tencent.com/developer/article/2624973
- 1Panel
- Conteneur Docker
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