Розділ 5: Запуск ваших агентів

Що відбувається в цьому розділі

Ви зареєструєте кожного агента в OpenClaw і надасте йому першу команду. Наприкінці всі 6 агентів будуть активні — звітуватимуть у своїх каналах Discord і будуть готові отримувати від вас інструкції.

Два способи спілкуватися з вашими агентами:

Метод	Найкраще для	Як це працює
OpenGoat UI	Початківців — візуальний інтерфейс	Панель у браузері, оберіть агента кліком і введіть повідомлення
Термінал VS Code	Рекомендовано — швидше, більше контролю	`openclaw agent --agent [id] "ваше повідомлення"`

Обидва методи працюють. Почніть з того, який зручніший.

Рекомендований підхід — гібридний з AI: Коли ви лише починаєте, тримайте свій чат-ІІ відкритим поруч із вашими агентами. Якщо команда не спрацьовує або ви не впевнені, що ввести — просто опишіть ситуацію AI і попросіть допомоги. Саме так більшість людей — включно з командою BALIA OS — починали. Вам не потрібно опановувати термінал за перший день. Вікно чату AI завжди поруч як ваш другий пілот.

Як працює цей розділ

Вставте підказку нижче у ваш чат-ІІ. AI проведе вас через реєстрацію всіх 6 агентів і надсилання першої команди кожному з них. Прикріпіть ваш документ з дизайну команди, щоб AI знав ID ваших агентів і шляхи до workspace.

Якщо щось піде не так, опишіть помилку або зробіть скриншот і поділіться ним — AI допоможе виправити.

▶ Вставте це у свій AI для початку

Прикріпіть ваш документ з дизайну команди перед відправкою.

Ви допомагаєте мені зареєструвати та запустити мою мультиагентну команду
BALIA OS в OpenClaw.

Я прикріпив документ з дизайну команди. Прочитайте його, щоб отримати ID
і назви агентів перед початком.

Перш ніж почати, запитайте мене:
«Яке ваше ім'я користувача Windows? (Ім'я в C:\Users\[ім'я
користувача])»
Використовуйте це ім'я користувача в усіх шляхах до файлів протягом усієї
сесії.
Усі мої файли агентів розташовані під $env:USERPROFILE/.opengoat/

Ведіть мене крок за кроком. По одному кроку за раз. Якщо я зіткнуся з
помилкою, допоможіть виправити її, перш ніж рухатись далі. Якщо я
застрягну, попросіть мене поділитися скриншотом або вставити повідомлення
про помилку.

Ось що нам потрібно зробити:

КРОК 1 — Запустити шлюз
Скажіть мені: «Ми запустимо шлюз OpenClaw командою, яка відфільтровує
шумні фонові журнали, щоб термінал залишався читабельним.»

Скеруйте мене відкрити нову вкладку терміналу VS Code і виконати
правильну команду для моєї ОС (запитайте мене, на якій ОС я, якщо ще не
знаєте):

Windows:
  $env:DEBUG="-ciao*"; openclaw gateway --force

Mac:
  DEBUG="-ciao*" openclaw gateway --force

Поясніть, що це робить:
«Частина DEBUG='-ciao*' приховує фонові журнали мережевого виявлення, які
б інакше заповнили термінал. Прапорець --force очищає будь-який
попередній екземпляр шлюзу. Ваш термінал залишиться чистим і
читабельним.»

Попросіть мене підтвердити, що я бачу: «✓ Gateway running on port 18789»
Скажіть залишити цю вкладку терміналу відкритою — шлюз має продовжувати
працювати.
Якщо виникне помилка, допоможіть її виправити, перш ніж рухатись далі.

КРОК 2 — Зареєструвати кожного агента в OpenClaw
Спочатку поясніть:
«Виконання цієї команди робить дві речі: реєструє агента в OpenClaw і
автоматично генерує config.json та models.json цього агента під
agents/[agentid]/. Вам не потрібно створювати ці файли самостійно.»

Для кожного з моїх 6 агентів (зчитайте ID з документа з дизайну команди)
скеруйте мене виконати цю команду в терміналі VS Code:

Windows:
openclaw agents add [agentid] --workspace $env:USERPROFILE\.opengoat\workspaces\[agentid]

Mac:
openclaw agents add [agentid] --workspace ~/.opengoat/workspaces/[agentid]

Приклад (Windows): openclaw agents add marcus --workspace C:\Users\john\.opengoat\workspaces\marcus
(marcus — приклад — замініть на реальні ID ваших агентів з документа з
дизайну команди.)

Покажіть мені всі 6 команд одразу з моїми реальними ID агентів та іменем
користувача.
Попросіть мене виконати їх по черзі і підтвердити успіх кожної, перш ніж
показувати наступну.

Після реєстрації всіх 6 скеруйте мене перевірити:
openclaw agents list
Попросіть мене підтвердити, що всі 6 агентів з'явились у списку.

КРОК 2b — Перевірити реєстрацію Охоронця Безпеки
Охоронця Безпеки вже зареєстровано в OpenClaw у Розділі 4.
Скеруйте мене перевірити його наявність:

openclaw agents list

Попросіть мене підтвердити, що security-guardian є у списку.
Якщо він відсутній, скеруйте мене виконати:

Windows:
openclaw agents add security-guardian --workspace $env:USERPROFILE\.opengoat\workspaces\security-guardian

Mac:
openclaw agents add security-guardian --workspace ~/.opengoat/workspaces/security-guardian

Потім перевірте список ще раз, перш ніж рухатись далі.

КРОК 3 — Перезапустити шлюз
Після реєстрації агентів шлюз потрібно перезапустити, щоб завантажити їх.
Скеруйте мене виконати:
openclaw gateway restart
Попросіть мене підтвердити, що шлюз знову працює, перш ніж рухатись
далі.

КРОК 4 — Запустити Охоронця Безпеки (PM2)
Охоронець Безпеки безперервно працює у фоновому режимі за допомогою PM2.
Скеруйте мене запустити його:

pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\guardian.js --name security-guardian

(Mac: замініть шлях на
~/.opengoat/workspaces/security-guardian/scripts/guardian.js)

Потім збережіть список процесів PM2, щоб він автоматично відновлювався
після перезавантаження:
pm2 save

Попросіть мене підтвердити, що я бачу Охоронця Безпеки у списку PM2:
pm2 list

Потім попросіть мене підтвердити, що я бачу повідомлення про запуск у
каналі Discord #security-channel.

КРОК 5 — Надіслати першу команду через термінал VS Code (рекомендовано)
Спочатку поясніть:
«Термінал VS Code — рекомендований спосіб спілкування з вашими агентами.
Команда виглядає так:
openclaw agent --agent [agentid] 'ваше повідомлення тут'

Це надсилає повідомлення напряму цьому конкретному агенту.»

Скеруйте мене надіслати тестову команду першому агенту:
openclaw agent --agent [перший-agentid] 'Будь ласка, представтесь і
підтвердіть, що прочитали свої SOUL.md, AGENTS.md, IDENTITY.md,
HEARTBEAT.md, TOOLS.md та USER.md.
Потім повідомте у свій канал Discord, що ви онлайн.'

Запитайте мене: «Що відповів агент?
Ви побачили повідомлення у його каналі Discord?»
Якщо так — чудово, переходьте до наступного агента.
Якщо ні — допоможіть усунути несправність.

Повторіть для всіх 6 агентів.

