Перейти к основному содержанию
Рабочая область — дом агента. Это единственный рабочий каталог, используемый для файловых инструментов и контекста рабочей области. Храните ее в тайне и относитесь к ней как к памяти. Это отдельно от ~/.openclaw/, где хранятся конфигурация, учетные данные и сеансы.
Рабочая область — это cwd по умолчанию, а не жесткая песочница. Инструменты разрешают относительные пути относительно рабочей области, но абсолютные пути все равно могут обращаться к другим местам на хосте, если песочница не включена. Если нужна изоляция, используйте agents.defaults.sandbox (и/или конфигурацию песочницы для отдельного агента).Когда песочница включена и workspaceAccess не равен "rw", инструменты работают внутри рабочей области песочницы в ~/.openclaw/sandboxes, а не в вашей рабочей области на хосте.

​
Расположение по умолчанию

  • По умолчанию: ~/.openclaw/workspace
  • Если OPENCLAW_PROFILE задан и не равен "default", значением по умолчанию становится ~/.openclaw/workspace-<profile>.
  • Переопределение в ~/.openclaw/openclaw.json:
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}
openclaw onboard, openclaw configure или openclaw setup создадут рабочую область и начальные файлы, если они отсутствуют.
Копирование начальных файлов в песочницу принимает только обычные файлы внутри рабочей области; псевдонимы symlink/hardlink, которые разрешаются за пределы исходной рабочей области, игнорируются.
Если вы уже управляете файлами рабочей области самостоятельно, можно отключить создание начальных файлов: 
{ agents: { defaults: { skipBootstrap: true } } }

​
Дополнительные папки рабочей области

Более старые установки могли создать ~/openclaw. Наличие нескольких каталогов рабочей области может привести к запутанному дрейфу авторизации или состояния, потому что в каждый момент активна только одна рабочая область.
Рекомендация: держите одну активную рабочую область. Если дополнительные папки больше не используются, заархивируйте их или переместите в корзину (например, trash ~/openclaw). Если вы намеренно держите несколько рабочих областей, убедитесь, что agents.defaults.workspace указывает на активную.openclaw doctor предупреждает, когда обнаруживает дополнительные каталоги рабочих областей.

​
Карта файлов рабочей области

Это стандартные файлы, которые OpenClaw ожидает внутри рабочей области:
Рабочие инструкции для агента и о том, как он должен использовать память. Загружаются в начале каждого сеанса. Хорошее место для правил, приоритетов и подробностей о том, «как себя вести».
Персона, тон и границы. Загружается каждый сеанс. Руководство: руководство по личности SOUL.md.
Кто такой пользователь и как к нему обращаться. Загружается каждый сеанс.
Имя агента, вайб и эмодзи. Создается/обновляется во время ритуала начальной настройки.
Заметки о ваших локальных инструментах и соглашениях. Не управляет доступностью инструментов; это только руководство.
Необязательный короткий контрольный список для запусков Heartbeat. Держите его кратким, чтобы не тратить токены.
Необязательный контрольный список запуска, автоматически выполняемый при перезапуске Gateway (когда включены внутренние хуки). Держите его кратким; используйте инструмент сообщений для исходящих отправок.
Одноразовый ритуал первого запуска. Создается только для совершенно новой рабочей области. Удалите его после завершения ритуала.
Ежедневный журнал памяти (один файл на день). Рекомендуется читать сегодня + вчера при запуске сеанса.
Курируемая долгосрочная память: устойчивые факты, предпочтения, решения и короткие сводки. Храните подробные журналы в memory/YYYY-MM-DD.md, чтобы инструменты памяти могли извлекать их по требованию без добавления в каждый промпт. Загружайте MEMORY.md только в основном приватном сеансе (не в общих/групповых контекстах). См. Память для рабочего процесса и автоматического сброса памяти.
Skills, специфичные для рабочей области. Расположение Skills с наивысшим приоритетом для этой рабочей области. Переопределяет Skills агента проекта, личные Skills агента, управляемые Skills, встроенные Skills и skills.load.extraDirs при совпадении имен.
Файлы Canvas UI для отображения узлов (например, canvas/index.html).
Если какой-либо начальный файл отсутствует, OpenClaw добавляет в сеанс маркер «отсутствующий файл» и продолжает работу. Большие начальные файлы обрезаются при добавлении; настройте лимиты через agents.defaults.bootstrapMaxChars (по умолчанию: 20000) и agents.defaults.bootstrapTotalMaxChars (по умолчанию: 60000). openclaw setup может заново создать отсутствующие значения по умолчанию без перезаписи существующих файлов.

