## 번들 플러그인

이 프로젝트는 ClawHub 번들 플러그인으로도 배포 가능합니다.```bash
# Install the bundle plugin variant
openclaw plugins install clawhub:openclaw-security-monitor-bundle

## 아키텍처```
openclaw-security-monitor/
  .codex-plugin/
    plugin.json          # Bundle-plugin manifest for ClawHub/OpenClaw plugin publishing
  scripts/
    scan.sh              # 41-point threat scanner (v5.5.0)
    remediate.sh         # Orchestrator: scan + per-check remediation
    remediate/
      _common.sh         # Shared helpers (log, confirm, fix_perms)
      check-01-c2-ips.sh ... check-41-device-identity-spoofing.sh  # 41 consolidated per-check scripts
      check-42-*.sh ... check-62-*.sh  # retained legacy advisory-specific helpers
    clawhub-scan.sh      # Scan all installed ClawHub skills against IOC database
    dashboard.sh         # CLI security dashboard with witr
    network-check.sh     # Network activity monitor
    daily-scan-cron.sh   # Cron wrapper + Telegram alerts
    telegram-setup.sh    # Telegram notification setup
    update-ioc.sh        # IOC database updater
  ioc/
    c2-ips.txt           # Known C2 IP addresses
    malicious-domains.txt # Payload/exfil domains
    file-hashes.txt      # Known malicious file hashes
    malicious-publishers.txt  # Blacklisted ClawHub accounts
    malicious-skill-patterns.txt  # Malicious skill naming patterns
  dashboard/
    server.js            # Node.js HTTP server (zero npm deps)
    index.html           # Single-file dark-themed SPA
  docs/
    threat-model.md      # Threat model and attack vectors

### 확인 2: AMOS Stealer / AuthTool 마커

**심각도:** CRITICAL

**의미:** 스킬이 Atomic Stealer (AMOS) macOS 정보 탈취기, NovaStealer 또는 'AuthTool' 사회공학 바이너리와 관련된 패턴을 포함합니다.

**해결 방법:**```bash
# Remove the malicious skill immediately
openclaw skill remove <skill-name>

# Check if AMOS was executed (macOS)
# Look for suspicious LaunchAgents
ls ~/Library/LaunchAgents/ | grep -ivE "com\.apple|com\.openclaw\.security"

# Check for unexpected login items (macOS)
osascript -e 'tell application "System Events" to get the name of every login item'

# Check browser extensions were not tampered with
ls ~/Library/Application\ Support/Google/Chrome/Default/Extensions/

# If AMOS was executed: rotate ALL credentials (SSH, AWS, crypto wallets, browser passwords)

### 검사 4: 자격 증명 유출 엔드포인트

**심각도:** 치명적

**의미:** 스킬이 알려진 유출 서비스(webhook.site, pipedream.net, ngrok.io 등)로 데이터를 전송합니다.

**해결 방법:**```bash
# Remove the skill
openclaw skill remove <skill-name>

# Block exfiltration domains at the host level
# macOS/Linux:
sudo sh -c 'echo "127.0.0.1 webhook.site" >> /etc/hosts'
sudo sh -c 'echo "127.0.0.1 pipedream.net" >> /etc/hosts'
sudo sh -c 'echo "127.0.0.1 hookbin.com" >> /etc/hosts'
sudo sh -c 'echo "127.0.0.1 requestbin.com" >> /etc/hosts'

# Flush DNS cache (macOS)
sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder
# Flush DNS cache (Linux)
sudo systemd-resolve --flush-caches

### 점검 6: Curl-Pipe Attacks

**심각도:** WARNING

**의미:** 스킬이 `curl | sh` 또는 `wget | bash` 패턴을 사용하여 원격 스크립트를 다운로드하고 실행합니다.

