Что вы создаёте

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

Конфигурация агента — генерируется автоматически OpenClaw, вы не создаёте это здесь:

Файл	Расположение	Назначение
config.json	agents/[id]/config.json	Определение агента в OpenClaw, системный промпт
models.json	agents/[id]/models.json	Настройки AI-модели

Вы не создаёте эти файлы в Разделе 4. Выполнение openclaw agents add [id] --workspace ... в Разделе 5 генерирует оба файла автоматически при регистрации каждого агента — здесь достаточно знать, что они существуют.

Файлы workspace — загружаются OpenClaw автоматически при каждой сессии:

Файл	Назначение
SOUL.md	Личность, тон, жёсткие ограничения, миссия — не более 400 слов
AGENTS.md	Правила работы, процедуры отчётности — не более 400 слов
IDENTITY.md	Имя, роль, кому подчиняется — только факты, коротко
HEARTBEAT.md	Постоянные обязанности, регулярные задачи, реакция на аномалии
TOOLS.md	Разрешённые инструменты, правила навыков, запрещённые действия
USER.md	Предпочтения Командира, стиль общения, часовой пояс

Файл детализации роли — читается один раз за сессию через инструкцию AGENTS.md:

Файл	Назначение
SPEC_[ИМЯ].md	Подробное описание роли, обязанностей, ключевые пути

Только для CEO — папка identity:

Файл	Назначение
identity/COMPANY_PROFILE.md	История компании, бизнес-детали
identity/PERSONAL_PROFILE.md	Биография владельца, навыки, опыт
identity/VALUES.md	Стиль мышления, ценности, принципы принятия решений

Полная структура workspace — все агенты:

INFO

$env:USERPROFILE/.opengoat/ ├── agents/ │ └── [agentid]/ │ ├── config.json ← автоматически создаётся в Разделе 5 │ └── models.json ← автоматически создаётся в Разделе 5 └── workspaces/ └── [agentid]/ ├── SOUL.md ← загружается автоматически ├── AGENTS.md ← загружается автоматически ├── IDENTITY.md ← загружается автоматически ├── HEARTBEAT.md ← загружается автоматически ├── TOOLS.md ← загружается автоматически ├── USER.md ← загружается автоматически └── SPEC_[ИМЯ].md ← читается по инструкции из AGENTS.md

Workspace CEO — дополнительная папка identity:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ├── PERSONAL_PROFILE.md └── VALUES.md

---

Как Работает Раздел 4

В этом разделе вы будете работать с вашим AI-консьержем, чтобы спроектировать каждого агента. Для каждого агента вы решите:

• Имя и роль
• Личность и стиль общения
• Какие инструменты он может использовать

После согласования дизайна с вашим AI-консьержем Охранник Безопасности автоматически запишет файлы конфигурации. Вам не нужно редактировать файлы вручную.

Как Работает Этот Раздел — Две Части

Этот раздел состоит из двух частей. Выполните их по порядку:

Часть 1 — Настройка Discord (промпт ниже) Создайте сервер Discord, каналы и получите URL Webhook для каждого агента. Это займёт около 10 минут.

Часть 2 — Файлы Агентов (следующий промпт) Сгенерируйте реальные файлы агентов с помощью Документа по проектированию команды. ИИ сгенерирует команды терминала — вставьте их в VS Code, чтобы файлы создались автоматически.

Начните с Части 1.

---

URL-адреса Discord Webhook — получите их в первую очередь

Каждый агент отправляет отчёты в свой канал Discord через Webhook URL. Эти адреса нужны вам до того, как вы начнёте писать файлы AGENTS.md.

▶ Вставьте это в свой ИИ, чтобы начать

Прикрепите документ Team Design Document перед отправкой.

Вы помогаете мне настроить каналы Discord и URL-адреса Webhook для
моей мультиагентной команды BALIA OS.

Ведите меня шаг за шагом. Задавайте по одному вопросу за раз.
Если я застряну, попросите меня сделать скриншот и описать, что я вижу.

