Каталог конфигурации 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- Интеграция с GitHub
  • nano-pdf- Редактирование PDF
  • notion / 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 поддерживает развертывание на облачных серверах:

Поддерживаемые платформы:

Возможности облачной конфигурации:

  • Необходимо настроить разрешения на доступ из публичного интернета
  • Может потребоваться настроить правила брандмауэра
  • Поддерживает привязку домена и 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>
Другие расширения