Section 5: エージェントを起動する

このセクションでやること

各エージェントをOpenClawに登録して、最初のコマンドを送ります。終わる頃には6人のエージェント全員が稼働し、Discordチャンネルに報告しながらあなたの指示を待っている状態になります。

エージェントへの命令の出し方（2通り）：

方法	向いている人	動作
OpenGoat UI	初心者 — 視覚的なインターフェース	ブラウザのダッシュボードでエージェントを選択してメッセージを入力
VS Codeターミナル	推奨 — 速くて制御しやすい	`openclaw agent --agent [id] "メッセージ"`

どちらでも動きます。やりやすい方から始めてください。

推奨：AIとのハイブリッド運用 最初のうちは、お使いのチャットAI画面をVS Codeの横に開いておくのがおすすめです。コマンドがうまく動かない時や何を入力すればいいかわからない時は、状況をそのままAIに伝えれば一緒に解決してくれます。BALIA OSチームを含め、多くの人が最初はこのハイブリッド運用でやっていました。ターミナルを初日から完璧に使いこなす必要はありません。AIチャット画面は常にあなたのコパイロットとして使えます。

このセクションの進め方

以下のプロンプトをお使いのチャットAIにペーストしてください。AIが6人のエージェントの登録から最初のコマンド送信までを案内します。チームデザインドキュメントを添付して、AIがエージェントIDとワークスペースパスを確認できるようにしてください。

うまくいかない場合は、エラーを説明するかスクリーンショットを共有してください — AIが解決を手伝います。

▶ AIにペーストして始めましょう

送信前にチームデザインドキュメントを添付してください。

あなたはBALIA OSのマルチエージェントチームをOpenClawに登録して
起動するのを手伝っています。

チームデザインドキュメントを添付しました。始める前にエージェントID・
名前・ワークスペースパスを読み取ってください。

始める前に私に聞いてください：
「あなたのWindowsユーザー名は何ですか？（C:\Users\[ユーザー名]の名前）」
そのユーザー名をこのセッション全体のファイルパスに使用してください。
私のエージェントファイルはすべて $env:USERPROFILE/.opengoat/ 以下にあります

ステップバイステップで案内してください。一度に一つのステップだけ。
エラーが出た場合は解決してから次に進んでください。
詰まった場合はスクリーンショットを共有するかエラーメッセージを
ペーストするよう伝えてください。

以下の手順で進めます：

STEP 1 — gatewayを起動する
「ターミナルがログで埋まらないように、
バックグラウンドのノイズログをフィルターする起動コマンドを使います。」
と伝えてください。

VS Codeで新しいターミナルタブを開いて、OSに合ったコマンドを実行するよう案内してください
（OSがわからない場合は聞いてください）：

Windowsの場合：
  $env:DEBUG="-ciao*"; openclaw gateway --force

Macの場合：
  DEBUG="-ciao*" openclaw gateway --force

以下を説明してください：
「DEBUG='-ciao*' の部分は、ターミナルを埋め尽くすバックグラウンドのネットワーク探索ログを
非表示にします。--force は以前のgatewayインスタンスをクリアします。
これでターミナルが読みやすい状態を保てます。」

「✓ Gateway running on port 18789」が表示されることを確認するよう伝えてください。
このターミナルタブは開いたままにしておくよう伝えてください — gatewayを起動し続ける必要があります。
エラーが出た場合は解決してから次に進んでください。

STEP 2 — 各エージェントをOpenClawに登録する
まずこれを説明してください：
「このコマンドを実行すると2つのことが起きます。エージェントをOpenClawに
登録することと、そのエージェントのconfig.jsonとmodels.jsonを
agents/[agentid]/ 以下に自動生成することです。これらのファイルを
自分で作る必要はありません。」

チームデザインドキュメントから読み取った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に置き換えてください。）

実際のエージェントIDとユーザー名を入力した状態で6つのコマンドを一度に表示してください。
1つずつ実行して、次を実行する前に成功を確認するよう伝えてください。

6つ全部登録できたら確認のコマンドを案内してください：
openclaw agents list
6人全員がリストに表示されることを確認してから次に進んでください。

STEP 2b — Security Guardianの登録を確認する
Security GuardianはSection 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

その後、再度リストを確認してから次に進んでください。

