Workspace OpenClaw: полное руководство по рабочему пространству агента | open-claw.su

Workspace — это домашняя директория агента OpenClaw. Здесь агент хранит свои инструкции, память, скиллы и файлы canvas. Понимание workspace — ключ к тому, чтобы агент работал именно так, как вам нужно, а не как случайно получилось при установке.

В этой статье разберём структуру workspace, назначение каждого bootstrap-файла, правила бэкапа и переноса на другую машину.

Где находится workspace

По умолчанию:

~/.openclaw/workspace/

Если вы используете профиль (переменная OPENCLAW_PROFILE отличная от default), путь меняется:

~/.openclaw/workspace-<profile>/

Изменить путь можно в ~/.openclaw/openclaw.json:

{
  agents: {
    defaults: {
      workspace: "/path/to/your/workspace"
    }
  }
}

Или при первой настройке:

openclaw setup --workspace /path/to/your/workspace

Важно: workspace — это рабочая директория для файловых инструментов агента. Это не песочница: при отключённом sandbox агент может обращаться к абсолютным путям за пределами workspace.

Bootstrap-файлы: что за что отвечает

При первом запуске OpenClaw автоматически создаёт в workspace набор текстовых файлов. Каждый из них управляет отдельным аспектом поведения агента.

AGENTS.md — операционные инструкции

Главный файл инструкций. Здесь описываются правила работы агента: какие инструменты использовать, как реагировать на команды, какие форматы ответов предпочитать. AGENTS.md загружается в системный промпт при каждой сессии.

Подробнее про AGENTS.md и шаблоны →

SOUL.md — личность и стиль

Определяет «характер» агента: тон общения, эмодзи, стиль ответов, манеру речи. SOUL.md — самый простой способ персонализировать агента без программирования.

Полное руководство по SOUL.md →

USER.md — кто вы

Файл с информацией о пользователе: имя, должность, предпочтения, контекст проектов. Агент читает его при старте, чтобы понимать, с кем разговаривает.

Пример:

---
name: Александр
role: владелец агентства
preferences:
  - Отвечай кратко
  - Используй форматирование для длинных списков
projects:
  - "Stealth Auto — автотюнинг"
  - "Otkidnie Ramki — оборудование"

IDENTITY.md — имя и вайб

Краткая карточка агента: имя, эмодзи, общее настроение. Используется при генерации ответов, где нужна самоидентификация.

Пример:

---
name: Клауд
emoji: 🦞
vibe: дружелюбный, но деловой

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

Локальные правила использования инструментов агента. Например, формат вызова API, правила именования файлов, соглашения по git-коммитам.

Пример:

## Git
- Коммит-сообщения на русском языке
- Формат: «тип: описание» (add, fix, update, refactor)
- Никогда не коммить без `git status`

## Файлы
- Используй kebab-case для имён файлов
- Разделяй логику по папкам: `src/`, `docs/`, `assets/`

HEARTBEAT.md — чеклист проверок

Список периодических задач, которые агент выполняет в фоне. Подробнее в официальной документации.

BOOT.md — стартовый чеклист

Задачи, которые агент выполняет при запуске новой сессии: проверка почты, обновление задач, синхронизация календаря.

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

Выполняется только при первом старте агента. Обычно содержит приветствие, краткое объяснение возможностей и первичные настройки.

MEMORY.md — долгосрочная память

Куратированная память агента. Здесь хранятся важные факты о пользователе, договорённости и выученные паттерны. Загружается только в приватных (main) сессиях.

Подробнее про память →

memory/YYYY-MM-DD.md — дневные логи

Директория memory/ содержит append-only логи за каждый день. Агент читает логи за сегодня и вчера при старте новой сессии.

skills/ — локальные скиллы

Скиллы, размещённые в skills/, имеют наивысший приоритет. Используйте эту папку для скиллов, специфичных для вашего проекта.

Подробнее про скиллы →

canvas/ — файлы Canvas UI

Файлы визуального интерфейса Canvas. Используются, когда агент работает с графическим представлением данных.

Что НЕ хранится в workspace

Workspace — это рабочая директория, но не всё хранится здесь. Ниже список того, что находится за пределами workspace и почему это важно:

Что	Где находится	Почему не в workspace
Конфигурация	`~/.openclaw/openclaw.json`	Секреты, API-ключи, системные настройки
Креды и токены	`~/.openclaw/credentials/`	Безопасность — не коммить в git
Сессии	`~/.openclaw/agents/<id>/sessions/`	Транскрипты диалогов, приватные
Установленные скиллы	`~/.openclaw/skills/`	Управляются через `clawhub`
Managed скиллы	`~/.openclaw/skills/`	Обновляются автоматически

