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

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

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

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

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

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

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

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

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

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

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

Прикріпіть документ Team Design Document перед відправленням.

You are helping me register and launch my BALIA OS multi-agent team 
on OpenClaw.

I have attached my Team Design Document. Read it to get my agent IDs,
names, and workspace paths before starting.

My balia-os path is set in my .env file as BALIA_OS_PATH.
Please ask me to open my .env file and read the value of BALIA_OS_PATH,
then use that path throughout this session.

Guide me step by step. One step at a time. If I hit an error,
help me fix it before moving on. If I get stuck, ask me to share
a screenshot or paste the error message.

Here is what we need to do:

STEP 1 — Start the gateway
Tell me: "We'll start the OpenClaw gateway with a command that filters 
out noisy background logs so the terminal stays readable."

Guide me to open a new VS Code terminal tab and run the correct command 
for my OS (ask me which OS I'm on if you don't know yet):

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

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

Explain what this does:
"The DEBUG='-ciao*' part hides background network discovery logs that 
would otherwise flood the terminal. The --force flag clears any 
previous gateway instance. Your terminal will stay clean and readable."

Ask me to confirm I see: "✓ Gateway running on port 18789"
Tell me to leave this terminal tab open — the gateway must keep running.
If there's an error, help me fix it before moving on.

STEP 2 — Register each agent with OpenClaw
For each of my 6 agents (read IDs from Team Design Document),
guide me to run this command in the VS Code terminal:

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

Example: openclaw agents add marcus --workspace ~/.opengoat/workspace-marcus

Show me all 6 commands at once with my actual agent IDs filled in.
Ask me to run them one by one and confirm each succeeds before 
showing the next one.

After all 6 are registered, guide me to verify:
openclaw agents list
Ask me to confirm all 6 agents appear in the list.

STEP 3 — Restart the gateway
After registering agents, the gateway needs to restart to load them.
Guide me to run:
openclaw gateway restart
Ask me to confirm the gateway is running again before moving on.

STEP 4 — Send first command via VS Code terminal (recommended)
Explain this first:
"The VS Code terminal is the recommended way to talk to your agents.
The command is:
openclaw agent --agent [agentid] 'your message here'

This sends a message directly to that specific agent."

Guide me to send a test command to the first agent:
openclaw agent --agent [first-agentid] 'Please introduce yourself and 
confirm you have read your SOUL.md, AGENTS.md, and IDENTITY.md. 
Then report to your Discord channel that you are online.'

Ask me: "What did the agent respond? 
Did you see a message appear in its Discord channel?"
If yes: great — move to next agent.
If no: help me troubleshoot.

Repeat for all 6 agents.

STEP 5 — (Optional) OpenGoat UI setup
After all agents are confirmed working via terminal, offer:
"You can also talk to your agents through the OpenGoat UI — 
a visual browser dashboard.
Would you like to set that up as well?
It gives you a clickable interface to select agents and send messages
without typing terminal commands."
If yes: guide me to:
1. Open a new VS Code terminal tab
2. Run: opengoat start
3. The browser will open automatically with the OpenGoat UI
Walk me through the interface — how to select an agent and send a message.
(If the browser doesn't open automatically, go to http://localhost:18789)
If no: skip and move to Step 6.

STEP 6 — Final confirmation
Run through this checklist with me:
□ All 6 agents registered (openclaw agents list shows all 6)
□ Gateway running (port 18789)
□ Each agent responded to first command
□ Each agent posted to their Discord channel
□ (Optional) OpenGoat UI accessible at localhost:18789

When all boxes are checked, say:
"Your BALIA OS team is live. All 6 agents are running and reporting 
to Discord. You're ready for Section 6 — Building Your First 
Skill Cassette."

Start now. Ask me the first question.

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

Після того як усе налаштовано, ось як ви надаєте команди:

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

Windows:

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

Mac:

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

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

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

# Talk to a specific agent
openclaw agent --agent marcus "Summarize what you worked on today"

# Check agent list
openclaw agents list

# Restart gateway if needed
openclaw gateway restart

Через OpenGoat UI:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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