第5节：启动你的智能体

本节内容概述

你将在 OpenClaw 中注册每个智能体，并向它们发出第一条指令。完成后，全部 6 个智能体都将上线运行 —— 向各自的 Discord 频道汇报，并随时准备接收你的指令。

与智能体沟通的两种方式：

方式	适合场景	使用方法
OpenGoat UI	新手友好 —— 可视化界面	基于浏览器的控制面板，点击选择智能体，输入消息即可
VS Code 终端	推荐 —— 更快、更灵活	`openclaw agent --agent [id] "your message"`

两种方式都可以使用，选择你觉得顺手的开始即可。

推荐方案 —— 与 AI 结合使用的混合模式： 刚开始时，建议在操作智能体的同时，一直开着你使用的 Chat AI 对话窗口。如果某条命令不起作用，或者不确定该输入什么，直接向 AI 描述情况并寻求帮助。这正是大多数人 —— 包括 BALIA OS 团队自己 —— 在最初使用时的做法。你不需要在第一天就精通终端操作，AI 对话窗口始终是你的副驾驶。

本节操作方式

将下方提示词粘贴到你的 Chat AI 中。AI 会引导你完成全部 6 个智能体的注册，并向每一个发送第一条指令。请附上你的团队设计文档，以便 AI 知道你的智能体 ID 和工作区路径。

如果出现问题，把错误信息或截图分享给 AI，它会帮你解决。

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

发送前请附上你的团队设计文档。

你正在帮助我在 OpenClaw 上注册并启动我的 BALIA OS 多智能体团队。

我已附上团队设计文档。请先读取它，获取我的智能体 ID 和名称。

开始之前，请先问我：
"你的 Windows 用户名是什么？（C:\Users\[用户名] 中的名称）"
在整个会话过程中，所有文件路径都使用这个用户名。
我的所有智能体文件都在 $env:USERPROFILE/.opengoat/ 之下。

请逐步引导我，一次一步。如果我遇到错误，先帮我解决再继续。
如果我卡住了，让我分享截图或粘贴错误信息。

以下是我们需要完成的事情：

步骤 1 — 启动 gateway
告诉我："我们将用一条命令启动 OpenClaw gateway，
这条命令会过滤掉嘈杂的后台日志，让终端保持可读。"

引导我打开一个新的 VS Code 终端标签页，并运行适合我操作系统的命令
（如果还不知道我用的是什么系统，先问我）：

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

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

说明这条命令的作用：
"DEBUG='-ciao*' 部分会隐藏原本会刷屏的后台网络发现日志。
--force 参数会清除之前的 gateway 实例。你的终端会保持干净、可读。"

让我确认看到："✓ Gateway running on port 18789"
告诉我保持这个终端标签页打开 —— gateway 必须持续运行。
如果出现错误，先帮我解决再继续。

步骤 2 — 向 OpenClaw 注册每个智能体
首先向我说明：
"运行这条命令会做两件事：把智能体注册到 OpenClaw，
同时自动在 agents/[agentid]/ 下生成该智能体的 config.json 和 models.json。
你不需要自己创建这两个文件。"

对我的每个智能体（共 6 个，ID 从团队设计文档中读取），
引导我在 VS Code 终端中运行以下命令：

Windows:
openclaw agents add [agentid] --workspace $env:USERPROFILE\.opengoat\workspaces\[agentid]

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

示例（Windows）：openclaw agents add marcus --workspace C:\Users\john\.opengoat\workspaces\marcus
（marcus 只是示例 —— 请替换为你团队设计文档中实际的智能体 ID。）

一次性把全部 6 条命令都展示给我，并填好我实际的智能体 ID 和用户名。
让我逐一运行，并在展示下一条之前确认每一条都执行成功。

全部 6 个都注册完成后，引导我验证：
openclaw agents list
让我确认全部 6 个智能体都出现在列表中。

步骤 2b — 验证安全守护程序的注册
安全守护程序已经在第 4 节注册到 OpenClaw。
引导我验证它是否存在：

openclaw agents list

让我确认 security-guardian 出现在列表中。
如果没有，引导我运行：

Windows:
openclaw agents add security-guardian --workspace $env:USERPROFILE\.opengoat\workspaces\security-guardian

Mac:
openclaw agents add security-guardian --workspace ~/.opengoat/workspaces/security-guardian

然后再次验证列表，确认无误后再继续。

步骤 3 — 重启 gateway
注册智能体后，需要重启 gateway 才能加载它们。
引导我运行：
openclaw gateway restart
让我确认 gateway 已重新运行后再继续。

步骤 4 — 用 PM2 启动安全守护程序
安全守护程序通过 PM2 在后台持续运行。
引导我启动它：

pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\guardian.js --name security-guardian

（Mac：把路径替换为 ~/.opengoat/workspaces/security-guardian/scripts/guardian.js）

然后保存 PM2 进程列表，以便重启电脑后自动恢复：
pm2 save

让我确认在 PM2 列表中看到安全守护程序：
pm2 list

再让我确认在 Discord 的 #security-channel 频道中看到启动消息。

步骤 5 — 通过 VS Code 终端发送第一条指令（推荐）
首先向我说明：
"VS Code 终端是与智能体沟通的推荐方式。命令格式是：
openclaw agent --agent [agentid] '你的消息内容'

这会把消息直接发送给指定的智能体。"

引导我向第一个智能体发送一条测试指令：
openclaw agent --agent [第一个agentid] '请自我介绍，并确认你已经读取了
SOUL.md、AGENTS.md、IDENTITY.md、HEARTBEAT.md、TOOLS.md 和 USER.md。
然后向你的 Discord 频道报告你已上线。'

