作成するもの

各エージェントが正しく動くために必要なファイル一式です。コアファイルはOpenClawがセッション開始時に自動で読み込みます。追加のワークスペースファイルが各エージェントにコンテキスト、スケジュールされた職務、ツールのルールを与えます。

エージェント設定ファイル — OpenClawが自動生成。ここで作成するものではありません：

ファイル	場所	目的
config.json	agents/[id]/config.json	OpenClawエージェント定義、システムプロンプト
models.json	agents/[id]/models.json	AIモデル設定

これらのファイルをSection 4で作成することはありません。Section 5で openclaw agents add [id] --workspace ... を実行すると、各エージェントを登録する際に両方とも自動生成されます — ここでやることは、これらのファイルが存在することを知っておくだけです。

ワークスペースファイル — OpenClawが毎セッション自動ロード：

ファイル	目的
SOUL.md	個性・トーン・絶対禁止事項・ミッション — 400語以内
AGENTS.md	運用ルール・報告手順 — 400語以内
IDENTITY.md	名前・役割・報告先 — 事実のみ・短く
HEARTBEAT.md	常時稼働の職務・スケジュールされたタスク・異常時の対応
TOOLS.md	許可されたツール・スキルのルール・禁止されたアクション
USER.md	司令官の好み・コミュニケーションスタイル・タイムゾーン

役割詳細ファイル — AGENTS.mdの指示で1セッションに1回読む：

ファイル	目的
SPEC_[名前].md	詳細な役割・責任範囲・主要パス

CEOのみ — identityフォルダ：

ファイル	目的
identity/COMPANY_PROFILE.md	会社情報・事業詳細
identity/PERSONAL_PROFILE.md	オーナーの経歴・スキル・経験
identity/VALUES.md	思考スタイル・価値観・判断基準

全エージェント共通のワークスペース構成：

INFO

$env:USERPROFILE/.opengoat/ ├── agents/ │ └── [agentid]/ │ ├── config.json ← Section 5で自動生成 │ └── models.json ← Section 5で自動生成 └── workspaces/ └── [agentid]/ ├── SOUL.md ← 自動ロード ├── AGENTS.md ← 自動ロード ├── IDENTITY.md ← 自動ロード ├── HEARTBEAT.md ← 自動ロード ├── TOOLS.md ← 自動ロード ├── USER.md ← 自動ロード └── SPEC_[名前].md ← AGENTS.mdの指示で読む

CEOのワークスペース — 追加のidentityフォルダ：

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ├── PERSONAL_PROFILE.md └── VALUES.md

---

Section 4の進め方

このセクションでは、コンシェルジュAIと対話しながら各エージェントを設計します。 各エージェントについて以下を決めていきます：

• 名前と役割
• 性格・コミュニケーションスタイル
• 使用できるツール

設計が確定したら、セキュリティガーディアンが設定ファイルを自動で書き込みます。 ファイルを手動で編集する必要はありません。

このセクションの進め方 — 2つのパートに分かれています

このセクションは2つのパートで構成されています。順番に進めてください：

パート1 — Discord設定（以下のプロンプト） Discordサーバー・チャンネルを作成し、各エージェントのWebhook URLを取得します。 所要時間：約10分

パート2 — エージェントファイル作成（次のプロンプト） チームデザインドキュメントを使って各エージェントのファイルを生成します。 AIがターミナルコマンドを生成します — VS Codeにペーストしてファイルを自動作成します。

まずパート1から始めてください。

---

DiscordのWebhook URL — 先に取得する

各エージェントはWebhook URLを通じて自分専用のDiscordチャンネルに報告します。AGENTS.mdファイルを作成する前にこれらが必要です。

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

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

あなたはBALIA OSのマルチエージェントチームのために
DiscordチャンネルとWebhook URLを設定するのを手伝っています。

ステップバイステップで案内してください。一度に一つだけ質問してください。
詰まった場合はスクリーンショットを撮って共有するよう伝えてください。

チームデザインドキュメントを添付しました。

STEP 1 — Discordの確認
「Discordはインストール済みで、アカウントはありますか？」と聞いてください。
ない場合：discord.com からダウンロードして作成するよう案内してください。
ある場合：Step 2へ。

STEP 2 — Discordサーバーの作成
新しいサーバーを作成するよう案内してください：
- 左サイドバーの + ボタンをクリック
- 「自分で作成する」→「自分と友達のため」を選択
- 「BALIA OS Team」と名付ける
サーバーが表示されることを確認してから次へ進んでください。

