本節內容概覽

你將在 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：

1. 開啟一個新的 VS Code 終端機標籤頁
2. 執行：opengoat start
3. 瀏覽器會自動開啟 OpenGoat UI
4. 從左側面板選擇智能體
5. 輸入訊息並按 Enter 發送 （如果瀏覽器沒有自動開啟，請前往 http://localhost:19123）

透過 Discord（僅用於查看回報，不用於下達指令）： Discord 是智能體發布回報的地方，你在這裡查看它們的更新。 透過 Discord 向智能體下達指令需要設定 Discord Bot —— 這屬於進階設定，T1 階段不涵蓋此內容。目前請使用 VS Code 終端機或 OpenGoat UI 下達指令。

---

如果智能體沒有回應

請依序排查以下項目：

1. Gateway 是否正在運行？

   openclaw gateway restart

2. 智能體是否已註冊？

   openclaw agents list

   如果你的智能體沒有出現在清單中，重新執行步驟 2 中的 agents add 指令。

3. 工作區檔案是否放在正確位置？

   確認 SOUL.md、AGENTS.md 和 IDENTITY.md 存在於：

   Windows：$env:USERPROFILE\.opengoat\workspaces\[agentid]\

   Mac：~/.opengoat/workspaces/[agentid]/

4. 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

這會確認全部 6 個智能體都已註冊、安全守護程式正在運行，並確認你已準備好進入第 6 節。