Agent Security Center：Agent 風險檢測與防護

檢測說明

• 檢測耗時：具體時間取決於資產複雜度。

• 系統影響：檢測過程為唯讀分析，不會影響線上業務運行。

• 結果有效期間：檢測結果反映檢測時刻的風險狀態，建議在配置變更後重新檢測。

系統定時自動檢測

接入Agent 安全中心後，系統每天自動對已接入的 AI 資產進行風險檢測。

• 掃描時間和頻率：每天自動執行一次。

• 掃描範圍：已接入的全部 AI 資產。

• 掃描結果：可在Agent 風險的風險事件列表中查看及處理。

手動檢測

手動檢測操作步驟如下：

1. 訪問Security Center控制台-Agent資訊安全中心-Agent概覽，在頁面左側頂部，選擇需防護資產所在的地區：中國內地或非中國內地。

2. 在接入平台地區，單擊右上方的資產同步。

3. 系統將同步平台的AI Agent、模型服務、工具集、資料集、應用配置等相關資料，同時進行風險檢測。

   說明

   資產同步可能需要一定的時間，請耐心等待。

AI安全護欄

AI 安全護欄是獨立的商業化安全服務，提供更全面的即時防護能力。開通後，檢測結果（風險事件）將同步至Agent 安全中心的Agent 風險列表中，便於統一管理。

1. 前往 | AI 安全護欄產品開通服務頁面，開通 AI 安全護欄產品服務。

   說明

   預設付費方式為按量後付費，按 API 呼叫次數計費，不調用服務不收費。具體價格和免費額度參考產品購買頁說明。

2. 配置檢測項、詞庫等資訊。具體操作，參考檢測項配置、詞庫管理。

3. 設定自訂檢測 Agent（可選），具體操作，參考快速使用自訂檢測Agent。

4. 執行檢測後，系統將自動同步檢測結果至Agent 安全中心，可在Agent 風險的風險事件列表中查看和處理。

Secure Access Service Edge（SASE）

SASE可掃描終端 AI 資產、識別風險終端、執行安全管控，建立終端 AI 使用合規管理流程。開通 SASE 服務後，相關資產和風險資料將自動同步至 Agent 資訊安全中心。

1. 前往Secure Access Service Edge | 購買頁，購買內網訪問安全（Private Access ）任意版本合適的服務。更多說明，請參見辦公安全平台計費概述。

2. 登入 辦公安全平台控制台，配置AI 資產掃描策略。

3. 配置 Agent 風險分析策略，具體操作，參考Agent 管理最佳實務。

4. 風險策略分析完成後，系統將自動同步相關風險和 AI 資產資料至Agent 安全中心，可在Agent 風險的風險事件列表中查看和處理。

操作步驟

1. 開啟AI安全護欄

   1. 登入 | AI 安全護欄產品控制台。

   2. 在防护配置 > 检测项配置頁面，搜尋 agent_runtime_guard（agent運行時防護）防護服務。

   3. 單擊 agent_runtime_guard操作列的管理。

   4. 按業務需求開啟防护维度，更多操作參考檢測項配置。

