すべてのプロダクト
Search
ドキュメントセンター

AI Guardrails:OpenClaw ランタイムの AI セキュリティ保護

最終更新日:Apr 11, 2026

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の呼び出しを認可する

  1. AI Guardrails コンソールにログインします。 左側のナビゲーションウィンドウで、Overviewをクリックします。 Product Integration セクションで、[OpenClaw] をクリックして OpenClaw プラグインパネルを開きます。

  2. SLR Authorization セクションで、Authorize をクリックします。

  3. プロンプトに従って権限付与を完了します。

ステップ 2:検出ポリシーの設定

  1. OpenClaw プラグインパネルの Detection Policy Confirmation セクションで、Go to Maintenance をクリックします。

  2. 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:保護のテスト

  1. 禁止用語や異常な命令など、リスクのあるコンテンツを含むテストリクエストを OpenClaw 経由で送信します。

  2. コンソールで遮断ログを確認します:

    1. AI Guardrails コンソールにログインします。左側のナビゲーションウィンドウで、Test Results > Result Query をクリックします。

    2. 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 未満

node --version を実行してバージョンを確認し、22 以降にアップグレードします

OpenClaw CLI がインストールされていない

openclaw -h を実行して確認し、公式ドキュメントに従って OpenClaw をインストールします

ネットワーク接続の失敗

ネットワーク接続を確認し、npm ミラーおよび Alibaba Cloud API へのアクセスを確保します

権限が不十分

現在のユーザーが OpenClaw のインストール権限を持っていることを確認するか、sudo を使用します

プラグインはインストールされたが有効化されていない

ゲートウェイが再起動されていない

OpenClaw ゲートウェイを手動で再起動します:openclaw gateway restart

プラグインの設定ファイルが破損している

プラグインを再インストールし、設定ファイルの整合性を確認します

遮断が有効でない

コンソールでの権限付与が完了していない

コンソールにログインして権限付与のステータスを確認し、権限付与設定を再実行します

コンソールのポリシー設定が有効になっていない

ポリシー設定ページに移動し、保護ディメンションが有効になっていることを確認します

テストリクエストが検出ルールをトリガーしなかった

テストリクエストのリスク特性を強化します (例:より明確な禁止用語を追加する)

コンソールに検出結果がない

プラグインが保護サーバーに正しく接続されていない

ネットワーク接続を確認し、プラグインが保護サーバー (ドメイン: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+