​

openclaw security

openclaw security audit
openclaw security audit --deep
openclaw security audit --deep --password <password>
openclaw security audit --deep --token <token>
openclaw security audit --auth password --password <password>
openclaw security audit --fix
openclaw security audit --json

​

稽核模式

​

檢查內容

• 當多個私訊傳送者共用主工作階段時發出警告，並建議安全私訊模式：共享收件匣使用 session.dmScope="per-channel-peer"（多帳戶頻道則使用 per-account-channel-peer）。這是合作式/共享收件匣強化，不是針對彼此不信任操作者的隔離；對於這種情況，請用獨立閘道（或獨立 OS 使用者/主機）分隔信任邊界。
• 當 config 顯示可能有共享使用者入口（例如開放私訊/群組政策、已設定的群組目標，或萬用字元傳送者規則）時，發出 security.trust_model.multi_user_heuristic，OpenClaw 的預設信任模型是個人助理（一位操作者），不是敵意多租戶隔離。對於有意的共享使用者設定：將所有工作階段沙箱化、將檔案系統存取限制在工作區範圍內，並讓個人/私人身分或憑證遠離該執行階段。
• 當小型模型（<=300B 參數）在未沙箱化且啟用網頁/瀏覽器工具的情況下使用時發出警告。

• hooks.token 太短
• hooks.path="/"
• hooks.defaultSessionKey 未設定
• hooks.allowedAgentIds 未受限制
• 已啟用請求 sessionKey 覆寫
• 已啟用覆寫但未設定 hooks.allowedSessionKeyPrefixes

• 當沙箱 Docker 設定已設定但沙箱模式關閉時發出警告。
• 當 gateway.nodes.denyCommands 使用無效的類模式/未知項目時發出警告（比對只針對精確的節點命令名稱，不是 shell 文字篩選）。
• 當 gateway.nodes.allowCommands 明確啟用危險節點命令時發出警告。
• 當全域 tools.profile="minimal" 被代理工具設定檔覆寫時發出警告。
• 當寫入/編輯工具被停用，但 exec 仍可在沒有約束性沙箱檔案系統邊界的情況下使用時發出警告。
• 當開放私訊或群組在沒有沙箱/工作區防護的情況下暴露執行階段/檔案系統工具時發出警告。
• 當已安裝的外掛工具可能在寬鬆工具政策下可被觸及時發出警告。

• 當沙箱瀏覽器使用 Docker bridge 網路且未設定 sandbox.browser.cdpSourceRange 時發出警告。
• 標記危險的沙箱 Docker 網路模式，包括 host 和 container:* 命名空間加入。
• 當現有沙箱瀏覽器 Docker 容器缺少/過期 hash 標籤（例如遷移前容器缺少 openclaw.browserConfigEpoch）時發出警告，並建議 openclaw sandbox recreate --browser --all。

• 標記 gateway.allowRealIpFallback=true（若 proxy 設定錯誤，會有 header 偽造風險）。
• 標記 discovery.mdns.mode="full"（透過 mDNS TXT 記錄洩漏中繼資料）。
• 當 gateway.auth.mode="none" 讓閘道 HTTP API 可在沒有共享密鑰的情況下觸及時發出警告（/tools/invoke 加上任何已啟用的 /v1/* endpoint）。

• 當以 npm 為基礎的外掛/hook 安裝記錄未釘選、缺少完整性中繼資料，或與目前已安裝套件版本偏離時發出警告。
• 當頻道允許清單依賴可變名稱/email/標籤，而不是穩定 ID 時發出警告（Discord、Slack、Google Chat、Microsoft Teams、Mattermost、IRC 範圍在適用時）。

​

SecretRef 行為

​

抑制

{
  "security": {
    "audit": {
      "suppressions": [
        {
          "checkId": "plugins.tools_reachable_permissive_policy",
          "detailIncludes": "Enabled extension plugins: gbrain",
          "reason": "trusted local operator plugin"
        }
      ]
    }
  }
}

​

JSON 輸出

openclaw security audit --json | jq '.summary'
openclaw security audit --deep --json | jq '.findings[] | select(.severity=="critical") | .checkId'

openclaw security audit --fix --json | jq '{fix: .fix.ok, summary: .report.summary}'

​

--fix 變更內容

• 將常見的 groupPolicy="open" 翻轉為 groupPolicy="allowlist"（包含受支援頻道中的帳戶變體）
• 當 WhatsApp 群組政策翻轉為 allowlist 時，若已儲存的 allowFrom 檔案存在且 config 尚未定義 allowFrom，就從該檔案植入 groupAllowFrom
• 將 logging.redactSensitive 從 "off" 設為 "tools"
• 收緊 state/config 和常見敏感檔案（credentials/*.json、auth-profiles.json、sessions.json、工作階段 *.jsonl）的權限
• 也會收緊從 openclaw.json 參照的 config include 檔案
• 在 POSIX 主機上使用 chmod，在 Windows 上使用 icacls 重設

• 輪替 token/密碼/API key
• 停用工具（gateway、cron、exec 等）
• 變更閘道 bind/auth/network exposure 選擇
• 移除或重寫外掛/Skills

​

相關

• 命令列介面參考
• 安全性稽核