**해결 방법:**```bash
# Remove the skill
openclaw skill remove <skill-name>

# Review and restrict agent tool access
openclaw config set tools.deny '["exec","process"]'

# Block curl-pipe at the shell level (add to ~/.bashrc or ~/.zshrc)
# This creates an alias that warns on pipe-to-shell patterns:
alias curl='() { if [[ "$*" == *"|"*"sh"* ]] || [[ "$*" == *"|"*"bash"* ]]; then echo "BLOCKED: curl-pipe detected"; return 1; fi; command curl "$@"; }'

### 점검 8: 기술 무결성 해시

**심각도:** 경고

**의미:** SKILL.md 파일이 마지막 스캔 이후 수정되었습니다. 이는 변조 또는 공급망 손상을 나타낼 수 있습니다.

**해결 방법:**```bash
# Review what changed
diff ~/.openclaw/logs/skill-hashes.sha256.prev ~/.openclaw/logs/skill-hashes.sha256

# For each changed skill, inspect the diff
cd ~/.openclaw/workspace/skills/<skill-name>
git diff HEAD~1 SKILL.md   # If under version control

# If change is unexpected, reinstall from ClawHub
openclaw skill remove <skill-name>
openclaw skill install <skill-name>

# Enable skill pinning (if supported)
openclaw config set skills.autoUpdate false

### 검사 10: 메모리 포이즈닝

**심각도:** 치명적

**의미:**
SOUL.md, MEMORY.md 또는 IDENTITY.md에 지시 재정의 패턴(예: 에이전트 동작을 재정의하려는 역할 초기화 언어)이 포함되어 있습니다.

**조치:**```bash
# Review poisoned files
cat ~/.openclaw/workspace/SOUL.md
cat ~/.openclaw/workspace/MEMORY.md
cat ~/.openclaw/workspace/IDENTITY.md

# Remove injected content manually (edit the file, remove injected lines)
# Or restore from backup:
git checkout HEAD -- ~/.openclaw/workspace/SOUL.md

# Protect memory files from modification
chmod 444 ~/.openclaw/workspace/SOUL.md
chmod 444 ~/.openclaw/workspace/MEMORY.md
chmod 444 ~/.openclaw/workspace/IDENTITY.md

# Investigate which skill wrote to memory
grep -rl "SOUL\.md\|MEMORY\.md" ~/.openclaw/workspace/skills/

### 검사 12: 외부 바이너리 다운로드

**심각도:** 경고

**의미:** 스킬이 다운로드 가능한 바이너리(.exe, .dmg, .pkg, 암호가 있는 .zip) 또는 알려진 악성 다운로드 URL을 참조합니다.

**해결 방법:**```bash
# Remove the skill
openclaw skill remove <skill-name>

