Openclaw용 safe-edit

중요한 구성 파일을 수정하기 전에 자동 롤백 및 백업을 생성하는 안전 우선 유틸리티입니다.

ijevin
v1.0.0
Mar 8, 2026
0
383
2

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install safe-edit

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 safe-edit 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

safe-edit란 무엇인가요?

safe-edit 스킬은 AI 기반 시스템 관리 및 개발자 워크플로우를 위한 필수 보안 계층입니다. 시스템 서비스, 애플리케이션 설정 또는 핵심 에이전트 매개변수와 같은 민감한 구성 파일에 대한 모든 수정 사항을 되돌릴 수 있도록 보장합니다. 시간 기반 롤백 메커니즘을 구현하여 Openclaw Skills가 자동화된 편집 작업 중에 실수로 서비스 중단이나 영구적인 데이터 손실을 일으키는 것을 방지합니다.

이 유틸리티는 변경 사항이 적용되기 전에 임시 복원 지점을 생성하여 Openclaw Skills를 위한 안전망 역할을 합니다. 크로스 플랫폼으로 설계되어 Linux, macOS, FreeBSD 및 Windows 환경을 기본 지원하므로 복잡한 구성 업데이트 중에 시스템 안정성을 유지하기 위한 다재다능한 도구입니다.

safe-edit 활용 사례

  • 에이전트의 기능을 유지하기 위해 openclaw.json과 같은 핵심 에이전트 구성 파일을 수정합니다.
  • crontab, nginx.conf 또는 docker-compose.yml 파일을 포함한 시스템 수준 서비스를 업데이트합니다.
  • 구문 오류의 위험 없이 예약된 작업 및 cron 작업을 안전하게 관리합니다.
  • 민감한 사용자 데이터, 권한 또는 인증 프로필을 조정합니다.
  • 실수로 인해 시스템이 잠길 수 있는 포트 또는 도메인 구성과 같은 네트워크 설정을 변경합니다.

safe-edit 작동 원리

  1. 사용자 또는 에이전트가 대상 파일 경로와 함께 start 명령을 호출하여 수정을 시작합니다.
  2. 스킬이 기존 구성 파일의 안전한 백업을 자동으로 생성합니다.
  3. 변경 사항이 확인되지 않을 경우 백업을 복원하기 위해 예약된 롤백 작업(기본 15분 창)이 초기화됩니다.
  4. 에이전트가 라이브 파일에 대해 필요한 구성 편집을 수행합니다.
  5. 변경 사항이 성공적으로 확인되면 사용자 또는 에이전트가 confirm 명령을 내려 대기 중인 롤백 타이머를 취소합니다.
  6. 오류가 발생하거나 서비스 시작에 실패하면 롤백을 수동으로 트리거하거나 타이머 만료 시 자동으로 실행되도록 할 수 있습니다.

safe-edit 설정 가이드

safe-edit 스킬은 일반적으로 Openclaw Skills 환경에 포함되어 있습니다. CLI 또는 워크플로우 내에서 사용하려면 경로에서 기본 스크립트에 액세스할 수 있는지 확인하세요.

# 특정 구성 파일에 대한 안전한 편집 세션 시작
safe-edit start /path/to/config.json

# 변경 사항 확인 및 자동 롤백 타이머 취소
safe-edit confirm

# 문제가 발생한 경우 즉시 수동 롤백 트리거
safe-edit cancel

# 현재 백업 및 활성 타이머 상태 확인
safe-edit status

safe-edit 데이터 스키마 및 분류 체계

이 스킬은 임시 백업 파일을 관리하고 시스템 수준의 작업 스케줄러를 활용하여 롤백 수명 주기를 유지합니다.

구성 요소 설명
백업 파일 수정 전에 안전하게 저장된 원본 구성 파일의 숨겨진 복사본입니다.
롤백 타이머 15분 안전 창을 추적하는 백그라운드 프로세스(at, schtasks 또는 sleep 사용)입니다.
상태 메타데이터 편집 중복을 방지하기 위해 Openclaw Skills에 의해 현재 보호 중인 파일을 추적합니다.

safe-edit 고급 기능

  • at(Linux/FreeBSD) 또는 schtasks(Windows)와 같은 기본 시스템 스케줄러를 사용한 멀티 플랫폼 지원.
  • 원격 편집 중 영구적인 시스템 잠금을 방지하기 위해 특별히 설계된 15분 자동 안전 창.
  • Openclaw Skills 워크플로우와의 원활한 통합으로 중요 파일 작업의 필수 전제 조건으로 안전한 편집을 강제합니다.
  • 전용 영구 작업 스케줄러가 없는 시스템을 위한 백그라운드 프로세스 관리.
  • 빠른 복구를 위한 즉각적인 수동 취소 및 복구 기능.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Requires
Github Stars: 0
forks: 0

추천*