第5节：启动你的 Agent

本节内容概述

你将在 OpenClaw 中注册每个 agent，并向它们发出第一条指令。完成后，全部 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：

打开一个新的 VS Code 终端标签页
运行：opengoat start
浏览器将自动打开 OpenGoat UI
从左侧面板选择 agent
输入消息并按 Enter 发送（如果浏览器未自动打开，请访问 http://localhost:18789）

通过 Discord（仅用于接收报告，不用于下达指令）： Discord 是 agent 发布报告的地方，你在这里查看它们的更新。通过 Discord 向 agent 下达指令需要配置 Discord Bot——这属于高级设置，T1 阶段不涉及。目前请使用 VS Code 终端或 OpenGoat UI 下达指令。

如果 Agent 没有响应

按以下顺序逐一排查：

Gateway 是否在运行？
```
openclaw gateway restart
```
Agent 是否已注册？
```
openclaw agents list
```
如果你的 agent 未出现在列表中，请重新执行第2步中的 agents add 命令。
Workspace 文件是否放置在正确位置？ 确认 SOUL.md、AGENTS.md 和 IDENTITY.md 存在于以下路径： ~/.openclaw/workspace-[agentid]/
API key 是否正确配置？ 打开 .env 文件，确认 ANTHROPIC_API_KEY 已填写。

如果仍然无法解决，将错误信息粘贴到 Claude、ChatGPT 或 Gemini 中寻求帮助。

本节内容概述 ​

本节操作方式 ​

▶ 将此粘贴到您的 AI 中以开始

日常与 Agent 沟通的方式 ​

如果 Agent 没有响应 ​

本节内容概述

本节操作方式

日常与 Agent 沟通的方式

如果 Agent 没有响应