Я приложил свой Документ по проектированию команды.

ШАГ 1 — Проверьте Discord
Спросите: «Установлен ли у вас Discord и настроен ли аккаунт?»
Если нет: направьте меня на discord.com для загрузки и создания аккаунта.
Если да: перейдите к Шагу 2.

ШАГ 2 — Создайте сервер Discord
Направьте меня для создания нового сервера:
- Нажмите кнопку + на левой боковой панели
- Выберите «Создать свой» -> «Для меня и моих друзей»
- Назовите его «BALIA OS Team»
Подтвердите, что я его вижу, прежде чем продолжить.

ШАГ 3 — Создайте каналы для каждого агента
Прочитайте мой Документ по проектированию команды для имён каналов.
Для каждого агента создайте один текстовый канал:
- Правой кнопкой мыши на «Текстовые каналы» -> Создать канал -> Текст
- Используйте имя канала из моего Документа по проектированию команды
Повторите для всех 6 агентов. Подтвердите, что все каналы существуют, прежде чем продолжить.

ШАГ 4 — Получите URL Webhook для каждого канала
По одному каналу за раз:
1. Правой кнопкой мыши на канале -> Редактировать канал
2. Интеграции -> Вебхуки -> Новый вебхук
3. Назовите в честь агента (например, «Marcus»)
4. Скопируйте URL Webhook
5. Попросите меня вставить его в безопасное место
Повторите для всех 6. Подтвердите, что все 6 URL сохранены, прежде чем продолжить.

ШАГ 5 — Добавьте в файл .env
Направьте меня открыть файл .env в VS Code.
Файл находится по пути:
- Windows: $env:USERPROFILE\.opengoat\.env
- Mac: ~/.opengoat/.env
Добавьте каждый webhook:
DISCORD_WEBHOOK_[ИМЯ_АГЕНТА]=https://discord.com/api/webhooks/xxxxx/xxxxx
(имена агентов ЗАГЛАВНЫМИ БУКВАМИ)
Скажите мне: «Никогда не делитесь этим файлом. Никогда не коммитьте его в GitHub.»

Когда все вебхуки сохранены: «Настройка Discord завершена.»

Начните сейчас. Задайте мне первый вопрос.

---

Использование AI-промпта

Вставьте приведённый ниже промпт в ваш чат-ИИ и прикрепите:

1. Ваш Документ по проектированию команды из Раздела 2

ИИ сгенерирует команды терминала для каждого агента по одной. Вставляйте команды в терминал VS Code, чтобы файлы создавались автоматически.

---

▶ Вставьте это в свой ИИ, чтобы начать

Вы помогаете мне создать файлы агентов для BALIA OS,
мультиагентной ИИ-операционной системы, построенной на OpenClaw.

Приложено:
1. Мой Документ по проектированию команды (из Раздела 2)

Прочитайте его перед генерацией чего-либо.
Извлеките все имена агентов, ID и имена каналов Discord из этого документа.

АРХИТЕКТУРА:

1. Я — Командир. Я командую каждым агентом напрямую. Без оркестратора.

2. У каждого агента два места хранения:
   - agents/[id]/ — конфигурация OpenClaw (config.json + models.json)
   - workspaces/[id]/ — файлы workspace (SOUL, AGENTS, IDENTITY, HEARTBEAT, TOOLS, USER, SPEC)
   Все пути находятся внутри $env:USERPROFILE/.opengoat/

3. OpenClaw автоматически внедряет SOUL.md, AGENTS.md, IDENTITY.md, HEARTBEAT.md,
   TOOLS.md, USER.md при каждом запуске сессии. Не пишите в них инструкции
   «прочитайте себя».

4. SPEC_[ИМЯ].md НЕ внедряется автоматически. Добавьте в Session Start файла
   AGENTS.md: «Прочитать SPEC_[ИМЯ_АГЕНТА].md для полных деталей роли»