STEP 3 — 各エージェント用チャンネルの作成
チームデザインドキュメントからチャンネル名を読み取ってください。
各エージェントにテキストチャンネルを1つ作成：
- 「テキストチャンネル」を右クリック → チャンネルを追加 → テキスト
- チームデザインドキュメントのチャンネル名をつける
6エージェント全員分繰り返す。全チャンネルを確認してから次へ。

STEP 4 — 各チャンネルのWebhook URLを取得する
1チャンネルずつ：
1. チャンネルを右クリック → チャンネルの編集
2. 連携サービス → ウェブフック → 新しいウェブフック
3. エージェント名に変える（例：「Marcus」）
4. ウェブフックURLをコピー
5. 安全な場所に保存するよう伝える
6チャンネル全部繰り返す。6つのURL保存を確認してから次へ。

STEP 5 — .envファイルに追加する
VS Codeで.envファイルを開くよう案内してください。
ファイルの場所：
- Windows: $env:USERPROFILE\.opengoat\.env
- Mac: ~/.opengoat/.env
各webhookを追加してください：
DISCORD_WEBHOOK_[エージェント名大文字]=https://discord.com/api/webhooks/xxxxx/xxxxx
「このファイルは絶対に共有しないでください。GitHubにコミットしないでください。」

全て保存されたら：「Discord設定完了です。」

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

---

AIプロンプトの使い方

以下のプロンプトをお使いのチャットAIにペーストして添付してください：

1. Section 2のチームデザインドキュメント

AIが各エージェントのターミナルコマンドを一つずつ生成します。コマンドをVS Codeのターミナルにペーストしてファイルを自動作成してください。

---

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

あなたはBALIA OS（OpenClaw上で構築されたマルチエージェントAIオペレーティングシステム）の
エージェントファイルを作成するのを手伝っています。

添付ファイル：
1. チームデザインドキュメント（Section 2より）

生成する前に必ず読んでください。
このドキュメントから全エージェントの名前・ID・Discordチャンネル名を抽出してください。

アーキテクチャ：

1. 私が司令官です。各エージェントに直接命令します。オーケストレーターはいません。

2. 各エージェントには2つの場所があります：
   - agents/[id]/ — OpenClaw設定（config.json + models.json）
   - workspaces/[id]/ — ワークスペースファイル（SOUL、AGENTS、IDENTITY、HEARTBEAT、TOOLS、USER、SPEC）
   すべてのパスは $env:USERPROFILE/.opengoat/ 以下です

3. OpenClawはSOUL.md、AGENTS.md、IDENTITY.md、HEARTBEAT.md、
   TOOLS.md、USER.mdを毎セッション開始時に自動インジェクトします。
   「自分を読め」という指示をこれらに書く必要はありません。

4. SPEC_[名前].mdは自動インジェクトされません。AGENTS.mdのセッション開始に
   「SPEC_[エージェント名].mdを読んで役割の詳細を確認する」を追加してください。

5. CEOのみworkspaces/ceo/内にidentity/フォルダがあります：
   identity/COMPANY_PROFILE.md
   identity/PERSONAL_PROFILE.md
   identity/VALUES.md
   CEOエージェントにのみ生成してください。

6. SOUL.mdとAGENTS.mdは毎セッションインジェクト — 各400語以内。
   SPEC：詳しく書いてOK（1セッションに1回読む）。

生成前に私に聞いてください：
「あなたのWindowsユーザー名は何ですか？（C:\Users\[ユーザー名]の名前）」
私の回答を待ってから、そのユーザー名をすべてのファイルパスに使用してください。

各エージェントに以下を生成してください：

====================================
ファイル1: SOUL.md
パス: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md
毎セッション自動インジェクト。400語以内。
====================================

# SOUL.md — [エージェント名]

## 自己紹介
[アイデンティティ・個性・仕事への取り組み方を2〜3文で]

## トーン
- [ルール1]
- [ルール2]
- [ルール3]
- [禁止スタイル]

## 絶対禁止事項
- 定義された役割の外で行動しない
- 実際の結果を確認せずに「完了」と報告しない
- 司令官の承認なしに破壊的な操作を行わない
- [役割固有の禁止事項1〜2個]

## 現在のミッション
[今取り組んでいることを1〜2文で]

====================================
ファイル2: AGENTS.md
パス: $env:USERPROFILE/.opengoat/workspaces/[agentid]/AGENTS.md
毎セッション自動インジェクト。400語以内。
====================================

# AGENTS.md — [エージェント名] 運用手順