STEP 3 — gatewayを再起動する
エージェントを登録した後、gatewayを再起動して読み込みます。
以下を実行するよう案内してください：
openclaw gateway restart
再起動を確認してから次に進んでください。

STEP 4 — Security Guardian をPM2で起動する
Security Guardianは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リストにSecurity Guardianが表示されることを確認するよう伝えてください：
pm2 list

その後、DiscordのSecurityチャンネルに起動メッセージが届いていることを確認するよう伝えてください。

STEP 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人全員に繰り返す。

STEP 6 — （任意）OpenGoat UIのセットアップ
全エージェントがターミナルで動作確認できたら提案してください：
「OpenGoat UIというブラウザのダッシュボードからも
エージェントに命令を出せます。
ターミナルコマンドを入力せずに、クリックでエージェントを選んで
メッセージを送れる視覚的なインターフェースです。
セットアップしますか？」
する場合：以下の手順を案内する：
1. VS Codeで新しいターミナルタブを開く
2. 実行する：opengoat start
3. ブラウザが自動で開いてOpenGoat UIが表示される
インターフェースの使い方（エージェントの選び方・メッセージの送り方）を説明する。
（自動で開かない場合は http://localhost:19123 を開くよう伝える）
しない場合：STEP 7に進む。

STEP 7 — 最終確認
以下のチェックリストを一緒に確認してください：
□ 6人全員が登録済み（openclaw agents listに6人表示される）
□ Security Guardianが登録済み（security-guardianがリストに表示される）
□ Security GuardianがPM2で稼働中（pm2 listでonlineと表示される）
□ gateway稼働中（ポート18789）
□ 各エージェントが最初のコマンドに応答した
□ 各エージェントがDiscordチャンネルに投稿した
□ （任意）OpenGoat UIがlocalhost:19123でアクセスできる

STEP 8 — CLAUDE.mdを生成する
Security Guardianを含む6人全員の登録・稼働が確認できたら、CLAUDE.md
（Claude Codeが毎回のセッション開始時に自動的に読み込む指示ファイル）を
生成するよう案内してください：

「これで、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 を生成しました: （あなたの環境の）.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に報告しています。Section 6 — 最初のスキルを作成する、
に進む準備ができました。」
と伝えてください。

では始めましょう。最初の質問をしてください。

CLAUDE.mdについて

STEP 8で生成されるCLAUDE.mdは、VS Code上のClaude Codeが毎回のセッション開始時に自動的に読み込む指示ファイルです。全エージェントの登録・稼働確認が終わったこのタイミングで、$env:USERPROFILE.opengoat\ 直下に自動生成されます。

自動生成される内容：

チーム構成表（6人のエージェント名・役割）
破壊的操作の絶対禁止事項（ファイル削除・上書き等を実行する前の確認義務）
機密情報の取り扱い（APIキー・Webhook等を平文で出力しないルール）
出力言語のルール

カスタマイズについて： ファイル下部の「ここから下は自由にカスタマイズしてください」というセクションより下は、プロジェクト固有のルールやよく使うコマンドなどを自由に追記・編集できます。

一方、上部の「破壊的操作の絶対禁止事項（最重要・必ず遵守・削除禁止）」「機密情報の取り扱い（削除禁止）」の2セクションは安全のための最重要ルールです。選択した言語（20言語対応）で表示されます。削除・改変しないでください。

すでにCLAUDE.mdが存在する場合： STEP 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 "今日やったことをまとめてください"

# エージェントの一覧を確認
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はエージェントがあなたへのレポートをPostする場所です。ここで各エージェントの活動を確認します。 DiscordからエージェントにコマンドをDMで送るにはDiscord Botの作成が別途必要です。これはT1の範囲外の上級設定です。コマンドはVS CodeターミナルまたはOpenGoat UIから出してください。

エージェントが応答しない場合

以下の順番で確認してください：

gatewayは起動しているか？
```
openclaw gateway restart
```
エージェントは登録されているか？
```
openclaw agents list
```
リストにいない場合は、Step 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が入力済みか確認してください。

それでも解決しない場合は、エラーメッセージをお使いのチャット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人のエージェント全員が登録済みで、Security Guardianが稼働中で、Section 6に進む準備ができているかを確認します。

このセクションでやること ​

このセクションの進め方 ​

▶ AIにペーストして始めましょう

CLAUDE.mdについて ​

日常的なエージェントへの命令の出し方 ​