Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

The workspace — це домівка агента. Це єдиний робочий каталог, який використовується для файлових інструментів і контексту workspace. Зберігайте його приватним і розглядайте як пам’ять. Це окремо від ~/.openclaw/, де зберігаються конфігурація, облікові дані та сесії.
Workspace — це типовий cwd, а не жорстка пісочниця. Інструменти розв’язують відносні шляхи відносно workspace, але абсолютні шляхи все ще можуть діставатися інших місць на хості, якщо sandboxing не ввімкнено. Якщо вам потрібна ізоляція, використовуйте agents.defaults.sandbox (та/або sandbox-конфігурацію для окремого агента).Коли sandboxing увімкнено, а workspaceAccess не є "rw", інструменти працюють усередині sandbox workspace в ~/.openclaw/sandboxes, а не у вашому workspace на хості.

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

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

​
Додаткові папки workspace

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

​
Мапа файлів workspace

Це стандартні файли, які OpenClaw очікує всередині workspace:
Робочі інструкції для агента й те, як він має використовувати пам’ять. Завантажується на початку кожної сесії. Добре місце для правил, пріоритетів і деталей про те, «як поводитися».
Персона, тон і межі. Завантажується в кожній сесії. Посібник: посібник з особистості SOUL.md.
Хто такий користувач і як до нього звертатися. Завантажується в кожній сесії.
Ім’я агента, вайб і емодзі. Створюється/оновлюється під час bootstrap-ритуалу.
Нотатки про ваші локальні інструменти й домовленості. Не керує доступністю інструментів; це лише настанови.
Необов’язковий маленький контрольний список для запусків heartbeat. Тримайте його коротким, щоб уникнути витрат токенів.
Необов’язковий контрольний список запуску, який автоматично виконується під час перезапуску Gateway (коли ввімкнено внутрішні hooks). Тримайте його коротким; використовуйте message tool для вихідних надсилань.
Одноразовий ритуал першого запуску. Створюється лише для абсолютно нового workspace. Видаліть його після завершення ритуалу.
Щоденний журнал пам’яті (один файл на день). Рекомендовано читати сьогоднішній + вчорашній на початку сесії.
Кураторована довготривала пам’ять: сталі факти, уподобання, рішення й короткі підсумки. Тримайте докладні журнали в memory/YYYY-MM-DD.md, щоб інструменти пам’яті могли отримувати їх на вимогу без вставляння в кожен prompt. Завантажуйте MEMORY.md лише в основній приватній сесії (не в shared/group-контекстах). Див. Memory щодо workflow та автоматичного скидання пам’яті.
Skills, специфічні для workspace. Розташування Skills з найвищим пріоритетом для цього workspace. Перевизначає Skills агента проєкту, особисті Skills агента, керовані Skills, вбудовані Skills і skills.load.extraDirs, коли назви збігаються.
Файли Canvas UI для відображень вузлів (наприклад, canvas/index.html).
Якщо будь-якого bootstrap-файлу немає, OpenClaw вставляє в сесію маркер «missing file» і продовжує. Великі bootstrap-файли обрізаються під час вставлення; налаштуйте ліміти через agents.defaults.bootstrapMaxChars (типово: 12000) і agents.defaults.bootstrapTotalMaxChars (типово: 60000). openclaw setup може відтворити відсутні типові файли без перезапису наявних.

​
Чого НЕ має бути у workspace

Це розташовано в ~/.openclaw/ і НЕ має комітитися в репозиторій workspace:
  • ~/.openclaw/openclaw.json (конфігурація)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (профілі автентифікації моделей: OAuth + API keys)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (окремий для агента обліковий запис runtime Codex, конфігурація, Skills, plugins і нативний стан thread)
  • ~/.openclaw/credentials/ (стан channel/provider плюс застарілі дані імпорту OAuth)
  • ~/.openclaw/agents/<agentId>/sessions/ (транскрипти сесій + метадані)
  • ~/.openclaw/skills/ (керовані Skills)
Якщо потрібно перенести сесії або конфігурацію, скопіюйте їх окремо й не додавайте до контролю версій.

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

Розглядайте workspace як приватну пам’ять. Помістіть його в приватний git-репозиторій, щоб він мав резервну копію й міг бути відновлений. Виконайте ці кроки на машині, де працює Gateway (саме там розташований workspace).
1

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

Якщо git встановлено, абсолютно нові workspace ініціалізуються автоматично. Якщо цей workspace ще не є репозиторієм, виконайте:
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 (це уникає merge conflicts).
  3. Скопіюйте HTTPS remote URL.
  4. Додайте remote і виконайте push:
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

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

Навіть у приватному репозиторії уникайте зберігання секретів у workspace:
  • API keys, OAuth tokens, passwords або приватні облікові дані.
  • Будь-що під ~/.openclaw/.
  • Сирі дампи чатів або чутливих вкладень.
Якщо потрібно зберігати чутливі посилання, використовуйте placeholders і тримайте справжній секрет в іншому місці (password manager, environment variables або ~/.openclaw/).
Рекомендований початковий .gitignore: 
.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

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

1

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

Клонуйте репозиторій у потрібний шлях (типово ~/.openclaw/workspace).
2

Оновіть конфігурацію

Встановіть agents.defaults.workspace на цей шлях у ~/.openclaw/openclaw.json.
3

Заповніть відсутні файли

Виконайте openclaw setup --workspace <path>, щоб додати будь-які відсутні файли.
4

Скопіюйте сесії (необов’язково)

Якщо вам потрібні сесії, окремо скопіюйте ~/.openclaw/agents/<agentId>/sessions/ зі старої машини.

​
Розширені нотатки

  • Multi-agent routing може використовувати різні workspaces для кожного агента. Див. Channel routing щодо конфігурації routing.
  • Якщо agents.defaults.sandbox увімкнено, non-main сесії можуть використовувати per-session sandbox workspaces під agents.defaults.sandbox.workspaceRoot.

​
Пов’язане

  • Heartbeat - файл workspace HEARTBEAT.md
  • Sandboxing - доступ до workspace у sandboxed середовищах
  • Session - шляхи зберігання сесій
  • Standing orders - постійні інструкції у файлах workspace