메인 콘텐츠로 건너뛰기

​
openclaw security

보안 도구(audit + 선택적 수정). 관련 문서:

​
Audit

openclaw security audit
openclaw security audit --deep
openclaw security audit --deep --password <password>
openclaw security audit --deep --token <token>
openclaw security audit --fix
openclaw security audit --json
이 audit는 여러 DM 발신자가 메인 세션을 공유할 때 경고를 표시하며, 공유 받은편지함을 위한 보안 DM 모드인 session.dmScope="per-channel-peer"(다중 account 채널에서는 per-account-channel-peer)를 권장합니다. 이 설정은 협업형/공유 받은편지함 강화를 위한 것입니다. 상호 신뢰하지 않거나 적대적인 운영자들이 하나의 Gateway를 공유하는 구성은 권장되지 않으며, 별도의 gateways(또는 별도의 OS 사용자/호스트)로 신뢰 경계를 분리해야 합니다. 또한 config가 공유 사용자 유입 가능성을 시사할 때(예: 열린 DM/group 정책, 구성된 그룹 대상, 와일드카드 발신자 규칙) security.trust_model.multi_user_heuristic를 출력하고, OpenClaw의 기본 신뢰 모델은 개인 비서 모델이라는 점을 상기시킵니다. 의도적인 공유 사용자 설정의 경우, audit 가이드는 모든 세션을 샌드박스 처리하고, 파일 시스템 접근을 workspace 범위로 제한하며, 개인/비공개 identity 또는 자격 증명을 해당 런타임에서 분리해 둘 것을 권장합니다. 또한 작은 모델(<=300B)이 샌드박싱 없이 사용되며 web/browser 도구가 활성화된 경우에도 경고합니다. webhook 유입에 대해서는 hooks.token이 Gateway 토큰을 재사용하는 경우, hooks.token이 짧은 경우, hooks.path="/"인 경우, hooks.defaultSessionKey가 설정되지 않은 경우, hooks.allowedAgentIds가 제한되지 않은 경우, 요청 sessionKey 재정의가 활성화된 경우, 그리고 hooks.allowedSessionKeyPrefixes 없이 재정의가 활성화된 경우를 경고합니다. 또한 샌드박스 모드가 꺼져 있는데 sandbox Docker 설정이 구성된 경우, gateway.nodes.denyCommands가 효과 없는 패턴형/알 수 없는 항목을 사용하는 경우(정확한 노드 command-name 매칭만 지원하며 셸 텍스트 필터링은 아님), gateway.nodes.allowCommands가 위험한 노드 명령을 명시적으로 활성화하는 경우, 전역 tools.profile="minimal"이 에이전트 도구 프로필에 의해 재정의되는 경우, 열린 그룹이 샌드박스/workspace 보호 없이 런타임/파일 시스템 도구를 노출하는 경우, 설치된 extension plugin 도구가 느슨한 도구 정책 아래에서 접근 가능할 수 있는 경우도 경고합니다. 또한 gateway.allowRealIpFallback=true(프록시가 잘못 구성된 경우 헤더 스푸핑 위험)와 discovery.mdns.mode="full"(mDNS TXT 레코드를 통한 메타데이터 노출)도 표시합니다. 또한 sandbox browser가 sandbox.browser.cdpSourceRange 없이 Docker bridge 네트워크를 사용할 때도 경고합니다. 또한 위험한 sandbox Docker 네트워크 모드(host, container:* 네임스페이스 조인 포함)도 표시합니다. 또한 기존 sandbox browser Docker 컨테이너에 해시 라벨이 없거나 오래된 경우(예: 마이그레이션 이전 컨테이너에 openclaw.browserConfigEpoch가 없는 경우)도 경고하며 openclaw sandbox recreate --browser --all을 권장합니다. 또한 npm 기반 plugin/hook 설치 기록이 pin되지 않았거나, 무결성 메타데이터가 없거나, 현재 설치된 패키지 버전과 드리프트가 있을 때도 경고합니다. 또한 채널 allowlist가 안정적인 ID 대신 변경 가능한 이름/이메일/태그에 의존하는 경우(해당하는 Discord, Slack, Google Chat, Microsoft Teams, Mattermost, IRC scopes)도 경고합니다. 또한 gateway.auth.mode="none"으로 인해 Gateway HTTP API가 공유 비밀 없이 접근 가능한 상태(/tools/invoke와 활성화된 모든 /v1/* 엔드포인트 포함)일 때도 경고합니다. dangerous/dangerously 접두사가 붙은 설정은 명시적인 긴급 우회 운영자 재정의이며, 그 자체만으로는 보안 취약점 보고 대상이 아닙니다. 전체 위험 파라미터 목록은 Security의 “Insecure or dangerous flags summary” 섹션을 참조하세요. SecretRef 동작:
  • security audit는 대상 경로에 대해 지원되는 SecretRefs를 읽기 전용 모드로 확인합니다.
  • 현재 명령 경로에서 SecretRef를 사용할 수 없으면 audit는 중단되지 않고 secretDiagnostics를 보고합니다.
  • --token과 --password는 해당 명령 호출의 deep-probe 인증만 재정의하며, config나 SecretRef 매핑은 다시 쓰지 않습니다.

​
JSON 출력

CI/정책 검사에는 --json을 사용하세요. 
openclaw security audit --json | jq '.summary'
openclaw security audit --deep --json | jq '.findings[] | select(.severity=="critical") | .checkId'
--fix와 --json을 함께 사용하면 출력에는 수정 작업과 최종 보고서가 모두 포함됩니다. 
openclaw security audit --fix --json | jq '{fix: .fix.ok, summary: .report.summary}'

​
--fix가 변경하는 항목

--fix는 안전하고 결정적인 수정만 적용합니다.
  • 일반적인 groupPolicy="open"을 groupPolicy="allowlist"로 전환합니다(지원되는 채널의 account 변형 포함)
  • WhatsApp group 정책이 allowlist로 전환될 때, 저장된 allowFrom 파일 목록이 존재하고 config에 아직 allowFrom이 정의되지 않은 경우 해당 목록으로 groupAllowFrom을 초기화합니다
  • logging.redactSensitive를 "off"에서 "tools"로 설정합니다
  • 상태/config 및 일반적인 민감 파일에 대한 권한을 강화합니다 (credentials/*.json, auth-profiles.json, sessions.json, 세션 *.jsonl)
  • 또한 openclaw.json에서 참조되는 config include 파일의 권한도 강화합니다
  • POSIX 호스트에서는 chmod, Windows에서는 icacls 재설정을 사용합니다
--fix가 하지 않는 것:
  • 토큰/비밀번호/API 키 교체
  • 도구 비활성화(gateway, cron, exec 등)
  • gateway bind/auth/network 노출 선택 변경
  • plugins/Skills 제거 또는 재작성