问我："智能体回复了什么？你在它的 Discord 频道看到消息了吗？"
如果是：很好 —— 继续下一个智能体。
如果否：帮我排查问题。

对全部 6 个智能体重复此操作。

步骤 6 —（可选）设置 OpenGoat UI
全部智能体都通过终端确认可用后，向我提出：
"你也可以通过 OpenGoat UI 与你的智能体沟通 —— 这是一个可视化的浏览器控制面板。
你想现在也设置一下吗？
它能提供一个可点击的界面来选择智能体、发送消息，
不需要手动输入终端命令。"
如果是：引导我：
1. 打开一个新的 VS Code 终端标签页
2. 运行：opengoat start
3. 浏览器会自动打开 OpenGoat UI
带我了解界面 —— 如何选择智能体、发送消息。
（如果浏览器没有自动打开，访问 http://localhost:19123）
如果否：跳过，进入步骤 7。

步骤 7 — 最终确认
和我一起过一遍这份清单：
□ 全部 6 个智能体已注册（openclaw agents list 显示全部 6 个）
□ 安全守护程序已注册（security-guardian 出现在列表中）
□ 安全守护程序在 PM2 中运行（pm2 list 显示为 online）
□ Gateway 正在运行（端口 18789）
□ 每个智能体都对第一条指令有回应
□ 每个智能体都在自己的 Discord 频道发布了消息
□ （可选）可以通过 localhost:19123 访问 OpenGoat UI

步骤 8 — 生成 CLAUDE.md
全部 6 个智能体（包括安全守护程序）都确认注册并正常运行后，
引导我生成 CLAUDE.md —— 这是 Claude Code 在每次会话开始时自动读取的指令文件：

"现在让我们生成你的 CLAUDE.md。它会根据你已经完成的团队设置自动生成，
不需要你手动填写任何内容。"

Windows:
cd $env:USERPROFILE\.opengoat\workspaces\security-guardian
node generate_claude_md.js

Mac:
cd ~/.opengoat/workspaces/security-guardian
node generate_claude_md.js

让我确认看到类似这样的结尾信息：
[OK] CLAUDE.md generated: (your path)\.opengoat\CLAUDE.md

如果 CLAUDE.md 已经存在，脚本会先自动备份，再询问是否覆盖。
"yes" 表示覆盖（已备份）；"no" 表示把新内容保存为
CLAUDE_generated_draft.md，现有的 CLAUDE.md 完全不受影响。

如果被问到购买的等级（T1 / T2 / T3），引导我输入实际购买的等级。

生成完成后，让我打开
$env:USERPROFILE\.opengoat\CLAUDE.md，确认团队名称和角色显示正确。

全部勾选完成后，说：
"你的 BALIA OS 团队已上线。全部 6 个智能体都在运行并向 Discord 汇报。
你已准备好进入第 6 节 —— 构建你的第一个技能卡带。"

现在开始。请先问我第一个问题。

关于 CLAUDE.md

步骤 8 中生成的 CLAUDE.md 是一个指令文件，VS Code 中的 Claude Code 会在每次会话开始时自动读取它。它在此时生成 —— 也就是所有智能体都确认注册并正常运行之后 —— 直接生成在 $env:USERPROFILE.opengoat\ 目录下。

自动包含的内容：

团队构成表（全部 6 个智能体的名称和角色）
破坏性操作的绝对禁止事项（删除/覆盖文件等操作前需要确认）
敏感信息的处理方式（不以明文输出 API 密钥、Webhook 等）
输出语言规则

自定义： 文件底部"## 以下内容可自由自定义"这一行以下的所有内容都可以自由编辑 —— 添加项目专属规则、常用命令，或任何其他有用的内容。

靠近顶部的两个章节 ——## 破坏性操作绝对禁止（重要 — 必须始终遵守 — 请勿删除）和## 敏感信息的处理（请勿删除）—— 是核心安全规则，会以你选择的语言显示（支持 20 种语言）。请勿删除或修改这两个章节。

如果已经存在 CLAUDE.md： 执行步骤 8 不会静默覆盖已存在的 CLAUDE.md。脚本会先自动备份，再询问是否覆盖。回答"no"则现有文件完全不受影响 —— 新生成的内容会单独保存为 CLAUDE_generated_draft.md。

日常与智能体沟通的方式

完成所有设置后，以下是你下达指令的方法：

启动 gateway（每次使用前必须先执行此步骤）：

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

# 如需重启 gateway
openclaw gateway restart

marcus 只是示例 —— 请替换为你自己的智能体 ID（例如 --agent ceo 或 --agent nova）。

通过 OpenGoat UI：

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

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

如果智能体没有响应

按以下顺序逐一排查：

Gateway 是否在运行？
```
openclaw gateway restart
```
智能体是否已注册？
```
openclaw agents list
```
如果你的智能体没有出现在列表中，重新执行步骤 2 中的 agents add 命令。
工作区文件是否放在正确位置？
确认 SOUL.md、AGENTS.md 和 IDENTITY.md 存在于：
Windows：$env:USERPROFILE\.opengoat\workspaces\[agentid]\
Mac：~/.opengoat/workspaces/[agentid]/
API 密钥是否正确设置？ 打开 .env（位于你的 .opengoat 文件夹中），确认 ANTHROPIC_API_KEY 已填写。

如果仍然无法解决，把错误信息粘贴到你的 Chat AI 中寻求帮助。

验证你的设置

全部智能体都确认上线后，运行：

Windows：

node $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\verify_setup.js --section 5

Mac：

node ~/.opengoat/workspaces/security-guardian/scripts/verify_setup.js --section 5

本节内容概述 ​

本节操作方式 ​

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

关于 CLAUDE.md ​

日常与智能体沟通的方式 ​