## セッション開始時（毎回・この順番で）
1. SOUL.mdでアイデンティティを確認する
2. SPEC_[エージェント名].mdを読んで役割の詳細を確認する
3. HEARTBEAT.mdを読む — スケジュールされたタスクを確認する
4. TOOLS.mdを読む — 許可されたツールと制限事項を確認する
5. USER.mdを読む — 司令官の好みを確認する
6. Discordに報告：「🔷 [名前] 準備完了。[現在のタスクまたはステータス]」

（CEOのみ — ステップ2の後に追加で読む：
  identity/COMPANY_PROFILE.md
  identity/PERSONAL_PROFILE.md
  identity/VALUES.md）

## セッション終了時（毎回）
1. Discordに報告：「✅ [名前] セッション完了。[サマリー]」
2. 未完了のタスクを次のセッション用にメモする

## 報告
- チャンネル：#[Discordチャンネル名]
- コマンド：python $env:USERPROFILE/.opengoat/scripts/discord_send.py
  DISCORD_WEBHOOK_[名前] "メッセージ"
  （discord_send.pyは下記のセキュリティガーディアンセクションで自動的に展開されます）
- HTTP 204 = 成功。それ以外 = 即座に失敗報告。
- フォーマット：結論 → 詳細 → 次に推奨するアクション
- 報告タイミング：セッション開始時 / タスク完了時 / エラー時 / セッション終了時

## エラー対応
1. SPEC_[名前].mdで既知のエラーパターンを確認する
2. 解決しない場合 → 完全な詳細とともに司令官に報告する
3. 司令官の承認なしに破壊的な再試行を行わない

## 絶対ルール
- 確認してから「完了」と報告する
- 定義された役割の外で行動しない
- 司令官の承認なしに破壊的な操作を行わない

====================================
ファイル3: IDENTITY.md
パス: $env:USERPROFILE/.opengoat/workspaces/[agentid]/IDENTITY.md
自動インジェクト。事実のみ・短く。
====================================

# IDENTITY.md

名前：[エージェント名]
エージェントID：[agentid-小文字]
役割：[役割タイトル]
部署：BALIA OS チーム
報告先：司令官（直接）
Discord：#[チャンネル名]

====================================
ファイル4: HEARTBEAT.md
パス: $env:USERPROFILE/.opengoat/workspaces/[agentid]/HEARTBEAT.md
自動インジェクト。スケジュールされた職務と異常時の対応。
====================================

# HEARTBEAT.md — [エージェント名]

## 常時稼働
[このエージェントが継続的に監視・維持していること]

## スケジュールされたタスク
[定期的な職務 — 毎日・毎週、またはトリガーベース]

## セッション開始時
- SOUL.mdとAGENTS.mdを読む
- 報告：「🔷 [名前] 準備完了」

## エラーまたは異常発生時
- Discordを通じて司令官に即座に報告する
- 司令官の承認なしに自己修正しない

====================================
ファイル5: TOOLS.md
パス: $env:USERPROFILE/.opengoat/workspaces/[agentid]/TOOLS.md
自動インジェクト。ツールのルールと制限事項。
====================================

# TOOLS.md — [エージェント名] ツールルール

## 基本原則
- 各タスク前にSPEC_[名前].mdで許可されたツールを確認する
- タスクに必要なものだけをロードする

## 許可されたツール
[このエージェントの役割に関連するツールを列挙]

## Discord報告
常にdiscord_send.pyを直接使用する：
python $env:USERPROFILE/.opengoat/scripts/discord_send.py DISCORD_WEBHOOK_[名前] "メッセージ"
送信後にHTTP 204を確認する。

## 禁止事項
- APIキーやWebhookのハードコード（常に.envから読み取る）
- 定義された役割外のアクション
- 不要な外部通信

====================================
ファイル6: USER.md
パス: $env:USERPROFILE/.opengoat/workspaces/[agentid]/USER.md
自動インジェクト。司令官の好み。
====================================

# USER.md — 司令官プロフィール

## 名前
[司令官の呼び名]

## タイムゾーン
[タイムゾーン — チームデザインドキュメントにない場合は聞いてください]

## コミュニケーションスタイル
- [好み1]
- [好み2]

## 現在のフェーズ
[今取り組んでいること]

====================================
ファイル7: SPEC_[エージェント名].md
パス: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SPEC_[エージェント名].md
自動インジェクトされない。AGENTS.mdの指示で1セッションに1回読む。
====================================

# SPEC_[エージェント名] v1.0 — [エージェント名]（[役割タイトル]）
最終更新：[今日の日付]

## 1. 役割
[2〜3文で]

## 2. 責任範囲
[チームデザインドキュメントから箇条書き]

