2. システムプロンプトとアイデンティティ

概要

OpenClawの「パーソナル」な性格は、3層のアイデンティティシステムと、 20以上のセクションから成る巨大なシステムプロンプトによって実現されています。 このセクションでは、AIの人格がどのように定義・構築・注入されるかを詳細に解説します。

アイデンティティの3層構造

Layer 1: 設定ベースのアイデンティティ

src/agents/identity.ts

resolveAgentIdentity() が設定ファイルの config.agents.list[].identity から アイデンティティ情報を読み取ります。

Layer 2: ファイルベースのアイデンティティ

src/agents/identity-file.ts

ワークスペースの IDENTITY.md ファイルからMarkdown形式で人格情報を読み込みます。 設定ベースよりも拡張されたフィールドを持ちます：

parseIdentityMarkdown() がMarkdownファイルを解析し、プレースホルダー値（"pick something you like" 等）を自動フィルタリングします。

Layer 3: SOUL.md — ペルソナエンジン

これがOpenClawの人格の核心です。

SOUL.mdテンプレートが定める主要原則：

• "Be genuinely helpful, not performatively helpful" — 見せかけではなく本当に役立つ行動をする
• "Have opinions" — 意見を持ち、反対意見も表明する
• "Be resourceful before asking" — 質問する前にまず自分で調べる
• "Earn trust through competence" — 能力で信頼を獲得する
• "Remember you're a guest" — ユーザーの環境にお邪魔している意識を持つ

特筆すべき点：SOUL.mdは「自己進化型」に設計されています。ファイル自体に「This file is yours to evolve（このファイルはあなた自身で進化させるもの）」と記載されています。

初回オンボーディング（BOOTSTRAP.md）

src/agents/workspace.ts

BOOTSTRAP.mdの初回オンボーディングフロー：

1. エージェントが起動し、「Hey. I just came online. Who am I? Who are you?」と自問する
2. ユーザーと対話しながら：名前、キャラクター種別、雰囲気、絵文字を協力して決定
3. IDENTITY.md、USER.md、SOUL.mdを更新
4. BOOTSTRAP.mdを削除 — 「You don't need a bootstrap script anymore — you're you now」

オンボーディング状態は .openclaw/workspace-state.json に bootstrapSeededAt と onboardingCompletedAt として記録されます。

ブートストラップファイル群

src/agents/workspace.ts:412-466

ワークスペースから読み込まれる標準ファイル群：

ブートストラップファイルの制限

src/agents/pi-embedded-helpers/bootstrap.ts

• ファイルあたり上限: 20,000文字
• 合計上限: 150,000文字
• 切り詰め戦略: 先頭70% + 末尾20% + 切り詰めマーカー
• 設定でカスタマイズ可能: agents.defaults.bootstrapMaxChars

システムプロンプトの組み立てフロー

src/agents/system-prompt.ts:169-639

buildAgentSystemPrompt() が30以上のパラメータを受け取り、 以下のセクションを順番に組み立てます：

プロンプトモード

セクション一覧（組み立て順）

アイデンティティ解決の階層

メッセージプレフィックスやリアクション絵文字は、多層的な優先度で解決されます：

ACKリアクション解決順

1. L1 チャンネルアカウントレベル（channels.{channel}.accounts.{id}.ackReaction）
2. L2 チャンネルレベル（channels.{channel}.ackReaction）
3. L3 グローバルレベル（messages.ackReaction）
4. L4 エージェントアイデンティティの絵文字フォールバック
5. デフォルト 👀

メッセージプレフィックス解決順

1. 明示的に設定されたプレフィックス
2. hasAllowFrom が true → 空文字（プレフィックスなし）
3. アイデンティティ名をブラケット囲み（[name]）
4. フォールバック: [openclaw]

プロンプトセキュリティ

src/agents/sanitize-for-prompt.ts

sanitizeForPromptLiteral() はプロンプトインジェクション対策として、 ワークスペースパス等の外部入力値から以下を除去します：

• Unicode制御文字（Ccカテゴリ）
• Unicode書式文字（Cfカテゴリ）
• 行区切り / 段落区切り（U+2028 / U+2029）

これにより、攻撃者がディレクトリ名にプロンプト命令を埋め込む攻撃を防止します。

システムプロンプトパラメータ解決

src/agents/system-prompt-params.ts

buildSystemPromptParams() が以下を解決します：

• runtimeInfo — エージェントID、ホスト名、OS、アーキテクチャ、Nodeバージョン、モデル、シェル、チャンネル、能力
• userTimezone — 設定 agents.defaults.userTimezone から
• repoRoot — 設定またはgit rootの自動検出

エージェントスコープ（マルチエージェント）

src/agents/agent-scope.ts

OpenClawは複数のエージェントを同時に運用できます。各エージェントは独立した設定を持ちます：

• ワークスペース（デフォルト: ~/.openclaw/workspace、他: ~/.openclaw/workspace-{id}）
• モデル・プロバイダ
• スキル
• アイデンティティ
• サブエージェント設定
• サンドボックス設定
• ツールポリシー