Бэкап через Git (рекомендуется)

Самый надёжный способ сохранить workspace — инициализировать в нём git-репозиторий. Так вы получите историю изменений, возможность откатиться и удобный перенос на другие машины.

Пошаговая настройка

cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md USER.md IDENTITY.md TOOLS.md HEARTBEAT.md BOOT.md BOOTSTRAP.md memory/
git commit -m "Initial agent workspace"

Добавьте удалённый репозиторий (GitHub, GitLab, Gitea):

git branch -M main
git remote add origin https://github.com/yourname/openclaw-workspace.git
git push -u origin main

Или через GitHub CLI:

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

.gitignore

Создайте файл .gitignore в корне workspace:

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

Никогда не коммитьте API-ключи, пароли и OAuth-токены даже в приватный репозиторий. Используйте переменные окружения или ~/.openclaw/credentials/.

Синхронизация

После каждой значимой сессии:

cd ~/.openclaw/workspace
git add .
git commit -m "Update memory and context"
git push

Перенос workspace на новую машину

Клонируйте репозиторий в новое место:

git clone https://github.com/yourname/openclaw-workspace.git ~/openclaw-workspace

Укажите новый путь в конфиге:

// ~/.openclaw/openclaw.json
{
  agents: {
    defaults: {
      workspace: "~/openclaw-workspace"
    }
  }
}

Создайте недостающие файлы:

openclaw setup --workspace ~/openclaw-workspace

Команда openclaw setup создаст недостающие bootstrap-файлы, не перезаписывая существующие.

Перенос сессий (опционально):

# Скопируйте сессии со старой машины
rsync -avz old-machine:~/.openclaw/agents/ ~/.openclaw/agents/

Sandbox workspace

При включённой песочнице (agents.defaults.sandbox.mode) файловые инструменты могут работать не в основном workspace, а в изолированной директории:

`workspaceAccess`	Поведение
`"rw"`	Полный доступ к основному workspace
`"ro"`	Workspace доступен только для чтения (монтируется в `/agent`)
`"none"`	Работа в `~/.openclaw/sandboxes/` вместо основного workspace

Конфигурация:

{
  agents: {
    defaults: {
      sandbox: {
        mode: "docker",
        workspaceAccess: "ro"
      }
    }
  }
}

Подробнее про безопасность и песочницу →

Per-agent workspace

Если у вас несколько агентов, каждый может иметь собственный workspace:

{
  agents: {
    list: [
      {
        id: "work",
        name: "Рабочий ассистент",
        workspace: "~/openclaw-workspace"
      },
      {
        id: "personal",
        name: "Личный ассистент",
        workspace: "~/openclaw-personal"
      }
    ]
  }
}

Отключение автосоздания файлов

Если вы управляете workspace через git и не хотите, чтобы OpenClaw создавал bootstrap-файлы автоматически:

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

Чтобы пропустить только необязательные файлы (SOUL.md, USER.md, HEARTBEAT.md, IDENTITY.md):

{
  agents: {
    defaults: {
      skipOptionalBootstrapFiles: true
    }
  }
}

Полезные команды

# Пересоздать workspace (только недостающие файлы)
openclaw setup --workspace ~/.openclaw/workspace

# Проверить конфигурацию агента
openclaw doctor

# Посмотреть текущий workspace
openclaw config get agents.defaults.workspace

# Изменить workspace
openclaw config set agents.defaults.workspace "/new/path"

Структура workspace в одной схеме

~/.openclaw/workspace/
├── AGENTS.md          ← операционные инструкции
├── SOUL.md            ← личность и стиль
├── USER.md            ← кто вы
├── IDENTITY.md        ← имя и эмодзи
├── TOOLS.md           ← соглашения по инструментам
├── HEARTBEAT.md       ← периодические проверки
├── BOOT.md            ← стартовый чеклист
├── BOOTSTRAP.md       ← ритуал первого запуска
├── MEMORY.md          ← долгосрочная память
├── memory/
│   ├── 2026-05-04.md  ← лог вчера
│   └── 2026-05-05.md  ← лог сегодня
├── skills/
│   └── my-project/
│       └── SKILL.md   ← локальный скилл
├── canvas/            ← Canvas UI файлы
└── .gitignore         ← никогда не коммитьте секреты

Что дальше