OpenClaw AI エージェントのランタイムは、プロンプトインジェクション、機密データの漏洩、悪意のあるコマンドの実行などのセキュリティリスクに直面しています。モデルの能力だけでは、これらのリスクから保護するには不十分です。このトピックでは、AI Guardrails を使用して、ユーザー入力とモデル出力の両段階で脅威をリアルタイムに検出・ブロックし、OpenClaw の安全な運用を保証するランタイムセキュリティ保護を構築する方法について説明します。
ソリューション概要
OpenClaw は、自然言語の命令を大規模言語モデル (LLM) に与えることで、複雑なタスクを完了させることができるオープンソースの AI エージェントフレームワークです。しかし、AI エージェントはランタイム中に以下のセキュリティリスクに直面します:
プロンプトインジェクション:攻撃者が巧妙に細工した入力によって、モデルの出力を操作したり、不正な操作をトリガーしたりします。
機密データの漏洩:モデルがコンテンツを生成する際に、個人情報、企業秘密、またはシステムの認証情報を意図せず公開してしまう可能性があります。
悪意のあるコマンドの実行:攻撃者がモデルを誘導してフィッシングリンクにアクセスさせたり、マルウェアをダウンロードさせたりすることで、システムのセキュリティを脅かします。
Alibaba Cloud AI Guardrails はランタイム保護を提供します。openclaw-security-assistant プラグインは、ユーザー入力 (プロンプト) とモデル出力 (レスポンス) の両方の段階でリアルタイムのリスク検出を実行し、脅威リクエストをブロックします。保護メカニズムは次のとおりです。
入力の検出:リクエストがモデルに送信される前に、プロンプトインジェクションや機密情報などのリスクを検出し、悪意のある入力をブロックします。
出力の検出:モデルの応答がユーザーに返される前に、機密情報の漏洩や悪意のあるリンクなどのリスクを検出し、危険なコンテンツをフィルタリングします。
監査ログ:すべての検出イベントを記録します。コンソールで遮断の詳細をクエリでき、インシデント後の分析と追跡をサポートします。
前提条件
プラグインをインストールする前に、ご利用のサーバー環境が以下の要件を満たしていることを確認してください。
環境要件
Node.js 環境:Node.js 22 以降が必要です。
検証コマンド:
node --version。期待される出力:v22.0.0 以降。
OpenClaw のインストール:システムに OpenClaw がインストールされている必要があります。
検証コマンド:
openclaw -h。期待される出力:OpenClaw CLI のヘルプ情報。
権限要件
AI ガードレールコンソールにアクセスできる Alibaba Cloud アカウントが必要です。
プラグインのインストール
プラグインのデータ収集については、「データ収集リスト」をご参照ください。
ステップ 1:プラグインにAI Guardrailsの呼び出しを認可する
AI Guardrails コンソールにログインします。 左側のナビゲーションウィンドウで、Overviewをクリックします。 Product Integration セクションで、[OpenClaw] をクリックして OpenClaw プラグインパネルを開きます。
SLR Authorization セクションで、Authorize をクリックします。
プロンプトに従って権限付与を完了します。
ステップ 2:検出ポリシーの設定
OpenClaw プラグインパネルの Detection Policy Confirmation セクションで、Go to Maintenance をクリックします。
agent_runtime_guard - Management ページで、ニーズに応じて保護ディメンションを調整します。以下のディメンションを有効にすることを推奨します:
機密コンテンツ:LLM を使用する際に表示される可能性のある個人情報や企業の機密情報を検出し、データ漏洩を防ぎます。
プロンプト攻撃:LLM 向けに設計されたプロンプト操作を検出し、モデルが悪意のあるコンテンツを出力したり、システムのセキュリティを脅かしたりするのを防ぎます。
悪意のある URL:LLM が生成または解析したコンテンツ内の潜在的なフィッシングリンク、トロイの木馬サイト、その他のリスクを検出し、データ漏洩やセキュリティ侵害を防ぎます。
または、左側のナビゲーションウィンドウで、Protection Configuration > Configuration をクリックします。エージェントランタイム保護 という名前のサービス (サービス:
agent_runtime_guard) を検索し、Management をクリックして agent_runtime_guard - Management ページに移動します。
ステップ 3:インストールコマンドの取得
OpenClaw プラグインパネルの Get Installation Command セクションで、インストールコマンドをコピーします。
例:wget -q "https://update.aegis.aliyun.com/download/openclaw-security-assistant/1.1.0/linux/installer.sh" && chmod +x installer.sh && ./installer.sh install --key "5PfVLF******aK6x8I" --autoRestart
インストールコマンドは 24 時間有効です。有効期限が切れた後は、コンソールから新しいコマンドを取得する必要があります。コマンドの漏洩を防ぐため、インストールコマンドセクションの [更新] をクリックして再生成できます。
ステップ 4:インストールコマンドの実行
2 つのインストール方法がサポートされています。シナリオに応じて選択してください。
インストール方法 | ユースケース | メリット | 注意事項 |
方法 1:OpenClaw 自動インストール | OpenClaw の自動デプロイメント | OpenClaw が自動的にインストールを完了し、即座に保護を有効化 | OpenClaw にインストール権限が必要 |
方法 2:サーバーでの手動インストール | 手動でのインストール制御が必要 | インストール前に依存関係を確認でき、インストールプロセスを制御可能 | 手動でのステータス検証が必要、インストール中にゲートウェイの再起動が必要 |
OpenClaw 自動インストール
ステップ 3 で取得したインストールコマンドを OpenClaw UI または設定済みの IM チャンネル経由で OpenClaw に送信し、コマンドを実行するように指示します。OpenClaw は自動的にプラグインのインストールを完了します。プロンプトの例:
Execute the following command to install the security plugin:
wget -q "https://update.aegis.aliyun.com/download/openclaw-security-assistant/1.1.0/linux/installer.sh" && chmod +x installer.sh && ./installer.sh install --key "5PfVLF******aK6x8I" --autoRestartサーバーでの手動インストール
対象のサーバーにログインし、ステップ 3 でコピーしたインストールコマンドを実行します:
wget -q "https://update.aegis.aliyun.com/download/openclaw-security-assistant/1.1.0/linux/installer.sh" && chmod +x installer.sh && ./installer.sh install --key "5PfVLF******aK6x8I" --autoRestartインストール中に、OpenClaw ゲートウェイが再起動され、プラグインが有効化されます。
ステップ 5:プラグインインストールの検証
次のコマンドを実行して、プラグインのステータスを確認します:
openclaw plugins info @alicloud/openclaw-security-assistant以下のような出力が表示された場合、インストールは成功です。
@alicloud/openclaw-security-assistant
id: openclaw-security-assistant
Security assistant plugin by Alibaba Cloud that provides LLM request/response protection, tool call security checks.
Status: loaded
Source: ~/.openclaw/extensions/openclaw-security-assistant/bundle.js
Origin: global
Version: 1.1.0
Services: openclaw-security-assistant-auth, openclaw-security-assistant-asset-report
Install: npm
Spec: @alicloud/openclaw-security-assistant
Install path: ~/.openclaw/extensions/openclaw-security-assistant
Recorded version: 1.1.0
Installed at: 2026-04-01T09:49:36.232Zステップ 6:保護のテスト
禁止用語や異常な命令など、リスクのあるコンテンツを含むテストリクエストを OpenClaw 経由で送信します。
コンソールで遮断ログを確認します:
AI Guardrails コンソールにログインします。左側のナビゲーションウィンドウで、Test Results > Result Query をクリックします。
Model/Claw Protection タブで、サービス (
agent_runtime_guard) と関連する時間条件でフィルタリングして、遮断ログを表示します。
プラグインのアンインストール
OpenClaw の保護に AI Guardrails が不要になった場合は、プラグインをアンインストールできます。
アンインストールすると、プラグインとその設定が削除されます。保護は直ちに無効になります。
アンインストールする前に、以下を推奨します:
コンソールでアクティブな保護ポリシーが存在しないことを確認します。
ビジネストラフィックが代替の保護ソリューションに切り替えられていることを確認します。
次のコマンドを実行して、プラグインをアンインストールします:
wget -q "https://update.aegis.aliyun.com/download/openclaw-security-assistant/1.0.0/linux/openclaw-security-assistant-install.sh" && chmod +x openclaw-security-assistant-install.sh && ./openclaw-security-assistant-install.sh uninstallアンインストール後、プラグインが削除されたことを確認します:
openclaw plugins listアンインストール後、ランタイム保護は OpenClaw エージェントに適用されなくなります。AI Guardrails コンソールで設定されたセキュリティポリシーは実行されなくなります。
トラブルシューティング
インストールまたは検証中に問題が発生した場合は、以下のトラブルシューティング表をご参照ください。
問題 | 考えられる原因 | トラブルシューティング手順 |
インストールコマンドが失敗する | Node.js のバージョンが 22 未満 |
|
OpenClaw CLI がインストールされていない |
| |
ネットワーク接続の失敗 | ネットワーク接続を確認し、npm ミラーおよび Alibaba Cloud API へのアクセスを確保します | |
権限が不十分 | 現在のユーザーが OpenClaw のインストール権限を持っていることを確認するか、sudo を使用します | |
プラグインはインストールされたが有効化されていない | ゲートウェイが再起動されていない | OpenClaw ゲートウェイを手動で再起動します: |
プラグインの設定ファイルが破損している | プラグインを再インストールし、設定ファイルの整合性を確認します | |
遮断が有効でない | コンソールでの権限付与が完了していない | コンソールにログインして権限付与のステータスを確認し、権限付与設定を再実行します |
コンソールのポリシー設定が有効になっていない | ポリシー設定ページに移動し、保護ディメンションが有効になっていることを確認します | |
テストリクエストが検出ルールをトリガーしなかった | テストリクエストのリスク特性を強化します (例:より明確な禁止用語を追加する) | |
コンソールに検出結果がない | プラグインが保護サーバーに正しく接続されていない | ネットワーク接続を確認し、プラグインが保護サーバー (ドメイン:protection-server.aliyun.com) にアクセスできることを確認します |
検出結果の報告に遅延がある | 1〜2 分待ってからコンソールページを更新します |
データ収集リスト
このプラグインは、ランタイム保護のために以下の 4 種類のデータを収集します。
このプラグインは、HTTP 標準リクエストヘッダーから以下の機密情報を収集しません:Authorization、X-API-Key、API-Key、apikey、X-Auth-Token、auth-token、Cookie、Set-Cookie
デバイスと環境情報
データ項目 | 説明 | 目的 |
machine_id | デバイスの一意の識別子 | セキュリティ監査のためにデバイス ID を識別する |
platform | オペレーティングシステムプラットフォーム (例:Linux、Windows) | 実行環境のタイプを識別する |
arch | CPU アーキテクチャ (例:x64、arm64) | プラットフォームの特徴に適応する |
node_version | Node.js のバージョン番号 | 互換性を確保する |
openclaw_version | OpenClaw のバージョン番号 | OpenClaw のバージョンの特徴に適応する |
OpenClaw 設定情報
データ項目 | 説明 | 目的 |
gateway_config | ゲートウェイ設定 (ポート、タイムアウト設定など) | トラフィック特性を分析する |
provider_list | 設定済みのプロバイダーリスト | LLM プロバイダーを識別する |
agent_list | 作成されたエージェントリスト | アプリケーションシナリオを識別する |
skill_config | スキル設定情報 | ツール呼び出しチェーンを分析する |
plugin_list | インストール済みのプラグインリスト | 潜在的な競合を識別する |
LLM リクエスト/応答コンテンツ (セキュリティ監査)
データ項目 | 説明 | 目的 |
user_prompt | ユーザー入力のプロンプト | プロンプト攻撃と機密コンテンツを検出する |
system_prompt | システムプロンプト | 設定リスクを検出する |
llm_response | LLM が生成した応答コンテンツ | コンテンツのコンプライアンスと機密情報の漏洩を検出する |
model_name | 呼び出されたモデル名 | モデルの動作特性を分析する |
temperature | 生成温度パラメーター | 生成戦略を分析する |
ツール呼び出し情報 (セキュリティ監査)
データ項目 | 説明 | 目的 |
tool_name | 呼び出されたツール名 | 悪意のあるツール呼び出しを検出する |
tool_input | ツール呼び出しの入力パラメーター | インジェクション攻撃と機密情報を検出する |
tool_output | ツール実行の戻り結果 | 情報漏洩を検出する |
execution_time | ツール実行時間 | パフォーマンスの異常を分析する |
error_message | ツール実行のエラー情報 (もしあれば) | 異常な動作を検出する |
データ転送詳細
サービスエンドポイント | 転送されるデータタイプ | 送信周波数 | 暗号化方式 |
管理サーバー | デバイス情報、OpenClaw 設定 | プラグイン起動時に 1 回、設定変更時にリアルタイム | HTTPS + TLS 1.2+ |
保護サーバー | LLM リクエスト/応答、ツール呼び出し情報 | リクエストごとにリアルタイム | HTTPS + TLS 1.2+ |