jzOcb/config-guard

config-guard은(는) 무엇을 하나요?

OpenClaw 설정 변경을 검증하여 AI 에이전트가 시스템을 다운시키는 것을 방지합니다. 자동 백업, 스키마 검증 및 자동 롤백 기능을 제공합니다.

기능

• 설정 변경 전 자동 백업: 변경 사항을 적용하기 전에 현재 설정 파일의 백업을 생성합니다.
• 스키마 검증: 변경 사항이 사전 정의된 스키마를 준수하는지 확인하여 잘못된 구성을 방지합니다.
• 자동 롤백: 스키마 검증 실패 시 변경 사항을 자동으로 롤백하여 시스템 안정성을 유지합니다.
• 검증 보고서: 각 검증 결과에 대한 상세 보고서를 제공하여 문제를 쉽게 식별할 수 있습니다.

사용법

이 스킬은 OpenClaw 설정 파일을 수정하는 모든 AI 에이전트에서 자동으로 활성화됩니다. 다음과 같은 명령어를 지원합니다:

# 설정 변경 검증
export OPENCLAW_CONFIG_PATH="/path/to/config.yaml"
config-guard validate

# 백업 복원
config-guard restore --backup-id <backup-id>

# 백업 목록 확인
config-guard list-backups

환경 변수

변수명	설명	기본값
OPENCLAW_CONFIG_PATH	OpenClaw 설정 파일 경로	/etc/openclaw/config.yaml
CONFIG_GUARD_SCHEMA_PATH	검증 스키마 파일 경로	./schema.json
CONFIG_GUARD_BACKUP_DIR	백업 파일 저장 디렉토리	./backups

지원 플랫폼

• Claude Code
• Cursor
• Codex (GitHub Copilot)
• 기타 AI 에이전트 플랫폼

예시

다음은 Claude Code에서 설정을 변경할 때 자동으로 수행되는 검증 과정의 예시입니다:

1. 사용자가 설정 변경을 요청합니다.
2. config-guard가 현재 설정 파일을 ./backups/ 디렉토리에 자동 백업합니다.
3. 변경 사항을 스키마와 비교하여 검증합니다.
4. 검증 성공 시 변경 사항이 적용됩니다.
5. 검증 실패 시 변경 사항이 롤백되고 상세 오류 메시지가 반환됩니다.

# 검증 스키마 예시 (schema.json)
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "server": {
      "type": "object",
      "properties": {
        "port": {
          "type": "number",
          "minimum": 1024,
          "maximum": 65535
        }
      },
      "required": ["port"]
    }
  },
  "required": ["server"]
}