섹션 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개의 에이전트를 모두 등록하고 각 에이전트에 첫 번째 명령을 보내는 과정을 안내해 줄 것입니다. AI가 여러분의 에이전트 ID와 workspace 경로를 파악할 수 있도록 팀 설계 문서를 첨부하세요.

문제가 발생하면 오류 내용을 설명하거나 스크린샷을 찍어 공유하세요 — AI가 해결을 도와줄 것입니다.

▶ 이것을 AI에 붙여넣어 시작하세요

전송 전에 팀 설계 문서를 첨부하세요.

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 ~/.openclaw/workspace-[agentid]

Example: openclaw agents add marcus --workspace ~/.openclaw/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 터미널을 통해:

# 특정 에이전트와 대화
openclaw agent --agent marcus "Summarize what you worked on today"

# 에이전트 목록 확인
openclaw agents list

# 필요 시 게이트웨이 재시작
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
```
에이전트가 목록에 없다면 Step 2의 agents add 명령을 다시 실행하세요.
workspace 파일이 올바른 위치에 있나요? 다음 경로에 SOUL.md, AGENTS.md, IDENTITY.md가 존재하는지 확인하세요: ~/.openclaw/workspace-[agentid]/
API 키가 올바르게 설정되어 있나요?.env 파일을 열고 ANTHROPIC_API_KEY가 입력되어 있는지 확인하세요.

그래도 해결되지 않으면 오류 메시지를 Claude, ChatGPT, 또는 Gemini에 붙여넣고 도움을 요청하세요.

이 섹션에서 다루는 내용 ​

이 섹션의 진행 방식 ​

▶ 이것을 AI에 붙여넣어 시작하세요

일상적으로 에이전트와 대화하는 방법 ​

에이전트가 응답하지 않을 때 ​

이 섹션에서 다루는 내용

이 섹션의 진행 방식

일상적으로 에이전트와 대화하는 방법

에이전트가 응답하지 않을 때