튜토리얼 카테고리 Skills 소개
ZH EN JA KO
보안 운영

Gateway 로그 시스템 설정 튜토리얼

· 4 분 소요

로그 시스템 개요

OpenClaw Gateway의 로그 시스템은 서비스 운영의 모든 주요 이벤트를 기록하며, 장애 해결과 보안 감사의 기초가 됩니다.

기본 설정

{
  "logging": {
    "level": "info",
    "format": "json",
    "console": true,
    "file": {
      "enabled": true,
      "path": "~/.openclaw/logs/gateway.log",
      "maxSize": "50m",
      "maxFiles": 10
    }
  }
}

로그 조회

openclaw logs --follow
openclaw logs --level error
openclaw logs --since "1h"
openclaw logs --grep "timeout"

로그 로테이션

{
  "logging": {
    "file": {
      "maxSize": "50m",
      "maxFiles": 10,
      "compress": true
    }
  }
}

분류 로그

{
  "logging": {
    "files": {
      "gateway": {"path": "~/.openclaw/logs/gateway.log", "level": "info"},
      "error": {"path": "~/.openclaw/logs/error.log", "level": "error"},
      "audit": {"path": "~/.openclaw/logs/audit.log", "events": ["auth", "config_change"]}
    }
  }
}

외부 시스템으로 로그 전송

Syslog 및 Loki 연동을 지원합니다.

민감 정보 마스킹

{
  "logging": {
    "redact": {
      "enabled": true,
      "patterns": ["apiKey", "token", "password"],
      "replacement": "***REDACTED***"
    }
  }
}

정리

로그 시스템은 OpenClaw 운영의 눈입니다. 적절한 로그 수준 설정, 로그 로테이션 활성화, 민감 정보 마스킹, 중앙 저장소로의 로그 전송은 관측성 플랫폼 구축의 기초입니다.

OpenClaw는 무료 오픈소스 개인 AI 어시스턴트로, WhatsApp, Telegram, Discord 등 다양한 플랫폼을 지원합니다