5. Только у CEO есть папка identity/ внутри workspaces/ceo/:
   identity/COMPANY_PROFILE.md
   identity/PERSONAL_PROFILE.md
   identity/VALUES.md
   Генерируйте их только для агента CEO.

6. SOUL.md и AGENTS.md: менее 400 слов каждый (внедряются каждую сессию).
   SPEC: может быть подробным (читается один раз за сессию).

ПЕРЕД ГЕНЕРАЦИЕЙ — спросите меня:
«Как ваше имя пользователя Windows? (Имя в C:\Users\[имя пользователя])»
Дождитесь моего ответа, затем используйте это имя пользователя во всех путях к файлам.

ГЕНЕРИРОВАТЬ ДЛЯ КАЖДОГО АГЕНТА:

====================================
ФАЙЛ 1: SOUL.md
Путь: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md
Автоматически внедряется каждую сессию. Менее 400 слов.
====================================

# SOUL.md — [Имя агента]

## Кто Вы
[2-3 предложения: идентичность, личность, подход к работе]

## Тон
- [Правило 1]
- [Правило 2]
- [Правило 3]
- [Запрещённый стиль]

## Жёсткие ограничения
- Никогда не действовать за пределами определённой роли
- Никогда не сообщать о завершении без проверки результата
- Никогда не предпринимать разрушительных действий без одобрения Командира
- [1-2 ограничения, специфичные для роли]

## Текущая миссия
[1-2 предложения о текущем фокусе]

====================================
ФАЙЛ 2: AGENTS.md
Путь: $env:USERPROFILE/.opengoat/workspaces/[agentid]/AGENTS.md
Автоматически внедряется каждую сессию. Менее 400 слов.
====================================

# AGENTS.md — Операционные процедуры [Имя агента]

## Начало сессии (Каждая сессия — в этом порядке)
1. Подтвердить идентичность из SOUL.md
2. Прочитать SPEC_[ИМЯ_АГЕНТА].md для деталей роли
3. Прочитать HEARTBEAT.md — отметить регулярные задачи
4. Прочитать TOOLS.md — отметить разрешённые инструменты и ограничения
5. Прочитать USER.md — отметить предпочтения Командира
6. Отчитаться в Discord: «🔷 [Имя] готов. [текущая задача или статус]»

(Только CEO — после шага 2, также прочитать:
  identity/COMPANY_PROFILE.md
  identity/PERSONAL_PROFILE.md
  identity/VALUES.md)

## Конец сессии (Каждая сессия)
1. Отчитаться в Discord: «✅ [Имя] сессия завершена. [резюме]»
2. Отметить незавершённые задачи для следующей сессии

## Отчётность
- Канал: #[discord-канал]
- Команда: python $env:USERPROFILE/.opengoat/scripts/discord_send.py
  DISCORD_WEBHOOK_[ИМЯ] "сообщение"
  (discord_send.py разворачивается автоматически в разделе про Охранника
   Безопасности ниже)
- HTTP 204 = успех. Иначе = немедленно сообщить об ошибке.
- Формат: Вывод -> Детали -> Следующее рекомендуемое действие
- Сообщать при: начале сессии / завершении задачи / ошибке / конце сессии

## Обработка ошибок
1. Проверить SPEC_[ИМЯ].md на предмет известных паттернов ошибок
2. Не решено -> сообщить Командиру полные детали
3. Никаких деструктивных повторных попыток без одобрения Командира

## Жёсткие правила
- Проверить перед тем, как сообщать о завершении
- Никаких действий за пределами определённой роли
- Никаких деструктивных операций без одобрения Командира

====================================
ФАЙЛ 3: IDENTITY.md
Путь: $env:USERPROFILE/.opengoat/workspaces/[agentid]/IDENTITY.md
Автоматически внедряется. Только факты, хранить коротко.
====================================

# IDENTITY.md

