> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

<Warning>
  Рабочая область — это **cwd по умолчанию**, а не жесткая песочница. Инструменты разрешают относительные пути относительно рабочей области, но абсолютные пути все равно могут обращаться к другим местам на хосте, если песочница не включена. Если нужна изоляция, используйте [`agents.defaults.sandbox`](/ru/gateway/sandboxing) (и/или конфигурацию песочницы для отдельного агента).

  Когда песочница включена и `workspaceAccess` не равен `"rw"`, инструменты работают внутри рабочей области песочницы в `~/.openclaw/sandboxes`, а не в вашей рабочей области на хосте.
</Warning>

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

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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}
```

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

<Note>
  Копирование начальных файлов в песочницу принимает только обычные файлы внутри рабочей области; псевдонимы symlink/hardlink, которые разрешаются за пределы исходной рабочей области, игнорируются.
</Note>

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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{ agents: { defaults: { skipBootstrap: true } } }
```

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

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

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

  `openclaw doctor` предупреждает, когда обнаруживает дополнительные каталоги рабочих областей.
</Note>

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

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

<AccordionGroup>
  <Accordion title="AGENTS.md — рабочие инструкции">
    Рабочие инструкции для агента и о том, как он должен использовать память. Загружаются в начале каждого сеанса. Хорошее место для правил, приоритетов и подробностей о том, «как себя вести».
  </Accordion>

  <Accordion title="SOUL.md — персона и тон">
    Персона, тон и границы. Загружается каждый сеанс. Руководство: [руководство по личности SOUL.md](/ru/concepts/soul).
  </Accordion>

  <Accordion title="USER.md — кто такой пользователь">
    Кто такой пользователь и как к нему обращаться. Загружается каждый сеанс.
  </Accordion>

  <Accordion title="IDENTITY.md — имя, вайб, эмодзи">
    Имя агента, вайб и эмодзи. Создается/обновляется во время ритуала начальной настройки.
  </Accordion>

  <Accordion title="TOOLS.md — локальные соглашения по инструментам">
    Заметки о ваших локальных инструментах и соглашениях. Не управляет доступностью инструментов; это только руководство.
  </Accordion>

  <Accordion title="HEARTBEAT.md — контрольный список Heartbeat">
    Необязательный короткий контрольный список для запусков Heartbeat. Держите его кратким, чтобы не тратить токены.
  </Accordion>

  <Accordion title="BOOT.md — контрольный список запуска">
    Необязательный контрольный список запуска, автоматически выполняемый при перезапуске Gateway (когда включены [внутренние хуки](/ru/automation/hooks)). Держите его кратким; используйте инструмент сообщений для исходящих отправок.
  </Accordion>

  <Accordion title="BOOTSTRAP.md — ритуал первого запуска">
    Одноразовый ритуал первого запуска. Создается только для совершенно новой рабочей области. Удалите его после завершения ритуала.
  </Accordion>

  <Accordion title="memory/YYYY-MM-DD.md — ежедневный журнал памяти">
    Ежедневный журнал памяти (один файл на день). Рекомендуется читать сегодня + вчера при запуске сеанса.
  </Accordion>

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

  <Accordion title="skills/ — Skills рабочей области (необязательно)">
    Skills, специфичные для рабочей области. Расположение Skills с наивысшим приоритетом для этой рабочей области. Переопределяет Skills агента проекта, личные Skills агента, управляемые Skills, встроенные Skills и `skills.load.extraDirs` при совпадении имен.
  </Accordion>

  <Accordion title="canvas/ — файлы Canvas UI (необязательно)">
    Файлы Canvas UI для отображения узлов (например, `canvas/index.html`).
  </Accordion>
</AccordionGroup>

<Note>
  Если какой-либо начальный файл отсутствует, OpenClaw добавляет в сеанс маркер «отсутствующий файл» и продолжает работу. Большие начальные файлы обрезаются при добавлении; настройте лимиты через `agents.defaults.bootstrapMaxChars` (по умолчанию: 20000) и `agents.defaults.bootstrapTotalMaxChars` (по умолчанию: 60000). `openclaw setup` может заново создать отсутствующие значения по умолчанию без перезаписи существующих файлов.
</Note>

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

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

<Steps>
  <Step title="Инициализируйте репозиторий">
    Если git установлен, совершенно новые рабочие области инициализируются автоматически. Если эта рабочая область еще не является репозиторием, выполните:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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"
    ```
  </Step>

  <Step title="Добавьте приватный remote">
    <Tabs>
      <Tab title="Веб-интерфейс GitHub">
        1. Создайте новый **приватный** репозиторий на GitHub.
        2. Не инициализируйте его с README (это предотвращает конфликты слияния).
        3. Скопируйте HTTPS URL remote.
        4. Добавьте remote и отправьте изменения:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        git branch -M main
        git remote add origin <https-url>
        git push -u origin main
        ```
      </Tab>

      <Tab title="GitHub CLI (gh)">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        gh auth login
        gh repo create openclaw-workspace --private --source . --remote origin --push
        ```
      </Tab>

      <Tab title="Веб-интерфейс GitLab">
        1. Создайте новый **приватный** репозиторий на GitLab.
        2. Не инициализируйте его с README (это предотвращает конфликты слияния).
        3. Скопируйте HTTPS URL remote.
        4. Добавьте remote и отправьте изменения:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        git branch -M main
        git remote add origin <https-url>
        git push -u origin main
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Текущие обновления">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    git status
    git add .
    git commit -m "Update memory"
    git push
    ```
  </Step>
</Steps>

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

<Warning>
  Даже в приватном репозитории избегайте хранения секретов в рабочей области:

  * API-ключи, OAuth-токены, пароли или приватные учетные данные.
  * Все, что находится в `~/.openclaw/`.
  * Сырые дампы чатов или чувствительных вложений.

  Если необходимо хранить чувствительные ссылки, используйте placeholders и держите настоящий секрет в другом месте (менеджер паролей, переменные окружения или `~/.openclaw/`).
</Warning>

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

```gitignore theme={"theme":{"light":"min-light","dark":"min-dark"}}
.DS_Store
.env
**/*.key
**/*.pem
**/secrets*
```

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

<Steps>
  <Step title="Клонируйте репозиторий">
    Клонируйте репозиторий в нужный путь (по умолчанию `~/.openclaw/workspace`).
  </Step>

  <Step title="Обновите конфигурацию">
    Установите `agents.defaults.workspace` в этот путь в `~/.openclaw/openclaw.json`.
  </Step>

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

  <Step title="Скопируйте сеансы (необязательно)">
    Если нужны сеансы, отдельно скопируйте `~/.openclaw/agents/<agentId>/sessions/` со старой машины.
  </Step>
</Steps>

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

* Маршрутизация нескольких агентов может использовать разные рабочие области для каждого агента. См. [Маршрутизация каналов](/ru/channels/channel-routing) для конфигурации маршрутизации.
* Если `agents.defaults.sandbox` включен, неосновные сеансы могут использовать рабочие области песочницы для отдельного сеанса в `agents.defaults.sandbox.workspaceRoot`.

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

* [Heartbeat](/ru/gateway/heartbeat) — файл рабочей области HEARTBEAT.md
* [Песочница](/ru/gateway/sandboxing) — доступ к рабочей области в изолированных средах
* [Сеанс](/ru/concepts/session) — пути хранения сеанса
* [Постоянные инструкции](/ru/automation/standing-orders) — постоянные инструкции в файлах рабочей области