oh-my-openclaw: OpenClaw 설정을 프리셋으로 관리하는 CLI

OpenClaw는 강력하다. 하지만 설정이 복잡하다. openclaw.json, AGENTS.md, SOUL.md, 스킬, 플러그인… 에이전트를 다르게 구성하고 싶을 때마다 파일을 하나씩 수정해야 한다.

oh-my-openclaw는 이 문제를 프리셋으로 해결한다. 한 번의 명령어로 에이전트 성격, 도구, 모델 설정을 전환할 수 있다.

왜 프리셋인가?

OpenClaw 설정의 복잡성

OpenClaw 에이전트를 구성하는 파일들:

• openclaw.json — 메인 설정
• AGENTS.md — 에이전트 지침
• SOUL.md — 에이전트 성격
• USER.md — 사용자 정보
• 스킬 디렉토리
• 플러그인 설정

이걸 매번 수동으로 바꾸면?

1. 실수하기 쉽다
2. 이전 설정을 잊어버린다
3. 공유하기 어렵다

프리셋의 접근

oh-my-openclaw는 이 모든 것을 프리셋으로 묶는다:

{
  name: "my-preset",
  description: "My custom configuration",
  version: "1.0.0",
  config: {
    identity: {
      name: "CustomBot",
      emoji: "🤖"
    }
  },
  workspaceFiles: ["AGENTS.md"],
  skills: ["my-skill"],
  openclawPlugins: ["openclaw-memory-auto-recall"]
}

한 번에 적용. 한 번에 전환.

핵심 기능

1. 프리셋 목록

oh-my-openclaw list

Available presets:

 apex [builtin]
 All-in-one power assistant with full capabilities (all-in-one, power, assistant)
 v1.0.0

2. 프리셋 적용

# 기본 프리셋
oh-my-openclaw apply apex

# GitHub에서 바로 적용
oh-my-openclaw apply minpeter/demo-researcher

# 전체 URL로 적용
oh-my-openclaw apply https://github.com/minpeter/demo-researcher

옵션:

3. 설정 비교

oh-my-openclaw diff apex

현재 설정과 프리셋의 차이를 구조적으로 비교한다.

4. 프리셋 내보내기

oh-my-openclaw export my-custom-setup \
  --description "My custom configuration" \
  --version "1.0.0"

현재 설정을 재사용 가능한 프리셋으로 저장한다.

5. 빠른 설치

oh-my-openclaw install

apply apex의 단축 명령어.

GitHub 원격 프리셋

공개 저장소에서 바로 적용

oh-my-openclaw apply minpeter/demo-researcher

로컬에 프리셋을 만들 필요 없다. GitHub 저장소에서 바로 가져온다.

캐시 동작

• 원격 프리셋은 ~/.openclaw/oh-my-openclaw/presets/owner--repo/에 자동 캐시
• --force 플래그로 재다운로드

참고: 현재 공개 저장소만 지원. 비공개 저장소는 인증 미지원.

스킬 번들링

프리셋에 스킬을 포함할 수 있다:

{
  name: "my-preset",
  skills: ["my-skill"],  // skills/ 디렉토리 내 스킬명
  config: { ... }
}

구조:

my-preset/
├── preset.json5
├── skills/
│   └── my-skill/
│       └── SKILL.md
└── AGENTS.md

적용 시 자동으로 ~/.agents/skills/에 복사된다.

플러그인 부트스트랩

프리셋에서 OpenClaw 플러그인을 자동 설치할 수 있다:

{
  name: "my-preset",
  openclawPlugins: ["openclaw-memory-auto-recall"],
  openclawBootstrap: {
    memoryIndex: true  // openclaw memory index 실행
  }
}

apex 프리셋이 이 방식으로 openclaw-memory-auto-recall을 설치하고 메모리 인덱싱을 실행한다.

병합 전략

openclaw.json 병합

• 스칼라 (String, Number, Boolean): 덮어쓰기
• 객체: 재귀적 병합
• 배열: 전체 교체
• Null: 키 삭제

민감 필드 필터링

내보내기와 비교에서 자동 제외:

• auth, env, meta
• gateway.auth
• hooks.token
• models.providers.*.apiKey
• channels.*.botToken, channels.*.token

백업 시스템

적용 전 자동 백업:

~/.openclaw/oh-my-openclaw/backups/
├── 2026-03-07T10-00-00/
│   ├── openclaw.json
│   └── workspace/
│       ├── AGENTS.md
│       └── SOUL.md

문제 발생 시 이전 설정으로 복구 가능.

Docker 통합

Docker Compose로 실행하는 경우:

# 초기 설정
docker compose down -v && docker compose up --build --pull never

# 페어링 코드 승인
docker compose exec openclaw openclaw pairing approve telegram <CODE>

개발

# 의존성 설치
bun install

# 린트
bun run lint

# 테스트
bun test

# 타입 체크
bun run typecheck

# 빌드
bun run build:compile

프로젝트 구조

src/
├── core/        # 병합 전략, 백업, 민감 필드 필터링
├── commands/    # CLI 명령 (list, apply, export, diff, install)
└── presets/     # 빌트인 프리셋 템플릿

사용 사례

1. 개발/프로덕션 전환

# 개발용 프리셋
oh-my-openclaw apply dev-setup

# 프로덕션용 프리셋
oh-my-openclaw apply prod-setup

2. 팀 설정 공유

# 팀 프리셋 저장소에서
oh-my-openclaw apply myteam/agent-preset

3. 실험적 설정

# 새 설정 실험
oh-my-openclaw apply experimental-features --dry-run
oh-my-openclaw apply experimental-features

# 문제 시 롤백
oh-my-openclaw apply previous-setup

마치며: 설정을 코드처럼

oh-my-openclaw는 OpenClaw 설정을 “코드처럼” 다루게 한다.

• 버전 관리: 프리셋으로 설정 스냅샷
• 재사용: 한 번 만들고 어디서든 적용
• 공유: GitHub로 팀과 커뮤니티에 배포
• 안전: 자동 백업으로 언제든 복구

OpenClaw를 여러 용도로 쓰는 사용자라면, oh-my-openclaw는 필수 도구다.

🔗 관련 정보

• GitHub: https://github.com/minpeter/oh-my-openclaw
• 설치 가이드: setup.md
• OpenClaw: https://github.com/openclaw/openclaw
• 작성자: minpeter
• 라이선스: MIT

💡 관련 프로젝트: oh-my-openclaw (OmOC) — happycastle114의 멀티 에이전트 오케스트레이션 플러그인. 이름은 같지만 다른 프로젝트입니다.