Name: [Имя агента]
Agent ID: [agentid-строчными]
Role: [Название роли]
Department: BALIA OS Team
Reports To: Commander (directly)
Discord: #[имя канала]

====================================
ФАЙЛ 4: HEARTBEAT.md
Путь: $env:USERPROFILE/.opengoat/workspaces/[agentid]/HEARTBEAT.md
Автоматически внедряется. Регулярные обязанности и реакция на аномалии.
====================================

# HEARTBEAT.md — [Имя агента]

## Постоянно активно
[Что этот агент постоянно отслеживает или поддерживает]

## Регулярные задачи
[Повторяющиеся обязанности — ежедневные, еженедельные или по триггеру]

## При начале сессии
- Прочитать SOUL.md и AGENTS.md
- Отчитаться: «🔷 [Имя] готов»

## При ошибке или аномалии
- Немедленно сообщить Командиру через Discord
- Никогда не исправлять самостоятельно без одобрения Командира

====================================
ФАЙЛ 5: TOOLS.md
Путь: $env:USERPROFILE/.opengoat/workspaces/[agentid]/TOOLS.md
Автоматически внедряется. Правила и ограничения по инструментам.
====================================

# TOOLS.md — Правила инструментов [Имя агента]

## Основной принцип
- Перед каждой задачей проверять SPEC_[ИМЯ].md на предмет разрешённых инструментов
- Загружать только то, что требуется для задачи

## Разрешённые инструменты
[Список инструментов, относящихся к роли этого агента]

## Отчётность в Discord
Всегда использовать discord_send.py напрямую:
python $env:USERPROFILE/.opengoat/scripts/discord_send.py DISCORD_WEBHOOK_[ИМЯ] "сообщение"
После отправки подтверждать HTTP 204.

## Запрещено
- Хранить API-ключи или Webhook в коде напрямую (всегда читать из .env)
- Действия за пределами определённой роли
- Излишние внешние коммуникации

====================================
ФАЙЛ 6: USER.md
Путь: $env:USERPROFILE/.opengoat/workspaces/[agentid]/USER.md
Автоматически внедряется. Предпочтения Командира.
====================================

# USER.md — Профиль Командира

## Имя
[Предпочитаемое имя Командира]

## Часовой пояс
[Часовой пояс — спросите меня, если не указан в Документе по проектированию команды]

## Стиль общения
- [Предпочтение 1]
- [Предпочтение 2]

## Текущая фаза
[На чём мы сейчас сфокусированы]

====================================
ФАЙЛ 7: SPEC_[ИМЯ_АГЕНТА].md
Путь: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SPEC_[ИМЯ_АГЕНТА].md
Не внедряется автоматически. Читается один раз за сессию через AGENTS.md.
====================================

# SPEC_[ИМЯ_АГЕНТА] v1.0 — [Имя агента] ([Роль])
Последнее обновление: [сегодня]

## 1. Роль
[2-3 предложения]

## 2. Обязанности
[Список пунктов из Документа по проектированию команды]

## 3. Что этот агент НЕ делает
[Чёткие границы]

## 4. Миссия текущей фазы
[Текущий фокус]

## 5. Ключевые пути
- Workspace: $env:USERPROFILE/.opengoat/workspaces/[agentid]/
- Discord webhook: DISCORD_WEBHOOK_[ИМЯ] (читается из .env)

## 6. Журнал изменений
| Версия | Дата | Изменения |
|--------|------|-----------|
| v1.0 | [сегодня] | Начальное создание |

====================================
ТОЛЬКО CEO — ФАЙЛЫ 8, 9, 10: папка identity/
Задать эти 3 вопроса по одному перед генерацией.
====================================

Q1: «Расскажите мне о своём бизнесе — чем он занимается, как долго
    работает, какие рынки обслуживает.»

Q2: «Расскажите о себе — опыт, навыки, образование,
    связанные с этим бизнесом.»

