本節內容概覽

你將把每個 agent 註冊到 OpenClaw，並給予它們第一道指令。完成後，全部 6 個 agent 都將上線——向各自的 Discord 頻道回報狀態，並隨時準備接收你的指示。

與 agent 溝通的兩種方式：

方式	最適合	運作原理
OpenGoat UI	初學者——視覺化介面	瀏覽器儀表板，點選 agent 後直接輸入訊息
VS Code 終端機	推薦——速度更快、控制更靈活	openclaw agent --agent [id] "your message"

兩種方式都可行。從你覺得順手的那種開始即可。

推薦做法——搭配 AI 的混合模式： 剛開始時，建議在操作 agent 的同時，另開一個 Claude、ChatGPT 或 Gemini 的對話視窗。如果某個指令不起作用，或者不確定該輸入什麼，只要向 AI 描述情況並尋求協助即可。這正是大多數人——包括 BALIA OS 團隊——在初期的操作方式。你不需要在第一天就精通終端機，AI 對話視窗隨時都是你的副駕駛。

---

本節操作方式

將下方的提示詞貼到 Claude、ChatGPT 或 Gemini 中。AI 將引導你完成全部 6 個 agent 的註冊，並向每個 agent 發送第一道指令。請附上你的團隊設計文件，讓 AI 了解你的 agent 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.

---

日常與 Agent 溝通的方式

一切設定完成後，以下是你下達指令的方法：

啟動 gateway（每次作業開始時請先執行此步驟）：

Windows：

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

Mac：

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

保持此終端機分頁持續運行，並另開新分頁執行其他指令。

透過 VS Code 終端機：

# 對特定 agent 發送訊息
openclaw agent --agent marcus "Summarize what you worked on today"

# 查看 agent 清單
openclaw agents list

# 必要時重新啟動 gateway
openclaw gateway restart

透過 OpenGoat UI：

1. 另開一個 VS Code 終端機分頁
2. 執行：opengoat start
3. 瀏覽器將自動開啟 OpenGoat UI
4. 從左側面板選擇 agent
5. 輸入訊息後按下 Enter （若瀏覽器未自動開啟，請前往 http://localhost:18789）

透過 Discord（僅限接收報告——不適用於下達指令）： Discord 是你的 agent 發布報告的地方，你在這裡閱讀它們的更新即可。 透過 Discord 向 agent 下達指令需要設定 Discord Bot——這屬於進階設定，T1 階段不涵蓋此內容。目前請使用 VS Code 終端機或 OpenGoat UI 下達指令。

---

如果 Agent 沒有回應

請依序確認以下項目：

1. Gateway 是否正在運行？

   openclaw gateway restart

2. Agent 是否已完成註冊？

   openclaw agents list

   若你的 agent 未出現在清單中，請重新執行步驟 2 的 agents add 指令。

3. Workspace 檔案是否放在正確位置？ 確認 SOUL.md、AGENTS.md 與 IDENTITY.md 存在於以下路徑： ~/.openclaw/workspace-[agentid]/

4. API 金鑰是否設定正確？ 開啟 .env，確認 ANTHROPIC_API_KEY 已填入。

若問題仍未解決，將錯誤訊息貼到 Claude、ChatGPT 或 Gemini 中尋求協助。