2. 安裝 Agent 安全防護外掛程式。

   系統自動安裝

   • 適用情境：僅支援已被 Agent 資訊安全中心檢測出的 OpenClaw 資產。

   • 操作步驟：

     • 一鍵大量安裝：

       1. 在Agent 概覽頁接入平台的 OpenClaw 地區，單擊立即防護。

       2. 在啟用 OpenClaw 即時防護彈窗中，選擇一鍵大量安裝。

          說明

          安裝任務提交後，預計 10 分鐘內完成。可關閉此視窗，完成後將自動同步 Agent 資產。

     • 單個 Agent 安裝：

       1. 進入Agent 概覽頁面，單擊 Agents 表徵圖，進入Agent詳情頁，切換視圖模式至列表。

       2. 在 Agent 列表頁，單擊目標 Agent 安全防護列下的表徵圖。

       3. 在安裝提示框中，單擊确定。

   手動安裝

   • 適用情境：系統自動安裝失敗或未被 Agent 資訊安全中心自動檢測到的 OpenClaw 資產。安裝完成後，相關資料將自動同步至 Agent 資訊安全中心。

   • 操作步驟：

     1. 在Agent 概覽頁接入平台的 OpenClaw 地區，單擊立即防護。

     2. 在啟用 OpenClaw 即時防護彈窗中，選擇手動安裝並複製安裝命令。安裝命令格式如下：

        重要

        安裝命令具有時效性，請注意在執行安裝指令地區顯示的到期時間，到期後需重新擷取。

        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 "<YOUR-INSTALLATION-KEY>" --autoRestart

     3. 登入 OpenClaw 部署伺服器，執行安裝命令。

        警告

        • 伺服器必須已安裝 OpenClaw 且 Node.js 版本 ≥ 22。可運行 node --version 查看目前的版本。

        • 安裝過程中需要重啟 OpenClaw Gateway，請先暫停 OpenClaw 相關操作。

     4. 確認安裝狀態：

        • 方式一：重新整理Agent 概覽頁，查看 OpenClaw 地區下已防護的資產是否增加。

        • 方式二：

          1. 在Agent 概覽的關係圖譜地區，單擊中央的 AGENTS 表徵圖。

          2. 進入Agent詳情頁面，切換查看模式為列表，安全防護列顯示為即表示安裝成功。更多說明，請參考安全防護外掛程式安裝情況。

外掛程式安裝故障排查

以下為常見安裝失敗情境及排查建議：

• sudo 使用者不存在錯誤

  • 錯誤資訊：sudo: unknown user <username> 和 sudo: error initializing audit plugin sudoers_audit

  • 可能原因：

    • sudo 配置中引用了不存在的使用者（可能是使用者名稱格式異常或已被刪除）。

    • sudoers 審計外掛程式初始化失敗，可能與 sudo 版本或 PAM 配置有關。

  • 排查方法：

    • 檢查 /etc/sudoers 及 /etc/sudoers.d/ 下的設定檔中是否存在異常使用者引用。

    • 確認該使用者是否在系統中存在：執行 id <username> 命令驗證。

  • 解決方案：嘗試修複 sudoers 配置或重新安裝 sudo 包。

• OpenClaw 未檢測到

  • 錯誤資訊：ERROR: 未檢測到可用的 openclaw（已嘗試 global / pnpm / docker）

  • 可能原因：

    • 伺服器上未安裝 OpenClaw 或安裝路徑不在系統 PATH 中。

    • OpenClaw 通過 pnpm 或 Docker 方式部署，但安裝指令碼未能正確檢測到。

  • 排查方法：

    • 確認 OpenClaw 已安裝並可正常運行：執行 which openclaw 或 openclaw --version。

    • 若 OpenClaw 通過 Docker 部署，確認容器正在運行：執行 docker ps | grep openclaw。

    • 若通過 pnpm 安裝，確認 pnpm 全域 bin 目錄在 PATH 中：執行 pnpm bin -g。

  • 解決方案：將 OpenClaw 可執行檔路徑添加到系統 PATH 後重新執行安裝命令。

• OpenClaw Gateway 進程缺失

  • 錯誤資訊：openclaw-gateway process not found

  • 可能原因：

    • openclaw-gateway 進程未運行或未安裝。

    • gateway 進程已崩潰或異常退出。

    • 進程名稱或路徑不匹配檢測指令碼

  • 排查方法：

    • 檢查 gateway 是否已安裝：which openclaw。

    • 檢查進程狀態：ps auxI grep openclaw-gateway。

    • 查看是否有相關 systemd 服務：ps auxI grep openclaw-gateway。

    • 檢查日誌確認 gateway 是否啟動失敗：journalctl -u openclaw-gatevay或查看應用日誌。

  • 解決方案：重啟openclaw gateway restart或重新安裝OpenClaw Gateway 即可。

OpenClaw 即時防護無法使用的原因是什嗎？

• 未購買AI安全護欄：啟用 OpenClaw 即時防護，需購買AI安全護欄。

• 防護外掛程式安裝失敗：安裝命令失效，若為手動安裝，在執行安裝指令地區可查看到期時間，到期後需重新擷取。