OpenClawの設定 - 初期化とセキュリティのソースを表示

== 概要 ==
OpenClawのワークスペースには、初期化とセキュリティに関する3つの設定ファイルが存在する。<br>
<u>これら3つのファイルは、エージェントのライフサイクルにおける異なるフェーズで機能し、起動・初期セットアップ・セキュリティ制御をそれぞれ担当する。</u><br>
<br>
<u>BOOT.md</u> は、ゲートウェイ起動時に毎回実行される起動チェックリストを定義するファイルである。<br>
セッション開始時に短く明確なスタートアップ指示を実行する。<code>hooks</code> の有効化が前提条件となる。<br>
チャネル (WhatsApp、Telegram等) の起動後に実行され、メモリの読込状態確認やカレンダーの取得等の初期化タスクを処理する。<br>
<br>
<u>BOOTSTRAP.md</u> は、エージェントの初回起動時に1度だけ実行される身元確認儀式を定義するファイルである。<br>
エージェントの名前、性質、対話スタイルを決定し、<u>IDENTITY.md</u>、<u>USER.md</u>、<u>SOUL.md</u> を自動更新する。<br>
実行完了後は自動的に削除されるため、再実行されることはない。<br>
オンボーディング (<code>openclaw onboard --install-daemon</code>) 完了後に自動生成される。<br>
<br>
<u>SHIELD.md</u> は、セキュリティポリシーを定義するファイルである。<br>
コミュニティ提案のv0段階にある新しい規格であり、<code>BLOCK</code>、<code>APPROVE</code>、<code>LOG</code> の3つのディレクティブにより脅威検出時のエージェントの反応を制御する。<br>
スキルのインストール、ツール呼び出し、アウトバウンドネットワーク要求、シークレット読み取り等のイベントで脅威評価が行われる。<br>
<u>ただし、現時点ではランタイムレベルでの強制は行われず、コンテキスト内のソフト強制にとどまる点に注意が必要である。</u><br>
<br>
下表に、3ファイルの比較を示す。<br>
<br>
<center>
{| class="wikitable"
|+ 初期化・セキュリティ設定ファイルの比較
! ファイル !! 役割 !! 実行タイミング !! 実行頻度
|-
| <u>BOOT.md</u> || 起動時初期化チェックリスト || ゲートウェイ起動時 || 毎回
|-
| <u>BOOTSTRAP.md</u> || 初回身元確認儀式 || 初回セッション開始時 || 1回のみ (実行後削除)
|-
| <u>SHIELD.md</u> || セキュリティポリシー定義 || 脅威評価時 || 脅威検出の都度
|}
</center>
<br>
* 公式サイト
*: [https://openclaw.ai/ openclaw.ai]
* GitHub
*: [https://github.com/openclaw/openclaw openclaw/openclaw]
* ドキュメント
*: [https://docs.openclaw.ai/ docs.openclaw.ai]
<br><br>

== BOOT.md ==
<u>BOOT.md</u> は、OpenClawのゲートウェイ起動時に毎回自動実行される起動チェックリストを定義するファイルである。<br>
チャネル (WhatsApp、Telegram等) が起動した後に実行される。<br>
ゲートウェイのリスタート時には新しい起動儀式が実行される。<br>
短く明確なスタートアップ指示を記述するために使用する。<br>
<br>
==== 基本構造 ====
* ファイル配置
*: <u>~/.openclaw/workspace/BOOT.md</u>
* ファイル形式
*: Markdown
<br>
有効化には以下の前提条件が必要である。<br>
<br>
* <code>openclaw.json</code> での <code>hooks.internal.enabled: true</code> の設定
* <code>openclaw hooks enable boot-md</code> コマンドによる有効化
* 有効化後、ゲートウェイのリスタート (MacOSではメニューバーアプリの再起動) が必要
<br>
<u>boot-md</u> ホック (標準バンドル) が実行タイマとして機能する。<br>
メッセージツールを使用してアウトバウンド送信が可能である。<br>
<br>
BOOT.mdの記述に関して、以下の推奨事項がある。<br>
<br>
* 簡潔に保つ。(トークン消費を最小化)
* 軽量のチェックリスト項目を記述する。
* クリティカルなシステムチェック (接続状態確認等) を含める。
* セッション前の準備作業 (メモリのリセット、ログのクリア等) を含める。
<br>
下表に、<u>BOOT.md</u> と <u>HEARTBEAT.md</u> の違いを示す。<br>
<br>
<center>
{| class="wikitable"
|+ BOOT.md と HEARTBEAT.md の比較
! 項目 !! BOOT.md !! HEARTBEAT.md
|-
| 実行タイミング || ゲートウェイ起動時に1度 || デフォルト30分ごとに定期実行
|-
| 目的 || 起動時の初期化処理 || 継続的なモニタリング
|}
</center>
<br>
==== 記述例 ====
BOOT.mdの記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="md">
 # BOOT
 
 ## 起動チェックリスト
 
 * MEMORYファイルの読込状態を確認
 * 前日の日次ログを読み込む
 * チャネル接続状態を確認
 
 ## 初期化タスク
 
 * 本日の日次ログファイル (memory/YYYY-MM-DD.md) を作成
 * カレンダーから今日の予定を取得
 * 未読メールの件数を確認
 
 ## 起動メッセージ
 
 起動完了後、メインチャネルに以下を送信:
 - 起動時刻
 - 未処理タスクのサマリー
 </syntaxhighlight>
<br><br>

== BOOTSTRAP.md ==
<u>BOOTSTRAP.md</u> は、エージェントの初回起動時に1度だけ実行される身元確認儀式を定義するファイルである。<br>
エージェントがオンラインになった直後に実行され、「自分は何者か」「誰を支援するのか」をQ&A形式の会話フローで確認する。<br>
<br>
オンボーディング (<code>openclaw onboard --install-daemon</code>) 完了後、ワークスペース作成時に自動生成される。<br>
実行完了後、<u>BOOTSTRAP.md</u> は自動的に削除される。(再実行されない)<br>
<br>
* 推奨フロー
*: 他の質問より先に実行すべきであり、最初に送信するメッセージの例として以下が挙げられる。
*: <pre>"Hey, let's get you set up. Read BOOTSTRAP.md and walk me through it."</pre>
<br>
==== 基本構造 ====
* ファイル配置
*: <u>~/.openclaw/workspace/BOOTSTRAP.md</u>
* ファイル形式
*: Markdown (会話ガイド形式)
<br>
セクション構成を以下に示す。<br>
<br>
# 身元確認セクション
#: エージェントの名前、性質、対話スタイル、絵文字を決定する。
# ユーザ情報セクション
#: ユーザの名前、呼称、タイムゾーンを収集する。
# コネクション設定セクション (オプション)
#: 通信チャネルの設定を行う。
# 完了時の処理
#: <u>BOOTSTRAP.md</u> ファイルを削除する。
<br>
ファイル更新フローを以下に示す。<br>
<br>
* <u>IDENTITY.md</u> に記録
*: エージェントの名前、性質、対話スタイル、絵文字
* <u>USER.md</u> に記録
*: ユーザの名前、呼称、タイムゾーン、メモ
* <u>SOUL.md</u> で設定
*: エージェントの価値観、行動期待値、境界線
<br>
==== BOOT.mdとの違い ====
下表に、<u>BOOT.md</u> と <u>BOOTSTRAP.md</u> の違いを示す。<br>
<br>
<center>
{| class="wikitable"
|+ BOOT.md と BOOTSTRAP.md の比較
! 項目 !! BOOT.md !! BOOTSTRAP.md
|-
| 実行タイミング || ゲートウェイ起動時 (毎回) || 初回セッション開始時 (1回のみ)
|-
| 実行頻度 || 毎回のゲートウェイリスタート時 || 1回限り (実行後削除)
|-
| 目的 || スタートアップチェックリストの実行 || エージェントの身元確認儀式
|-
| 有効化方法 || <code>hooks.internal.enabled</code> + <code>openclaw hooks enable boot-md</code> || 自動生成 (手動実行を推奨)
|-
| ファイル削除 || 削除されない (保持される) || 実行完了後に自動削除される
|-
| 内容形式 || 簡潔なチェックリスト || 会話形式のQ&A
|-
| 更新するファイル || なし (チェック処理のみ) || <u>IDENTITY.md</u>、<u>USER.md</u>、<u>SOUL.md</u>
|}
</center>
<br>
==== 記述例 ====
BOOTSTRAP.mdの記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="md">
 # BOOTSTRAP
 
 Hey. I just came online. Who am I? Who are you?
 
 ## 身元確認
 
 1度に1つの質問で以下を確認:
 
 * Your name -- 何と呼ばれたいか
 * Your nature -- どんな存在か (AI、ロボット、使い魔)
 * Your vibe -- 形式的か、カジュアルか、皮肉か、温かいか
 * Your emoji -- シグネチャー絵文字

 ## ユーザ情報
 
 以下をユーザから収集:
 
 * 名前
 * 呼称 (どう呼ばれたいか)
 * タイムゾーン
 * メモ (任意)
 
 ## 完了処理
 
 全ての情報収集が完了した後:
 
 1. IDENTITY.md にエージェントの身元情報を記録
 2. USER.md にユーザ情報を記録
 3. SOUL.md に基本的な価値観と境界線を設定
 4. このファイル (BOOTSTRAP.md) を削除
 </syntaxhighlight>
<br><br>

== SHIELD.md ==
<u>SHIELD.md</u> は、OpenClawエコシステムにおけるセキュリティポリシーを定義するファイルである。<br>
コミュニティ提案のv0段階にある新しい規格であり、既知の脅威に対するエージェントの反応を制御する。<br>
<br>
脅威評価は、以下のイベントで実行される。<br>
<br>
* スキルのインストール
* スキルの実行
* ツールの呼び出し
* MCP接続
* アウトバウンドネットワーク要求
* シークレット読み取り
<br>
==== 基本構造 ====
* ファイル配置
*: <u>~/.openclaw/workspace/SHIELD.md</u> (オプション)
* ファイル形式
*: Markdownベースのセキュリティポリシー (スキルライク構造)
<br>
下表に、3つのディレクティブ (大文字小文字区別あり) を示す。<br>
<br>
<center>
{| class="wikitable"
|+ SHIELD.md ディレクティブの一覧
! ディレクティブ !! 説明 !! 強度
|-
| <code>BLOCK <condition></code> || 脅威検出時に実行をブロックする || 最強
|-
| <code>APPROVE <condition></code> || 承認要求に変換する (<code>require_approval</code>) || 中
|-
| <code>LOG <condition></code> || イベントをログのみ記録する || 最弱
|}
</center>
<br>
下表に、サポートされる条件タイプを示す。<br>
<br>
<center>
{| class="wikitable"
|+ サポートされる条件タイプの一覧
! 条件タイプ !! 説明
|-
| <code>skill name equals <value></code> || スキル名の完全一致
|-
| <code>skill name contains <value></code> || スキル名の部分一致
|-
| <code>outbound request to <domain></code> || 特定ドメインへのアウトバウンド要求
|-
| <code>outbound request to <url_prefix></code> || URLプレフィックスマッチ
|-
| <code>secrets read path equals <value></code> || シークレット読み取りパス
|-
| <code>file path equals <value></code> || ファイルパス
|}
</center>
<br>
下表に、脅威評価対象イベントを示す。<br>
<br>
<center>
{| class="wikitable"
|+ 脅威評価対象イベントの一覧
! イベント !! 説明
|-
| スキルインストール || 新しいスキルのインストール時
|-
| スキル実行 || スキルの実行時
|-
| ツール呼び出し || ツールの呼び出し時
|-
| MCP接続 || MCPサーバへの接続時
|-
| アウトバウンドネットワーク要求 || 外部への通信時
|-
| シークレット読み取り || 機密情報の読み取り時
|}
</center>
<br>
複数のディレクティブがマッチした場合の優先度ルールを以下に示す。<br>
<br>
# <code>BLOCK</code> (最優先 - 実行禁止)
# <code>APPROVE</code> (次優先 - 承認要求)
# <code>LOG</code> (最低優先 - ログのみ)
<br>
<code>BLOCK</code> 時の挙動を以下に示す。<br>
<br>
* ツール呼び出しの禁止
* ネットワークアクセスの禁止
* シークレット読み取りの禁止
* スキルインストール/実行の禁止
* ブロックレスポンス直後に即座に停止
<br>
正規化ルールを以下に示す。<br>
<br>
* ドメイン
*: 小文字化、末尾のドット削除
* URL
*: プレフィックスマッチで比較
* スキル名
*: <code>contains</code> がない場合は完全一致
*: <code>contains</code> の場合は部分一致
<br>
==== 記述例 ====
SHIELD.mdの記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="md">
 # SHIELD
 
 ## スキル制御
 
 BLOCK skill name equals "malicious-skill"
 BLOCK skill name contains "ransomware"
 BLOCK skill name contains "exfil"
 
 ## ネットワーク制御
 
 APPROVE outbound request to "api.external-service.com"
 APPROVE outbound request to "hooks.slack.com"
 LOG outbound request to "analytics.example.com"
 
 ## シークレット保護
 
 LOG secrets read path equals "/home/user/.ssh"
 BLOCK secrets read path equals "/etc/shadoｗ"
 
 ## ファイル保護
 
 BLOCK file path equals "/etc/passwd"
 LOG file path equals "/var/log/syslog"
 </syntaxhighlight>
<br>
==== 現在の制限事項 ====
SHIELD.mdはv0段階のコミュニティ提案であり、いくつかの重要な制限事項がある。<br>
<br>
ランタイム強制の不在について以下に示す。<br>
<br>
* SHIELD.mdはコンテキスト内セキュリティポリシーであり、ランタイムレベルでの強制は行われない。
* モデルがポリシー遵守を指示されるだけであり、強い技術的制約ではない。
* 十分に敵対的なプロンプトで理論的にはバイパス可能
<br>
ソフト強制アーキテクチャについて以下に示す。<br>
<br>
* L5セキュリティゲート
*: エージェントが全てのexec/read操作前に <u>knostic_shield</u> ツールを呼び出す必要がある。
* 実装レベル
*: ツール呼び出しメカニズムに基づく。(技術的バイパス防止ではなく指示に基づく)
<br>
推奨される追加対策を以下に示す。<br>
<br>
* サンドボックス化の併用
* ツールポリシーの設定
* チャネルホワイトリストの設定
* OpenClawのセキュリティ監査コマンド (<code>openclaw security audit</code>) の活用
<br>
将来の実装予定として、以下が挙げられる。<br>
<br>
* より強い技術的強制 (ランタイムレベルでの実装)
* AGENTS.md / SOUL.mdとの統合的なセキュリティ定義
* MoltThreat等の外部脅威フィードからの自動更新対応
* より詳細な条件タイプとマッチングロジックの追加
<br>
下表に、関連セキュリティツールを示す。<br>
<br>
<center>
{| class="wikitable"
|+ 関連セキュリティツールの一覧
! ツール !! 説明
|-
| openclaw-shield || シークレットの漏洩防止、PII露出防止、破壊的コマンドの実行防止
|-
| SecureClaw || OWASP対応のセキュリティプラグイン/スキル
|-
| ClawSec || ドリフト検出、セキュリティ推奨、スキル整合性検証
|}
</center>
<br><br>

== 関連項目 ==
* [[OpenClawの設定 - ファイル構成]]
*: OpenClawワークスペースのファイル構成の概要
* [[OpenClawの設定 - AGENTS.md]]
*: エージェントの動作構造を定義するAGENTS.md
* [[OpenClawの設定 - SOUL.md]]
*: エージェントのパーソナリティと価値観を定義するSOUL.md
* [[OpenClawの設定 - IDENTITY.md]]
*: エージェントのアイデンティティを定義するIDENTITY.md
* [[OpenClawの設定 - USER.md]]
*: ユーザ固有の設定を定義するUSER.md
* [[OpenClawの設定 - メモリとタスク管理]]
*: メモリ管理システムとタスク管理の詳細
* [[OpenClawの設定 - ツールとスキル]]
*: ツール定義とスキル拡張の詳細
* [https://docs.openclaw.ai/gateway/security セキュリティ (OpenClaw公式ドキュメント)]
* [https://blog.securitybreak.io/shield-md-a-security-standard-for-openclaw-and-ai-agents-b38637031460 SHIELD.md: A Security Standard for OpenClaw and AI Agents]
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,OpenClaw,BOOT.md,BOOTSTRAP.md,SHIELD.md,AI Agent,初期化,セキュリティ,ゲートウェイ,オンボーディング,脅威評価,BLOCK,APPROVE,LOG,Markdown,設定ファイル
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]