КРОК 6 — (Необов'язково) Налаштування OpenGoat UI
Після того, як усіх агентів підтверджено робочими через термінал,
запропонуйте:
«Ви також можете спілкуватися зі своїми агентами через OpenGoat UI —
візуальну панель у браузері.
Бажаєте налаштувати і це?
Це дає вам клікабельний інтерфейс для вибору агентів та надсилання
повідомлень без введення команд у терміналі.»
Якщо так: скеруйте мене:
1. Відкрити нову вкладку терміналу VS Code
2. Виконати: opengoat start
3. Браузер відкриється автоматично з OpenGoat UI
Проведіть мене по інтерфейсу — як обрати агента і надіслати повідомлення.
(Якщо браузер не відкрився автоматично, перейдіть на
http://localhost:19123)
Якщо ні: пропустіть і переходьте до Кроку 7.

КРОК 7 — Фінальне підтвердження
Пройдіться зі мною по цьому чек-листу:
□ Усі 6 агентів зареєстровано (openclaw agents list показує всіх 6)
□ Охоронця Безпеки зареєстровано (security-guardian з'являється у списку)
□ Охоронець Безпеки працює в PM2 (pm2 list показує online)
□ Шлюз працює (порт 18789)
□ Кожен агент відповів на першу команду
□ Кожен агент опублікував повідомлення у своєму каналі Discord
□ (Необов'язково) OpenGoat UI доступний на localhost:19123

КРОК 8 — Згенерувати CLAUDE.md
Коли всі 6 агентів (включно з Охоронцем Безпеки) підтверджено
зареєстрованими та працюючими, скеруйте мене згенерувати CLAUDE.md —
файл інструкцій, який Claude Code автоматично зчитує на початку кожної
сесії:

«Тепер згенеруємо ваш CLAUDE.md. Він створюється автоматично на основі
вже завершеного налаштування вашої команди, тож вам не потрібно нічого
заповнювати вручну.»

Windows:
cd $env:USERPROFILE\.opengoat\workspaces\security-guardian
node generate_claude_md.js

Mac:
cd ~/.opengoat/workspaces/security-guardian
node generate_claude_md.js

Попросіть мене підтвердити, що я бачу повідомлення, яке закінчується
приблизно так:
[OK] CLAUDE.md generated: (ваш шлях)\.opengoat\CLAUDE.md

Якщо CLAUDE.md вже існує, скрипт автоматично спочатку створить резервну
копію, а потім запитає, чи перезаписати. «yes» перезаписує (резервна
копія вже збережена); «no» зберігає новий вміст як
CLAUDE_generated_draft.md, залишаючи існуючий CLAUDE.md повністю
недоторканим.

Якщо запитають про придбаний рівень (T1 / T2 / T3), скеруйте мене ввести
мій фактичний рівень.

Після генерації попросіть мене відкрити
$env:USERPROFILE\.opengoat\CLAUDE.md і підтвердити, що назви команди та
ролі виглядають правильно.

Коли всі пункти відмічено, скажіть:
«Ваша команда BALIA OS активна. Усі 6 агентів працюють і звітують у
Discord. Ви готові до Розділу 6 — Створення вашої першої касети.»

Починайте зараз. Поставте мені перше питання.

Про CLAUDE.md

Файл CLAUDE.md, згенерований на КРОЦІ 8, — це файл інструкцій, який Claude Code у VS Code автоматично зчитує на початку кожної сесії. Він генерується саме на цьому етапі — одразу після того, як усіх агентів підтверджено зареєстрованими та працюючими — безпосередньо під $env:USERPROFILE.opengoat.

Що включено автоматично:

Таблиця складу команди (імена та ролі всіх 6 агентів)
Абсолютна заборона руйнівних операцій (потрібне підтвердження перед видаленням/перезаписом файлів тощо)
Обробка конфіденційної інформації (ключі API, webhook тощо не виводяться у відкритому тексті)
Правила мови виведення

Налаштування: Усе, що нижче розділу ## Feel free to customize everything below this line внизу файлу, — ваше для редагування: додавайте специфічні для проекту правила, часто вживані команди чи будь-що інше корисне.

Два розділи ближче до початку — ## Absolute Prohibition on Destructive Operations (Critical — Always Follow — Do Not Delete) та ## Handling of Sensitive Information (Do Not Delete) — це основні правила безпеки. Вони з'являються обраною вами мовою (підтримується 20 мов). Не видаляйте і не змінюйте ці два розділи.

Якщо CLAUDE.md вже існує: Виконання КРОКУ 8 ніколи мовчки не перезапише існуючий CLAUDE.md. Скрипт спочатку автоматично зробить резервну копію, а потім запитає, чи перезаписати. Відповівши «no», ви залишаєте існуючий файл повністю недоторканим — новостворений вміст зберігається окремо як CLAUDE_generated_draft.md.

Щоденне спілкування з вашими агентами

Коли все налаштовано, ось як надавати команди:

Запустіть шлюз (робіть це першим щосесії):

Windows:

$env:DEBUG="-ciao*"; openclaw gateway --force

Mac:

DEBUG="-ciao*" openclaw gateway --force

Залиште цю вкладку терміналу працювати. Відкрийте нову вкладку для інших команд.

Через термінал VS Code:

# Поговорити з конкретним агентом
openclaw agent --agent marcus "Підсумуй, над чим ти працював сьогодні"

# Перевірити список агентів
openclaw agents list

# Перезапустити шлюз за потреби
openclaw gateway restart

marcus — це приклад — замініть на власний ID агента (наприклад, --agent ceo або --agent nova).

Через OpenGoat UI:

Відкрийте нову вкладку терміналу VS Code
Виконайте: opengoat start
Браузер відкриється автоматично з OpenGoat UI
Оберіть агента на лівій панелі
Введіть повідомлення і натисніть Enter (Якщо браузер не відкрився автоматично: перейдіть на http://localhost:19123)

Через Discord (лише звіти — не для команд): Discord — це місце, де ваші агенти публікують свої звіти. Тут ви читаєте їхні оновлення. Надсилання команд агентам через Discord потребує Discord-бота — це просунуте налаштування, яке не розглядається в T1. Наразі використовуйте термінал VS Code або OpenGoat UI, щоб надавати команди.

Якщо агент не відповідає

Перевіряйте по порядку:

Чи працює шлюз?
```
openclaw gateway restart
```
Чи зареєстрований агент?
```
openclaw agents list
```
Якщо вашого агента немає у списку, повторно виконайте команду agents add з Кроку 2.
Чи файли workspace на своєму місці?
Перевірте, що SOUL.md, AGENTS.md та IDENTITY.md існують у:
Windows: $env:USERPROFILE\.opengoat\workspaces\[agentid]\
Mac: ~/.opengoat/workspaces/[agentid]/
Чи правильно встановлено ключ API? Відкрийте .env (у вашій папці .opengoat) і підтвердьте, що ANTHROPIC_API_KEY заповнено.

Якщо все ще не виходить, вставте повідомлення про помилку у ваш чат-ІІ і попросіть допомоги.

Перевірте своє налаштування

Коли всіх агентів підтверджено активними, виконайте:

Windows:

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

Mac:

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

Це підтверджує, що всіх 6 агентів зареєстровано, Охоронець Безпеки працює, і ви готові до Розділу 6.

Що відбувається в цьому розділі ​

Як працює цей розділ ​

▶ Вставте це у свій AI для початку

Про CLAUDE.md ​

Щоденне спілкування з вашими агентами ​