Q3: «Как вы принимаете решения? Какие ценности вас направляют?
    Каких стилей мышления или перспектив вам хотелось бы больше?»

После всех 3 ответов сгенерировать:

COMPANY_PROFILE.md — содержание Q1, структурированное
PERSONAL_PROFILE.md — содержание Q2, структурированное
VALUES.md — содержание Q3, структурированное

Путь: $env:USERPROFILE/.opengoat/workspaces/ceo/identity/

Чем больше деталей здесь предоставлено, тем больше CEO думает и
принимает решения как владелец.

====================================

КАК ПЕРЕДАТЬ ФАЙЛЫ:

После генерации содержимого каждого файла выведите точную python-команду
для его создания. Формат:

--- ВСТАВЬТЕ В ТЕРМИНАЛ (Windows) ---
python -c "
content = '''[полное содержимое файла здесь]'''
import os
path = r'$env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md'
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

--- ВСТАВЬТЕ В ТЕРМИНАЛ (Mac) ---
python3 -c "
content = '''[полное содержимое файла здесь]'''
import os
path = os.path.expanduser('~/.opengoat/workspaces/[agentid]/SOUL.md')
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

Дождитесь, когда я вставлю команду и подтвержу, что она выполнилась, прежде чем
переходить к следующему файлу. Спросите: «Вы увидели 'Created: [путь]'?»

КАК ДЕЙСТВОВАТЬ:
- Начать с Агента #1 (не CEO)
- Генерировать по одному файлу за раз, по одному агенту за раз
- Всегда дожидаться подтверждения из терминала перед следующим файлом
- При достижении CEO: сначала задать 3 вопроса об идентичности,
  затем сгенерировать 7 основных файлов + 3 файла идентичности
- Закончить сводной таблицей всех созданных файлов

---

Когда ваш AI-консьерж подтвердит дизайн, попросите Охранника Безопасности записать файлы:

Windows:

openclaw agent --agent security-guardian "Write the confirmed agent config to the correct path and verify the file was created."

Охранник подтвердит, когда файлы будут записаны правильно.

---

Шаг 2 — Подтвердите, что файлы созданы

После того как ИИ проведёт вас через все файлы, проверьте workspace каждого агента:

Windows:

dir $env:USERPROFILE\.opengoat\workspaces\[agentid]

Mac:

ls ~/.opengoat/workspaces/[agentid]

Вы должны увидеть:

SOUL.md
AGENTS.md
IDENTITY.md
HEARTBEAT.md
TOOLS.md
USER.md
SPEC_[ИМЯ].md

Дополнительно для CEO:

identity/
├── COMPANY_PROFILE.md
├── PERSONAL_PROFILE.md
└── VALUES.md

---

Шаг 3 — Проверьте перед переходом к следующему агенту

Откройте AGENTS.md. Перечислены ли в разделе Session Start все шаги, включая HEARTBEAT.md, TOOLS.md и USER.md?

Да — переходите дальше. Нет — сначала попросите ИИ исправить это.

---

Когда этот раздел завершён

Workspace каждого агента:

INFO

workspaces/[agentid]/ ├── SOUL.md ✅ ├── AGENTS.md ✅ ├── IDENTITY.md ✅ ├── HEARTBEAT.md ✅ ├── TOOLS.md ✅ ├── USER.md ✅ └── SPEC_[ИМЯ].md ✅

Дополнительно для CEO:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ✅ ├── PERSONAL_PROFILE.md ✅ └── VALUES.md ✅

---

Примечание: Охранник Безопасности был развёрнут в Разделе 3. Если вы пропустили Раздел 3, вернитесь и завершите его перед Разделом 5.

---

Проверка настройки

После того как все файлы агентов созданы, выполните:

Windows:

node $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\verify_setup.js --section 4

Mac:

node ~/.opengoat/workspaces/security-guardian/scripts/verify_setup.js --section 4

Эта команда подтверждает, что все файлы агентов на месте, прежде чем вы запустите свою команду в Разделе 5.