English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Fundamentals

Робочий простір агента

Робочий простір — це дім агента. Це єдиний робочий каталог, який використовується для файлових інструментів і контексту робочого простору. Зберігайте його приватним і ставтеся до нього як до пам’яті.

Це окремо від ~/.openclaw/, де зберігаються конфігурація, облікові дані та сесії.

Типове розташування

  • Типово: ~/.openclaw/workspace
  • Якщо OPENCLAW_PROFILE задано і він не дорівнює "default", типовим стає ~/.openclaw/workspace-<profile>.
  • Перевизначення в ~/.openclaw/openclaw.json:
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}

openclaw onboard, openclaw configure або openclaw setup створять робочий простір і додадуть початкові файли, якщо їх немає.

Якщо ви вже керуєте файлами робочого простору самостійно, можете вимкнути створення початкових файлів:

{ 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 (коли внутрішні hooks увімкнено). Тримайте його коротким; використовуйте інструмент повідомлень для вихідних надсилань.

BOOTSTRAP.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/ (обліковий запис середовища виконання Codex для окремого агента, конфігурація, Skills, plugins і нативний стан гілки)
  • ~/.openclaw/credentials/ (стан каналу/провайдера плюс застарілі дані імпорту OAuth)
  • ~/.openclaw/agents/<agentId>/sessions/ (транскрипти сесій + метадані)
  • ~/.openclaw/skills/ (керовані Skills)

Якщо вам потрібно мігрувати сесії або конфігурацію, скопіюйте їх окремо й тримайте поза контролем версій.

Git-резервна копія (рекомендовано, приватна)

Ставтеся до робочого простору як до приватної пам’яті. Помістіть його в приватний git-репозиторій, щоб мати резервну копію й можливість відновлення.

Виконайте ці кроки на машині, де працює Gateway (саме там розташований робочий простір).

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

    Якщо 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"

  • Додайте приватний remote

    Вебінтерфейс GitHub

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

    GitHub CLI (gh)

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

    Вебінтерфейс GitLab

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

  • Поточні оновлення

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

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

    Запропонований стартовий .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.

    Пов’язане