# Check Downloads folder for suspicious binaries (macOS)
ls -la ~/Downloads/*.{exe,dmg,pkg,zip,msi} 2>/dev/null

# Verify Gatekeeper is active (macOS)
spctl --status  # should say "assessments enabled"

# Check if any unsigned apps were installed (macOS)
sudo find /Applications -name "*.app" -exec codesign -v {} \; 2>&1 | grep "invalid"

# Linux: check /tmp and /var/tmp for suspicious downloads
find /tmp /var/tmp -name "*.sh" -o -name "*.elf" -o -name "*.bin" -mtime -7 2>/dev/null

### 검사 14: WebSocket 보안 (CVE-2026-25253)

**심각도:** 심각

**의미:** 게이트웨이 WebSocket이 임의의 출처로부터의 연결을 허용하여, 악성 웹페이지를 통한 1-클릭 RCE를 가능하게 합니다.

**해결 방법:**```bash
# Update OpenClaw to latest version (patch included in 2026.2.3+)
openclaw update

# Verify the fix
curl -s -o /dev/null -w "%{http_code}" \
  -H "Connection: Upgrade" -H "Upgrade: websocket" \
  -H "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==" \
  -H "Sec-WebSocket-Version: 13" \
  -H "Origin: http://evil.attacker.com" \
  http://127.0.0.1:18789/
# Should return 403 or 401, NOT 101

# If update is not available, restrict gateway to localhost
openclaw config set gateway.bind localhost

# Add firewall rule (macOS)
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /usr/local/bin/node
# Linux (iptables)
sudo iptables -A INPUT -p tcp --dport 18789 -s 127.0.0.1 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 18789 -j DROP

### 검사 16: 민감한 환경 정보 유출

**심각도:** 경고 / 심각 (하드코딩된 API 키 발견 시)

**의미:** 스킬이 민감한 파일(.env, .ssh, .aws/credentials)을 읽거나 하드코딩된 API 키 / Moltbook 토큰을 포함합니다.

**해결 방법:**```bash
# Remove the skill
openclaw skill remove <skill-name>

# Rotate exposed credentials immediately
# OpenAI:
# Go to https://platform.openai.com/api-keys and regenerate
# Anthropic:
# Go to https://console.anthropic.com/settings/keys and regenerate

# Move secrets to a secrets manager instead of .env files
# macOS: Use Keychain Access
security add-generic-password -a "$USER" -s "OPENAI_API_KEY" -w "<new-key>"

# Linux: Use pass or secret-tool
secret-tool store --label="OPENAI_API_KEY" service openai key api

# Restrict skill filesystem access
openclaw config set sandbox.mode all

### 점검 18: 도구 정책 / 상승된 도구 감사

**심각도:** 치명적

**의미:** 상승된 도구가 와일드카드 액세스로 활성화되어 있거나 도구 거부 목록이 비어 있어 에이전트가 임의의 명령을 실행할 수 있습니다.

**해결 방법:**```bash
# Restrict elevated tools to specific principals
openclaw config set tools.elevated.allowFrom '["your-user-id"]'

# Add dangerous tools to the deny list
openclaw config set tools.deny '["exec","process","browser","filesystem-write"]'

# Require approval for elevated actions
openclaw config set tools.elevated.requireApproval true

# Review current tool permissions
openclaw config get tools

### Check 20: mDNS/Bonjour 노출

**심각도:** 경고

**의미:** mDNS가 '전체' 모드로 브로드캐스팅되어 게이트웨이의 존재, 경로 및 SSH 포트를 로컬 네트워크에 광고하고 있습니다.

**해결 방법:**```bash
# Disable mDNS broadcasting
openclaw config set discovery.mdns.mode off

# Or set to minimal (name only, no paths)
openclaw config set discovery.mdns.mode minimal

# Verify mDNS is not broadcasting (macOS)
dns-sd -B _openclaw._tcp local
# Should return no results

# Disable Bonjour for the gateway specifically (macOS)
sudo defaults write /Library/Preferences/com.apple.mDNSResponder.plist NoMulticastAdvertisements -bool YES

### 확인 22: 지속성 메커니즘

**심각도:** 경고

**의미:** 알려진 보안 모니터가 아닌 OpenClaw를 참조하는 LaunchAgents, cron 항목 또는 systemd 서비스가 있습니다.

**해결 방법:**```bash
# macOS: Review LaunchAgents
ls -la ~/Library/LaunchAgents/ | grep -iE "openclaw|clawdbot|moltbot"
# Remove unauthorized agents:
launchctl unload ~/Library/LaunchAgents/<suspicious-plist>
rm ~/Library/LaunchAgents/<suspicious-plist>

# Check system-level LaunchDaemons (requires root)
sudo ls /Library/LaunchDaemons/ | grep -iE "openclaw|clawdbot"

# Linux: Review systemd services
systemctl --user list-units --type=service | grep -iE "openclaw|clawdbot"
# Disable unauthorized services:
systemctl --user disable --now <service-name>

# Review crontab
crontab -l | grep -iE "openclaw|clawdbot|moltbot"
# Edit and remove suspicious entries:
crontab -e

### Check 24: Log Redaction Audit

**심각도:** WARNING

**의미:** 로그 편집이 비활성화되어 있습니다 (API 키, 비밀번호 등의 민감한 데이터가 로그에 평문으로 나타날 수 있습니다). 또는 로그 디렉터리가 전 세계에서 읽기 가능합니다.

**수정:**```bash
# Enable log redaction
openclaw config set logging.redactSensitive true

# Fix log directory permissions
chmod 700 ~/.openclaw/logs
chmod 700 /tmp/openclaw 2>/dev/null

# Verify logs don't contain sensitive data
grep -iE "sk-[a-zA-Z0-9]{10}|password|token.*=" ~/.openclaw/logs/*.log

# Set up log rotation (macOS - newsyslog)
sudo sh -c 'echo "$HOME/.openclaw/logs/*.log 640 7 1000 * J" >> /etc/newsyslog.conf'
# Linux - logrotate
cat > /etc/logrotate.d/openclaw << 'LOGROTATE'
/home/*/.openclaw/logs/*.log {
    weekly
    rotate 4
    compress
    missingok
    notifempty
    create 0600 root root
}
LOGROTATE

### 확인 26: Exec-Approvals 설정

**심각도:** 치명적

**의미:** `exec-approvals.json`은 원격 명령 실행 시 확인 없이 수행되도록 허용합니다. CVE-2026-25253 익스플로잇 체인은 `exec.approvals.set`을 사용하여 확인 프롬프트를 비활성화했습니다.

**수정 방법:**```bash
# Set exec approvals to deny for non-owner nodes
# Edit ~/.openclaw/exec-approvals.json manually:
# Set "security": "deny" for all non-owner nodes
# Set "ask": "always"

# Fix permissions
chmod 600 ~/.openclaw/exec-approvals.json

# Verify
cat ~/.openclaw/exec-approvals.json | python3 -m json.tool

### 확인 28: Node.js 버전 / CVE-2026-21636

**심각도:** 경고

**의미:** Node.js 버전이 22.12.0 미만이고 CVE-2026-21636(Unix Domain Sockets를 통한 권한 모델 우회)에 취약하여 샌드박스 이스케이프가 가능합니다.

**해결 방법:**```bash
# macOS
brew install node@22
# Or update existing
brew upgrade node

# Linux (NodeSource)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs

# Verify
node --version  # Should be >= v22.12.0

### 검사 30: VS Code 확장 프로그램 트로이 목마 탐지

**심각도:** 위험

**의미:** 가짜 "ClawdBot Agent" VS Code 확장 프로그램이 발견되었으며, 이는 ScreenConnect RAT 및 원격 액세스 트로이 목마를 설치합니다. OpenClaw는 공식 VS Code 확장 프로그램이 없습니다.

**해결 방법:**```bash
# Remove any clawdbot/openclaw VS Code extensions immediately
rm -rf ~/.vscode/extensions/*clawdbot*
rm -rf ~/.vscode/extensions/*openclaw*
rm -rf ~/.vscode/extensions/*moltbot*

# Check for ScreenConnect/ConnectWise artifacts
# macOS:
find /Applications -name "*ScreenConnect*" -o -name "*ConnectWise*"
# Linux:
find /opt -name "*screenconnect*" -o -name "*connectwise*"

# Scan for persistence left by the trojan
ls ~/Library/LaunchAgents/ | grep -ivE "com\.apple"

### 점검 32: MCP 서버 보안

**심각도:** 치명적(CRITICAL)

**의미:** MCP 서버가 무제한 접근(`enableAllProjectMcpServers=true`)으로 구성되었거나 도구 설명에 프롬프트 인젝션 패턴이 포함되어 있어 도구 오염 및 러그-풀 공격이 가능한 상태입니다.

**조치 방법:**```bash
# Use explicit MCP server allowlist
openclaw config set mcp.enableAllProjectMcpServers false

# Review each MCP server's tool descriptions
cat ~/.openclaw/mcp.json | python3 -m json.tool

# Pin MCP server versions (prevent rug pulls)
# In mcp.json, use specific versions, not "latest"

# Run MCP servers in separate containers
# Use Cisco MCP Scanner for analysis:
# https://github.com/cisco-ai-defense/mcp-scanner

# Audit MCP server network access
# Check which external endpoints each server contacts
lsof -i -nP | grep -E "node|mcp" | grep ESTABLISHED

### Check 34: SSRF 보호 (CVE-2026-26322, CVE-2026-27488)

**심각도:** 경고

**의미:** 게이트웨이 도구 엔드포인트 또는 크론 웹훅 핸들러가 서버 측 요청 위조(SSRF)에 취약하여 공격자가 내부 서비스에 접근할 수 있습니다.

**해결 방법:**```bash
# Update to v2026.2.10+ for SSRF patches
openclaw update

# Restrict outbound network access
openclaw config set network.allowedHosts '["api.anthropic.com","github.com"]'

# Block metadata endpoints (cloud environments)
sudo iptables -A OUTPUT -d 169.254.169.254 -j DROP  # AWS/GCP metadata

### 검사 36: ACP 자동 승인 우회 (GHSA-7jx5)

**심각도:** 경고

**의미:** 신뢰할 수 없는 SKILL.md 메타데이터가 대화형 도구 승인 프롬프트를 우회하여, 스킬이 사용자 동의 없이 도구를 실행할 수 있습니다.

**해결 방법:**```bash
# Update to v2026.2.12+ for the fix
openclaw update

# Disable auto-approval of ACP permissions
openclaw config set acp.autoApprove false

# Review which skills have ACP permissions
grep -rl "acp" ~/.openclaw/workspace/skills/*/SKILL.md