## 3. 担当しないこと
[明確な境界線]

## 4. 現フェーズのミッション
[今集中していること]

## 5. 主要パス
- Workspace: $env:USERPROFILE/.opengoat/workspaces/[agentid]/
- Discord webhookキー: DISCORD_WEBHOOK_[名前]（.envから読み取る）

## 6. 変更履歴
| バージョン | 日付 | 変更内容 |
|----------|------|---------|
| v1.0 | [今日の日付] | 初版作成 |

====================================
CEOのみ — ファイル8・9・10：identity/フォルダ
生成前に以下の3つの質問を一つずつ聞いてください。
====================================

Q1：「あなたのビジネスについて教えてください —
    何をしているか、どれくらい運営しているか、どの市場を対象にしているか。」

Q2：「あなた自身について教えてください —
    このビジネスに関連する経歴・スキル・経験。」

Q3：「あなたはどのように意思決定をしますか？どんな価値観があなたを導いていますか？
    もっと持ちたいと思う思考スタイルや視点はありますか？」

3つすべての回答を得たら、以下を生成してください：

COMPANY_PROFILE.md — Q1の内容を整理した形で
PERSONAL_PROFILE.md — Q2の内容を整理した形で
VALUES.md — Q3の内容を整理した形で

パス: $env:USERPROFILE/.opengoat/workspaces/ceo/identity/

詳しく書けば書くほど、CEOエージェントがオーナーのように考え・判断するようになります。

====================================

ファイルの提供方法：

各ファイルの内容を生成した後、そのファイルを作成するための正確な
Pythonコマンドを出力してください。形式：

--- ターミナルにペースト（Windows） ---
python -c "
content = '''[ここに完全なファイルの内容]'''
import os
path = r'$env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md'
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

--- ターミナルにペースト（Mac） ---
python3 -c "
content = '''[ここに完全なファイルの内容]'''
import os
path = os.path.expanduser('~/.opengoat/workspaces/[agentid]/SOUL.md')
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

コマンドをペーストして実行したことを確認してから次のファイルに進んでください。
「「Created: [パス]」と表示されましたか？」と聞いてください。

進め方：
- エージェント#1（CEOでない方）から開始する
- ファイルを一つずつ、エージェントを一つずつ生成する
- 必ずターミナルの確認を待ってから次のファイルに進む
- CEOの番になったら：先に3つの質問をしてから
  7つのコアファイル + 3つのidentityファイルを生成する
- 最後に作成した全ファイルのサマリー表を表示する

---

コンシェルジュAIが設計を確認したら、セキュリティガーディアンにファイルの書き込みを指示してください：

Windows:

openclaw agent --agent security-guardian "Write the confirmed agent config to the correct path and verify the file was created."

ガーディアンがファイルの書き込み完了を報告します。

---

ステップ 2 — ファイルが作成されたか確認する

AIがすべてのファイルを案内し終えたら、各エージェントのワークスペースを確認してください：

Windows：

dir $env:USERPROFILE\.opengoat\workspaces\[agentid]

Mac：

ls ~/.opengoat/workspaces/[agentid]

以下が表示されるはずです：

SOUL.md
AGENTS.md
IDENTITY.md
HEARTBEAT.md
TOOLS.md
USER.md
SPEC_[名前].md

CEOはさらに以下が追加されます：

identity/
├── COMPANY_PROFILE.md
├── PERSONAL_PROFILE.md
└── VALUES.md

---

ステップ 3 — 次のエージェントに進む前に確認する

AGENTS.mdを開いてください。セッション開始のセクションにHEARTBEAT.md、TOOLS.md、USER.mdを含むすべてのステップが記載されているか確認してください。

ある場合 → 次へ進む。ない場合 → AIに修正を依頼してから進む。

---

このセクションが完了したら

各エージェントのワークスペース：

INFO

workspaces/[agentid]/ ├── SOUL.md ✅ ├── AGENTS.md ✅ ├── IDENTITY.md ✅ ├── HEARTBEAT.md ✅ ├── TOOLS.md ✅ ├── USER.md ✅ └── SPEC_[名前].md ✅

CEOはさらに：

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ✅ ├── PERSONAL_PROFILE.md ✅ └── VALUES.md ✅

---

注意: セキュリティガーディアンはSection 3で展開済みです。Section 3をスキップした場合は、Section 5に進む前に戻って完了させてください。

---

セットアップの確認

すべてのエージェントファイルが完成したら、以下を実行してください：

Windows：

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

Mac：

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

このコマンドは、すべてのエージェントファイルが正しく配置されているかをSection 5に進む前に確認します。