English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaishiالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiruفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Fundamentals

Рабочая область агента

Рабочая область — дом агента. Это единственный рабочий каталог, используемый для файловых инструментов и контекста рабочей области. Храните ее в тайне и относитесь к ней как к памяти.

Это отдельно от ~/.openclaw/, где хранятся конфигурация, учетные данные и сеансы.

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

  • По умолчанию: ~/.openclaw/workspace
  • Если OPENCLAW_PROFILE задан и не равен "default", значением по умолчанию становится ~/.openclaw/workspace-<profile>.
  • Переопределение в ~/.openclaw/openclaw.json:
json5
{  agents: {    defaults: {      workspace: "~/.openclaw/workspace",    },  },}

openclaw onboard, openclaw configure или openclaw setup создадут рабочую область и начальные файлы, если они отсутствуют.

Если вы уже управляете файлами рабочей области самостоятельно, можно отключить создание начальных файлов:

json5
{ agents: { defaults: { skipBootstrap: true } } }

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

Более старые установки могли создать ~/openclaw. Наличие нескольких каталогов рабочей области может привести к запутанному дрейфу авторизации или состояния, потому что в каждый момент активна только одна рабочая область.

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

Это стандартные файлы, которые OpenClaw ожидает внутри рабочей области:

AGENTS.md — рабочие инструкции

Рабочие инструкции для агента и о том, как он должен использовать память. Загружаются в начале каждого сеанса. Хорошее место для правил, приоритетов и подробностей о том, «как себя вести».

SOUL.md — персона и тон

Персона, тон и границы. Загружается каждый сеанс. Руководство: руководство по личности SOUL.md.

USER.md — кто такой пользователь

Кто такой пользователь и как к нему обращаться. Загружается каждый сеанс.

IDENTITY.md — имя, вайб, эмодзи

Имя агента, вайб и эмодзи. Создается/обновляется во время ритуала начальной настройки.

TOOLS.md — локальные соглашения по инструментам

Заметки о ваших локальных инструментах и соглашениях. Не управляет доступностью инструментов; это только руководство.

HEARTBEAT.md — контрольный список Heartbeat

Необязательный короткий контрольный список для запусков Heartbeat. Держите его кратким, чтобы не тратить токены.

BOOT.md — контрольный список запуска

Необязательный контрольный список запуска, автоматически выполняемый при перезапуске Gateway (когда включены внутренние хуки). Держите его кратким; используйте инструмент сообщений для исходящих отправок.

BOOTSTRAP.md — ритуал первого запуска

Одноразовый ритуал первого запуска. Создается только для совершенно новой рабочей области. Удалите его после завершения ритуала.

memory/YYYY-MM-DD.md — ежедневный журнал памяти

Ежедневный журнал памяти (один файл на день). Рекомендуется читать сегодня + вчера при запуске сеанса.

MEMORY.md — курируемая долгосрочная память (необязательно)

Курируемая долгосрочная память: устойчивые факты, предпочтения, решения и короткие сводки. Храните подробные журналы в memory/YYYY-MM-DD.md, чтобы инструменты памяти могли извлекать их по требованию без добавления в каждый промпт. Загружайте MEMORY.md только в основном приватном сеансе (не в общих/групповых контекстах). См. Память для рабочего процесса и автоматического сброса памяти.

skills/ — Skills рабочей области (необязательно)

Skills, специфичные для рабочей области. Расположение Skills с наивысшим приоритетом для этой рабочей области. Переопределяет Skills агента проекта, личные Skills агента, управляемые Skills, встроенные Skills и skills.load.extraDirs при совпадении имен.

canvas/ — файлы Canvas UI (необязательно)

Файлы Canvas UI для отображения узлов (например, canvas/index.html).

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

Они находятся в ~/.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 (именно там находится рабочая область).

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

    Если git установлен, совершенно новые рабочие области инициализируются автоматически. Если эта рабочая область еще не является репозиторием, выполните:

    bash
    cd ~/.openclaw/workspacegit initgit add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/git commit -m "Add agent workspace"

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

    Веб-интерфейс GitHub

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

    GitHub CLI (gh)

    bash
    gh auth logingh repo create openclaw-workspace --private --source . --remote origin --push

    Веб-интерфейс GitLab

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

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

    bash
    git statusgit add .git commit -m "Update memory"git push

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

    Предлагаемый начальный .gitignore:

    gitignore
    .DS_Store.env**/*.key**/*.pem**/secrets*

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

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

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

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

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

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

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

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

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

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

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

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

    Was this useful?
    On this page

    On this page