Каталог конфигурации OpenClaw
OpenClaw (также известный как Clawdbot) централизует всю свою конфигурацию, данные состояния, рабочие пространства и навыки в основном каталоге ~/.openclaw/ (Linux/macOS) или %USERPROFILE%\.openclaw\ (Windows) в домашнем каталоге пользователя.
~/.openclaw/— это корневой каталог конфигурации всей системы; при первой установке/запускеopenclaw onboardилиopenclaw onboard --install-daemonон создаётся автоматически.
~/.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 # 加密凭证(可选)
Самые важные файлы:
openclaw.json: Глобальные настройки (модель, каналы, порты, политики безопасности)workspace/всё находится в.mdФайлы:Вы можете редактировать напрямую с помощью VS Code, и изменения вступают в силу в реальном времени.!
Команда для просмотра/изменения конфигурации:
openclaw configure # 交互式配置向导 openclaw config file # 显示完整路径 openclaw config get agent.model openclaw config set agent.model "anthropic/claude-3-5-sonnet" openclaw config validate # 校验合法性
| Путь | Описание назначения |
|---|---|
~/.openclaw/openclaw.json |
Основной файл конфигурации(Самый важный!) Хранит глобальные настройки (модель, режим Gateway, адрес привязки, значения по умолчанию для Agents, плагины и т. д.). Можно просмотреть/изменить с помощью команды: • openclaw config file(отображает полный путь)• openclaw config get <json路径>• openclaw config set <json路径> <值> |
~/.openclaw/workspace/ |
Рабочее пространство по умолчанию(местоположение «души» агента) Хранит следующие Markdown-файлы (можно редактировать напрямую, и изменения вступают в силу): • SOUL.md: настройки личности/тона AI• USER.md: ваши личные предпочтения и предыстория• MEMORY.md: записи долговременной памяти• AGENTS.md: описания инструкций• IDENTITY.md: Имя/тема• BOOT.md: Стартовая конфигурация• HEARTBEAT.md: Периодический чек-лист |
~/.openclaw/agents/<cid>/ |
Каталог состояния одного агента (<cid>для идентификатора экземпляра) |
~/.openclaw/agents/<agentId>/agent/auth-profiles.json |
Ключ API и учётные данные OAuth(рекомендуемое расположение в новой версии) Устаревшая версия может находиться в ~/.openclaw/credentials/ |
~/.openclaw/memory/<cid>.sqlite |
Хранилище векторного индекса (для поиска по памяти) |
~/.openclaw/skills/ |
Глобальный каталог навыков Через openclaw skills installилиclawhub installЗдесь размещаются все установленные пакеты навыков (каждый навык — это подпапка, содержащая SKILL.md) |
~/.openclaw/memory/ |
Файлы, связанные с долговременной памятью (SQLite + векторные эмбеддинги) |
/tmp/openclaw/*.log |
Логи службы шлюза (для отладки) |
1. Основной файл конфигурации
Путь: ~/.openclaw/openclaw.json
Описание:Основной файл конфигурации OpenClaw, содержащий все настройки системного уровня.
Основные элементы конфигурации:
- gateway- Конфигурация службы шлюза
mode: Режим шлюза (например, "local")port: Порт шлюза (по умолчанию 18789)bind: Адрес привязки (по умолчанию 127.0.0.1)token: Токен доступа, используемый для аутентификации в Web UI
- models- Конфигурация AI-модели
- Настройки модели по умолчанию
- Информация об аутентификации API
- messages- Конфигурация обработки сообщений
- Настройки TTS (преобразование текста в речь)
- Конфигурация формата сообщений
Пример фрагмента конфигурации:
{
"gateway": {
"mode": "local",
"port": 18789,
"bind": "127.0.0.1",
"token": "c9917c5a066beeb26266d09baed99495e7563b33c771e89a"
}
}
Рекомендации по работе:
- После первой установки он
openclaw onboardавтоматически генерируется мастером настройки - После изменения конфигурации перезапустите службу Gateway, чтобы изменения вступили в силу.
- Значение токена используется для доступа к веб-интерфейсу; пожалуйста, храните его в безопасности.
2. Каталог рабочей области
Путь: ~/.openclaw/workspace/
Описание:Рабочий каталог OpenClaw по умолчанию, в котором сохраняются все файлы, созданные ИИ, временные файлы и выходные файлы по запросам пользователя.
Основные способы использования:
- Расположение по умолчанию для чтения/записи файлов ИИ-агентом
- Хранилище вывода выполнения кода
- Генерация и редактирование документов
- Хранение временных данных
Примечания о разрешениях:
- По умолчанию ИИ может получать доступ только к этому каталогу и его подкаталогам.
- Если требуется доступ к другим путям, настройте
filesystem-mcpнавыки и предоставьте дополнительные разрешения - Пользователям Windows может потребоваться скопировать файлы из рабочей области в другие места.
Рекомендации по использованию:
- Регулярно очищайте ненужные временные файлы
- Рекомендуется создавать резервные копии важных выходных данных за пределами рабочей области.
- Здесь можно создавать подкаталоги проекта для организации и управления.
3. Каталог состояния агента
Путь: ~/.openclaw/agents/<cid>/
Описание:Каталог для хранения состояния агента и конфигурации для каждого разговора.<cid>Это ID разговора, и каждый разговор имеет независимое пространство конфигурации.
Структура каталога:
~/.openclaw/agents/<cid>/ ├── agent/ │ ├── auth-profiles.json # 该会话的 OAuth 和 API 密钥 │ └── ... └── ...
Описание auth-profiles.json:
- Хранит данные аутентификации API, используемые этим агентом
- Содержит OAuth-токены для различных сервисов
- Новая версия использует этот путь; старая версия хранится в
~/.openclaw/credentials/
Изоляция данных:
- Аутентификационные данные для каждого разговора независимы
- Для разных диалогов можно настроить разные ключи API
- Поддерживает параллельную работу нескольких агентов
4. Каталог учётных данных аутентификации (устаревший)
Путь: ~/.openclaw/credentials/
Описание:Место хранения учётных данных старой версии OpenClaw.
Примечания по миграции:
- Новая версия перешла на
~/.openclaw/agents/<agentId>/agent/auth-profiles.json - После обновления со старой версии может потребоваться повторная настройка учётных данных
- Рекомендуется использовать
openclaw models auth setupдля сброса
5. Каталог хранения памяти
Путь: ~/.openclaw/memory/
Описание:Место хранения системы постоянной памяти OpenClaw, включая векторные индексы и историю диалогов.
Основные файлы:
-
<cid>.sqlite- База данных векторных индексов- Хранит семантические векторы разговоров
- Поддерживает функциональность семантического поиска
- Используется для извлечения из долговременной памяти
-
YYYY-MM-DD.md- Ежедневные журналы разговоров- Markdown-файлы с именем по дате
- Записывает всё содержимое разговоров за день
- Облегчает ручной просмотр и архивирование
Функции памяти:
- Векторный поиск:Использует
memory search "关键词"для поиска исторических разговоров - Связывание контекста:Поддерживает понимание контекста между разговорами
- Долговременная память:Агент будет «запоминать» предпочтения и привычки пользователя
Рекомендации по обслуживанию:
- Регулярно создавайте резервные копии каталога памяти
- Большие базы данных могут влиять на производительность; рассмотрите регулярное архивирование
- Файлы журналов можно использовать для аудита и устранения неполадок
6. Каталог навыков
Путь: ~/.openclaw/skills/
Описание:Место установки глобально совместно используемых навыков. Навыки — это плагины, расширяющие функциональность OpenClaw.
Управление навыками:
- Установка навыков:
npx clawhub install <skill-name> - Список навыков:
openclaw skills list - Поиск навыков:
npx clawhub search <关键词>
Примеры распространённых навыков:
filesystem-mcp- Операции с файловой системойgithub- Интеграция с GitHubnano-pdf- Редактирование PDFnotion/obsidian- Синхронизация заметокweather- Запрос погодыsummarize- Генерация сводки содержимого
Экосистема навыков:
- Библиотека навыков сообщества ClawHub предоставляет 500+ навыков
- Поддерживает разработку пользовательских навыков
- Навыки могут получать доступ к внешним API и системным ресурсам
Инструкции по настройке:
- Каждый навык может требовать отдельной настройки API-ключа
- Некоторые навыки зависят от системных инструментов (например, GitHub CLI)
- Навыки, эксклюзивные для macOS, недоступны в Windows/Linux
7. Каталог логов шлюза
Путь: /tmp/openclaw/*.log
Описание:Логи времени выполнения службы шлюза, хранящиеся во временном каталоге системы.
Типы логов:
- Логи запуска/остановки шлюза
- Логи запросов/ответов API
- Логи ошибок и исключений
- Информация о мониторинге производительности
Управление логами:
- Логи во временном каталоге могут быть очищены после перезапуска системы
- Используйте
openclaw gateway --verboseМожно просмотреть подробные логи - При устранении неполадок сначала проверьте файлы логов
Управление службой шлюза:
openclaw gateway start # 启动网关 openclaw gateway status # 查看状态 openclaw gateway stop # 停止网关
Другие важные файлы
USER.md
Путь:Обычно находится в рабочей области или в заданном пользователем расположении
Описание:Файл с информацией о пользователе, содержащий персонализированную информацию о пользователе и помогающий ИИ лучше понимать потребности пользователя.
Примеры содержимого:
- Настройки предпочтений пользователя
- Типичные рабочие процессы
- Справочная информация о проекте
- Пользовательские инструкции
Лучшие практики управления файлами конфигурации
1. Стратегия резервного копирования
Резервное копирование критичных каталогов:
# 备份整个配置目录 tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/ # 仅备份核心配置 cp ~/.openclaw/openclaw.json ~/backups/ cp -r ~/.openclaw/memory/ ~/backups/memory/
Рекомендуемая частота резервного копирования:
- Основной файл конфигурации: после каждого изменения
- База данных памяти: раз в неделю
- Конфигурация навыков: после установки новых навыков
2. Рекомендации по безопасности
Защита конфиденциальной информации:
openclaw.jsonСодержит токен шлюза, не должен публиковатьсяauth-profiles.jsonСодержит ключи API, требуется защита шифрованием- Регулярно меняйте ключи API
- Не добавляйте файлы конфигурации в системы контроля версий
Настройки разрешений:
# 确保配置目录仅用户可访问 chmod 700 ~/.openclaw/ chmod 600 ~/.openclaw/openclaw.json chmod 600 ~/.openclaw/agents/*/agent/auth-profiles.json
3. Миграция и обновление
Особенности обновления версии:
- Перед обновлением создайте резервную копию всего
~/.openclaw/каталога - Проверьте примечания к выпуску на наличие изменений конфигурации
- Учётные данные старой версии могут потребовать миграции
Синхронизация между устройствами:
- Можно синхронизировать файлы конфигурации для согласованности на нескольких устройствах
- Обратите внимание на различия путей (Windows и Unix)
- Конфиденциальную информацию рекомендуется настраивать отдельно
4. Устранение неполадок
Диагностика проблем конфигурации:
# 检查配置文件语法 cat ~/.openclaw/openclaw.json | json_pp # 深度检查 openclaw doctor --deep # 查看网关状态 openclaw gateway status
Типичные проблемы:
- Срок аутентификации истёк:Запустите
openclaw models auth setupПеренастройте - Шлюз не запускается:Проверьте занятость порта, просмотрите файлы журналов
- Навыки недоступны:Убедитесь, что зависимости навыков установлены, проверьте API-ключи
Настройка переменных окружения
OpenClaw поддерживает настройку через переменные среды:
# 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"
Приоритет переменных среды:
- API-ключи в переменных среды автоматически обнаруживаются мастером первоначальной настройки
- Могут переопределять значения по умолчанию в файлах конфигурации
- Подходит для сред CI/CD и контейнерного развёртывания
Конфигурация сети и развёртывания
Локальное развёртывание
Конфигурация по умолчанию:
- Адрес привязки: 127.0.0.1 (только локальный доступ)
- Порт шлюза: 18789
Способ доступа:
http://127.0.0.1:18789/#token=<your-token>
Облачное развертывание
OpenClaw поддерживает развертывание на облачных серверах:
Поддерживаемые платформы:
- Alibaba Cloud:https://www.aliyun.com/activity/ecs/clawdbot
- Tencent Cloud:https://cloud.tencent.com/developer/article/2624973
- 1Panel
- Контейнер Docker
Возможности облачной конфигурации:
- Необходимо настроить разрешения на доступ из публичного интернета
- Может потребоваться настроить правила брандмауэра
- Поддерживает привязку домена и SSL-сертификаты
Конфигурация платформы интеграции
OpenClaw поддерживает несколько платформ обмена мгновенными сообщениями:
Поддерживаемые платформы
- Международные: WhatsApp, Telegram, Discord, Slack, iMessage
- Локальные:Feishu, DingTalk
Расположение конфигурации
Конфигурация чат-каналов хранится вopenclaw.json, включая:
- Тип канала (Slack/Feishu и т. д.)
- Токен аутентификации
- Белый/черный список каналов
- Режим ответа (личные сообщения/групповой чат)
Управление конфигурацией
# 添加新渠道 openclaw channels add # 列出已配置渠道 openclaw channels list # 配对管理 openclaw pairing list openclaw pairing approve <platform> <code>Другие расширения