​
Чего НЕТ в рабочей области

Они находятся в ~/.openclaw/ и НЕ должны коммититься в репозиторий рабочей области:
  • ~/.openclaw/openclaw.json (конфигурация)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (профили авторизации модели: OAuth + API-ключи)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (учетная запись, конфигурация, skills, plugins и собственное состояние потоков Codex для отдельного агента)
  • ~/.openclaw/credentials/ (состояние канала/провайдера плюс устаревшие импортированные данные OAuth)
  • ~/.openclaw/agents/<agentId>/sessions/ (транскрипты сеансов + метаданные)
  • ~/.openclaw/skills/ (управляемые skills)
Если нужно перенести сеансы или конфигурацию, копируйте их отдельно и не включайте в систему контроля версий.

​
Резервная копия в Git (рекомендуется, приватная)

Относитесь к рабочей области как к приватной памяти. Поместите ее в приватный git-репозиторий, чтобы она резервировалась и могла быть восстановлена. Выполните эти шаги на машине, где запущен Gateway (именно там находится рабочая область).
1

Инициализируйте репозиторий

Если git установлен, совершенно новые рабочие области инициализируются автоматически. Если эта рабочая область еще не является репозиторием, выполните:
cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/
git commit -m "Add agent workspace"
2

Добавьте приватный remote

  1. Создайте новый приватный репозиторий на GitHub.
  2. Не инициализируйте его с README (это предотвращает конфликты слияния).
  3. Скопируйте HTTPS URL remote.
  4. Добавьте remote и отправьте изменения:
git branch -M main
git remote add origin <https-url>
git push -u origin main
3

Текущие обновления

git status
git add .
git commit -m "Update memory"
git push

​
Не коммитьте секреты

Даже в приватном репозитории избегайте хранения секретов в рабочей области:
  • API-ключи, OAuth-токены, пароли или приватные учетные данные.
  • Все, что находится в ~/.openclaw/.
  • Сырые дампы чатов или чувствительных вложений.
Если необходимо хранить чувствительные ссылки, используйте placeholders и держите настоящий секрет в другом месте (менеджер паролей, переменные окружения или ~/.openclaw/).
Предлагаемый начальный .gitignore: 
.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

​
Перенос рабочей области на новую машину

1

Клонируйте репозиторий

Клонируйте репозиторий в нужный путь (по умолчанию ~/.openclaw/workspace).
2

Обновите конфигурацию

Установите agents.defaults.workspace в этот путь в ~/.openclaw/openclaw.json.
3

Добавьте отсутствующие файлы

Выполните openclaw setup --workspace <path>, чтобы добавить любые отсутствующие файлы.
4

Скопируйте сеансы (необязательно)

Если нужны сеансы, отдельно скопируйте ~/.openclaw/agents/<agentId>/sessions/ со старой машины.

​
Расширенные заметки

  • Маршрутизация нескольких агентов может использовать разные рабочие области для каждого агента. См. Маршрутизация каналов для конфигурации маршрутизации.
  • Если agents.defaults.sandbox включен, неосновные сеансы могут использовать рабочие области песочницы для отдельного сеанса в agents.defaults.sandbox.workspaceRoot.

​
Связанные разделы