Nội Dung Phần Này

Bạn sẽ đăng ký từng agent với OpenClaw và giao cho chúng lệnh đầu tiên. Khi hoàn thành, cả 6 agent sẽ hoạt động — báo cáo lên các kênh Discord của chúng và sẵn sàng nhận hướng dẫn từ bạn.

Hai cách để giao tiếp với các agent của bạn:

Phương thức	Phù hợp nhất cho	Cách hoạt động
OpenGoat UI	Người mới bắt đầu — giao diện trực quan	Dashboard trên trình duyệt, nhấp để chọn agent, nhập tin nhắn
VS Code terminal	Khuyến nghị — nhanh hơn, kiểm soát tốt hơn	openclaw agent --agent [id] "tin nhắn của bạn"

Cả hai phương thức đều hoạt động. Hãy bắt đầu với cách nào bạn cảm thấy thoải mái hơn.

Cách tiếp cận được khuyến nghị — kết hợp với AI: Khi mới bắt đầu, hãy mở một cửa sổ chat Claude, ChatGPT, hoặc Gemini song song với các agent của bạn. Nếu một lệnh không hoạt động hoặc bạn không chắc nên nhập gì, hãy mô tả tình huống cho AI và nhờ trợ giúp. Đây chính xác là cách hầu hết mọi người — kể cả đội ngũ BALIA OS — vận hành trong giai đoạn đầu. Bạn không cần thành thạo terminal ngay từ ngày đầu. Cửa sổ chat AI luôn ở đó như người đồng hành của bạn.

---

Cách Thực Hiện Phần Này

Dán đoạn prompt bên dưới vào Claude, ChatGPT, hoặc Gemini. AI sẽ hướng dẫn bạn từng bước đăng ký cả 6 agent và gửi lệnh đầu tiên đến từng agent. Đính kèm Tài Liệu Thiết Kế Nhóm của bạn để AI biết ID agent và đường dẫn workspace.

Nếu có sự cố, hãy mô tả lỗi hoặc chụp ảnh màn hình và chia sẻ — AI sẽ giúp bạn khắc phục.

---

▶ Dán cái này vào AI của bạn để bắt đầu

Đính kèm Tài Liệu Thiết Kế Nhóm trước khi gửi.

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.

---

Giao Tiếp Với Các Agent Hàng Ngày

Sau khi mọi thứ đã được thiết lập, đây là cách bạn đưa ra lệnh:

Khởi động gateway (làm việc này trước, mỗi phiên làm việc):

Windows:

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

Mac:

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

Để tab terminal này tiếp tục chạy. Mở tab mới cho các lệnh khác.

Qua VS Code terminal:

# 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

Qua OpenGoat UI:

1. Mở một tab terminal VS Code mới
2. Chạy: opengoat start
3. Trình duyệt tự động mở với OpenGoat UI
4. Chọn agent từ bảng điều hướng bên trái
5. Nhập tin nhắn và nhấn Enter (Nếu trình duyệt không tự động mở: truy cập http://localhost:18789)

Qua Discord (chỉ để đọc báo cáo — không dùng để ra lệnh): Discord là nơi các agent đăng báo cáo của chúng. Bạn đọc các cập nhật tại đây. Việc gửi lệnh cho agent qua Discord yêu cầu một Discord Bot — đây là thiết lập nâng cao không được đề cập trong T1. Hãy sử dụng VS Code terminal hoặc OpenGoat UI để ra lệnh cho đến lúc đó.

---

Nếu Một Agent Không Phản Hồi

Kiểm tra theo thứ tự sau:

1. Gateway có đang chạy không?

   openclaw gateway restart

2. Agent đã được đăng ký chưa?

   openclaw agents list

   Nếu agent của bạn không xuất hiện trong danh sách, hãy chạy lại lệnh agents add từ Bước 2.

3. Các file workspace có đúng vị trí không? Kiểm tra xem SOUL.md, AGENTS.md, và IDENTITY.md có tồn tại trong: ~/.openclaw/workspace-[agentid]/

4. API key đã được thiết lập đúng chưa? Mở .env và xác nhận ANTHROPIC_API_KEY đã được điền vào.

Nếu bạn vẫn bị mắc kẹt, hãy dán thông báo lỗi vào Claude, ChatGPT, hoặc Gemini và nhờ trợ giúp.