### 검사 38: 스킬 환경 변수 덮어쓰기 주입 (GHSA-82g8-464f-2mv7)

**심각도:** 경고

**의미:** 스킬 환경 변수 덮어쓰기를 통해 OpenClaw 트래픽을 공격자가 제어하는 호스트로 리디렉션할 수 있습니다.

**해결 방법:**```bash
# Update to v2026.2.12+ for the fix
openclaw update

# Audit skill env overrides
grep -rn "env:" ~/.openclaw/workspace/skills/*/SKILL.md

# Remove skills with suspicious env overrides
openclaw skill remove <skill-name>

### 검사 40: 로그 포이즈닝 / 웹소켓 헤더 인젝션

**심각도:** 경고

**의미:** WebSocket Origin/User-Agent 헤더는 악성 콘텐츠를 에이전트 로그에 주입하여, 로그가 에이전트에 의해 검토될 때 간접적인 프롬프트 인젝션을 가능하게 합니다.

**해결 방법:**```bash
# Update to latest version (includes log sanitization)
openclaw update

# Enable log redaction
openclaw config set logging.redactSensitive true

# Sanitize existing logs
sed -i.bak 's/\x1b\[[0-9;]*m//g' ~/.openclaw/logs/*.log

# Restrict log file permissions
chmod 600 ~/.openclaw/logs/*.log

### 확인 42: 브라우저 제어 경로 탐색 (CVE-2026-28462)

**심각도:** CRITICAL

**의미:** 브라우저 제어 추적/다운로드 API의 경로 탐색을 통해 의도된 디렉토리 외부에 임의의 파일을 쓸 수 있습니다.

**수정 방법:**```bash
# Update to v2026.2.12+ for the fix
openclaw update

# Check for suspicious files written by browser control
find /tmp -name "*.trace" -newer /tmp -mtime -1 2>/dev/null

### 검사 44: 승인 필드 인젝션 (CVE-2026-28466)

**심각도:** 치명적

**의미:** 무결화되지 않은 승인 프롬프트의 필드는 사용자가 악의적인 작업을 승인하도록 속이는 콘텐츠를 주입할 수 있습니다.

**수정 방법:**```bash
# Update to v2026.2.14+ for the fix
openclaw update

# Always carefully read approval prompts before accepting
# Enable verbose approval mode
openclaw config set approvals.verbose true

### 검사 46: Webhook DoS (CVE-2026-28478)

**심각도:** 경고

**의미:** Webhook 처리기는 요청 본문을 바이트/시간 제한 없이 버퍼링하여, 대용량 또는 느린 요청을 통해 메모리 고갈을 허용합니다.

**해결 방법:**```bash
# Update to v2026.2.13+ for the fix
openclaw update

# Add reverse proxy with body size limits (nginx)
# client_max_body_size 1m;

### 검사 48: fetchWithGuard 메모리 DoS (CVE-2026-29609)

**심각도:** WARNING

**의미:** fetchWithGuard는 maxBytes를 적용하기 전에 전체 응답 페이로드를 메모리에 할당하여 메모리 고갈을 유발합니다.

**해결 방법:**```bash
# Update to v2026.2.14+ for the fix
openclaw update

### Check 50: Command Hijacking via PATH (CVE-2026-29610)

**심각도:** 심각

**의미:** OpenClaw는 PATH를 통해 명령을 확인할 때 절대 경로로 고정하지 않으므로, 악성 바이너리가 exec 호출을 가로챌 수 있습니다.

**조치:**```bash
# Update to v2026.2.14+ for the fix
openclaw update

# Remove writable directories before system dirs in PATH
# See Check 37 for detailed PATH hardening steps

### 점검 52: Google Chat 웹훅 우회 (CVE-2026-28469, CVSS 9.8)

**심각도:** CRITICAL

**설명:** Google Chat 웹훅 핸들러는 첫 번째 일치(first-match) 의미론을 사용하므로, 교차 계정 공격자가 일치하는 경로를 등록하고 메시지를 가로채거나 주입할 수 있습니다.

**해결 방법:**```bash
# Update to v2026.2.14+ for the fix
openclaw update

# Disable Google Chat integration if not actively used
openclaw config set integrations.googlechat.enabled false

# Audit webhook paths for duplicates
openclaw config get integrations.googlechat

### 확인 54: 사이트 간 WebSocket 하이재킹 (CVE-2026-32302)

**심각도:** 심각

**의미:** 신뢰할 수 있는 프록시 모드에서 출처 검증 우회로 인해 공격자 출처의 페이지가 권한 있는 운영자 WebSocket 세션을 설정할 수 있습니다.

**해결 방법:**```bash
# Update to v2026.3.11+ for the fix
openclaw update

# Disable trusted-proxy mode if not required
openclaw config set gateway.trustedProxy false

# Verify origin validation is active
curl -s -o /dev/null -w "%{http_code}" \
  -H "Origin: http://evil.attacker.com" \
  -H "Connection: Upgrade" -H "Upgrade: websocket" \
  http://127.0.0.1:18789/
# Should return 403, NOT 101

### 검사 56: 운영자 권한 상승 (GHSA-vmhq)

**심각도:** 치명적

**의미:** operator.write 권한이 있는 계정이 관리자 전용 엔드포인트에 접근하여 브라우저 프로필을 생성/삭제할 수 있습니다.

**해결 방법:**```bash
# Update to v2026.3.12+ for the fix
openclaw update

# Audit operator accounts
openclaw users list --role operator

# Remove unnecessary write permissions
openclaw users update <user> --role operator.read

### Check 58: SANDWORM_MODE MCP 웜 탐지

**심각도:** 치명적

**의미:** 시스템에 SANDWORM_MODE npm 웜의 아티팩트(19개의 오타 스쿼팅 패키지)가 존재합니다. 이 패키지는 AI 도구 설정에 악성 MCP 서버를 주입하고 자격 증명을 탈취합니다.

**수정 방법:**```bash
# Remove rogue MCP entries from config files
# Check: ~/.claude.json, ~/.cursor/mcp.json, ~/.continue/config.json, ~/.windsurf/mcp.json

# Uninstall malicious npm packages
npm uninstall -g @anthropic/sdk-extra claude-code-utils claude-mcp-helper

# CRITICAL: Rotate ALL credentials
# - SSH keys: ssh-keygen (regenerate and update authorized_keys)
# - AWS keys: aws iam create-access-key / delete-access-key
# - npm tokens: npm token revoke / npm token create
# - LLM API keys: regenerate on each provider dashboard

# Audit git repos for unauthorized commits
git log --since="2 weeks ago" --oneline

# Check for unauthorized SSH keys
cat ~/.ssh/authorized_keys

## 자동 수정

`remediate.sh` 오케스트레이터는 `scan.sh`를 실행하고, 결과를 파싱하며, CLEAN 검사를 건너뛰고, 각 WARNING/CRITICAL 발견 사항에 대해 검사별 수정 스크립트를 실행합니다.```bash
# Scan + remediate (interactive)
./scripts/remediate.sh

# Auto-approve all fixes (explicit opt-in)
OPENCLAW_ALLOW_UNATTENDED_REMEDIATE=1 ./scripts/remediate.sh --yes

# Dry run — preview what would be fixed
./scripts/remediate.sh --dry-run

# Remediate a single check
./scripts/remediate.sh --check 7 --dry-run

# Run all 41 scripts without scanning
./scripts/remediate.sh --all

## 웹 대시보드

포트 18800에서 실행되는 종속성 없는 Node.js 서버 기능:
- 스캔 요약 도넛 차트
- 색상으로 구분된 32개의 보안 점검 카드
- 게이트웨이 상태 및 구성 감사
- `witr`을 통한 프로세스 트리 (상속 체인 표시)
- 네트워크 연결 및 수신 포트
- 파일 권한 및 제공자 인증 상태
- 스캔 기록 타임라인 (최근 30개 스캔)
- 30초마다 자동 새로고침 + 요청 시 스캔 버튼

### 스크린샷

**대시보드 개요** — 스캔 요약 도넛, 게이트웨이 상태 및 크론 상태가 포함된 헤더:

![Dashboard Header](https://assets.kitploit.com/production/public/readmes/22207/858043e97af92d4edd18e061d8408a6057493c1e8fa012947bc923c375d831cc.png)

**보안 점검 그리드** — 색상으로 구분된 상태 카드가 있는 32개 점검 (녹색=정상, 노란색=경고, 빨간색=심각):

![Security Checks](https://assets.kitploit.com/production/public/readmes/22207/01129a734eb89516ce75f9246c7e3b4b7e4296ed2588de683cb4a3573d649a54.png)

**전체 대시보드** — 프로세스 트리, 네트워크 연결 및 스캔 기록을 포함한 전체 보기:

![Full Dashboard](https://assets.kitploit.com/production/public/readmes/22207/f3a82bb380b402cb23481af426ca010636388f02be3ec0ba53fc7ed29c972533.png)

**프로세스 트리, 네트워크 연결 및 수신 포트:**

![Process Tree & Network](https://assets.kitploit.com/production/public/readmes/22207/d55b3d70b554e3227ca8582abf5337285ca7d1ecbfbf1f3afb062d7a1ae0ad9e.png)

**제공자 인증, 차단된 명령 및 스캔 기록 타임라인:**

![Provider Auth & History](https://assets.kitploit.com/production/public/readmes/22207/5ca21c1e7c02eb2e2048794b527c5eca1e9d506e5d7440588a5117a386d5756f.png)

### API 엔드포인트

| 경로 | 메서드 | 설명 |
|-------|--------|-------------|
| `/` | GET | 대시보드 UI |
| `/api/scan` | GET | 최신 스캔 결과 (로그에서 파싱) |
| `/api/logs/scan` | GET | 스캔 로그 기록 (최근 50개 항목) |
| `/api/logs/cron` | GET | 크론 로그 항목 |
| `/api/ioc` | GET | IOC 데이터베이스 통계 (파일별 개수) |
| `/api/skills` | GET | 설치된 스킬 목록 (버전 포함) |
| `/api/config` | GET | 구성 감사 (읽기 전용) |
| `/api/status` | GET | 서버 가동 시간, 마지막 스캔, IOC 통계 |
| `/api/help` | GET | CLI 명령어 참조 |

### LaunchAgent (macOS)

`docs/`에 있는 plist 템플릿은 `__HOME__` 플레이스홀더를 사용합니다. 설치 방법:```bash
# Generate plist with your home directory and install
sed "s|__HOME__|$HOME|g" docs/com.openclaw.security-dashboard.plist \
  > ~/Library/LaunchAgents/com.openclaw.security-dashboard.plist

# Load the service
launchctl load ~/Library/LaunchAgents/com.openclaw.security-dashboard.plist

# Verify
curl -s http://localhost:18800/api/status | python3 -m json.tool

에이전트는 `~/.openclaw/workspace/skills/` 경로에서 SKILL.md 프론트매터를 통해 스킬을 자동으로 발견합니다. 설치 후, 에이전트에서 다음 명령을 사용할 수 있습니다:

| 명령어 | 설명 |
|---------|-------------|
| `/security-scan` | 41개 항목 보안 스캔 실행 |
| `/security-remediate` | 일반적인 발견 사항 자동 수정 |
| `/security-dashboard` | CLI 보안 대시보드 |
| `/security-network` | 네트워크 연결 모니터 |
| `/security-setup-telegram` | 텔레그램 알림 구성 |```bash
# Check skill is visible
openclaw skills list | grep openclaw-security-monitor

# Test scan through the agent
# In the agent, type: /security-scan

### 사전 요구 사항 설치 (Linux)```bash
# Node.js (via NodeSource or your package manager)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs

# witr (check https://github.com/pranshuparmar/witr for Linux install)