Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw crestodian
Crestodian은 OpenClaw의 로컬 설정, 복구, 구성 도우미입니다. 일반 에이전트 경로가 고장 난 경우에도 접근 가능한 상태를 유지하도록 설계되었습니다.
명령 없이 openclaw를 실행하면 대화형 터미널에서 Crestodian이 시작됩니다.
openclaw crestodian을 실행하면 같은 도우미를 명시적으로 시작합니다.
Crestodian이 표시하는 내용
시작 시 대화형 Crestodian은openclaw tui에서 사용하는 것과 같은 TUI 셸을 Crestodian 채팅 백엔드와 함께 엽니다. 채팅 로그는 짧은 인사말로 시작합니다.
- Crestodian을 시작해야 하는 경우
- Crestodian이 실제로 사용하는 모델 또는 결정적 플래너 경로
- 구성 유효성과 기본 에이전트
- 첫 시작 프로브의 Gateway 도달 가능성
- Crestodian이 수행할 수 있는 다음 디버그 작업
status를 사용하세요.
Crestodian은 일반 에이전트와 같은 OpenClaw 참조 검색을 사용합니다. Git 체크아웃에서는 로컬 docs/와 로컬 소스 트리를 가리킵니다. npm 패키지 설치에서는 번들 패키지 문서를 사용하고 https://github.com/openclaw/openclaw에 연결하며, 문서만으로 충분하지 않을 때는 소스를 검토하라는 명시적 안내를 제공합니다.
예시
안전한 시작
Crestodian의 시작 경로는 의도적으로 작게 유지됩니다. 다음 상황에서도 실행할 수 있습니다.openclaw.json이 없음openclaw.json이 유효하지 않음- Gateway가 중단됨
- Plugin 명령 등록을 사용할 수 없음
- 아직 구성된 에이전트가 없음
openclaw --help와 openclaw --version은 여전히 일반 빠른 경로를 사용합니다. 비대화형 openclaw는 루트 도움말을 출력하는 대신 짧은 메시지와 함께 종료됩니다. 명령 없는 제품은 Crestodian이기 때문입니다.
작업 및 승인
Crestodian은 구성을 임의로 편집하는 대신 형식화된 작업을 사용합니다. 읽기 전용 작업은 즉시 실행할 수 있습니다.- 개요 표시
- 에이전트 목록
- 설치된 Plugin 목록
- ClawHub Plugin 검색
- 모델/백엔드 상태 표시
- 상태 또는 상태 검사 실행
- Gateway 도달 가능성 확인
- 대화형 수정 없이 doctor 실행
- 구성 검증
- 감사 로그 경로 표시
--yes를 전달하지 않는 한, 영구 작업은 대화형 모드에서 대화식 승인이 필요합니다.
- 구성 쓰기
config set실행config set-ref를 통해 지원되는 SecretRef 값 설정- 설정/온보딩 부트스트랩 실행
- 기본 모델 변경
- Gateway 시작, 중지 또는 재시작
- 에이전트 생성
- ClawHub 또는 npm에서 Plugin 설치
- Plugin 제거
- 구성 또는 상태를 다시 쓰는 doctor 복구 실행
openclaw onboard --modern은 현대식 온보딩 미리보기로 Crestodian을 시작합니다. 일반 openclaw onboard는 여전히 클래식 온보딩을 실행합니다.
설정 부트스트랩
setup은 채팅 우선 온보딩 부트스트랩입니다. 형식화된 구성 작업을 통해서만 쓰며, 먼저 승인을 요청합니다.
- 이미 구성된 경우 기존 명시적 모델
OPENAI_API_KEY->openai/gpt-5.5ANTHROPIC_API_KEY->anthropic/claude-opus-4-7- Claude Code CLI ->
claude-cli/claude-opus-4-7 - Codex CLI ->
codex-cli/gpt-5.5
OPENAI_API_KEY/ANTHROPIC_API_KEY를 노출한 다음 setup을 다시 실행하세요.
모델 지원 플래너
Crestodian은 항상 결정적 모드에서 시작합니다. 결정적 파서가 이해하지 못하는 모호한 명령의 경우, 로컬 Crestodian은 OpenClaw의 일반 런타임 경로를 통해 제한된 플래너 턴 하나를 만들 수 있습니다. 먼저 구성된 OpenClaw 모델을 사용합니다. 아직 사용 가능한 구성 모델이 없으면 머신에 이미 있는 로컬 런타임으로 폴백할 수 있습니다.- Claude Code CLI:
claude-cli/claude-opus-4-7 - Codex app-server 하네스:
openai/gpt-5.5 - Codex CLI:
codex-cli/gpt-5.5
에이전트로 전환
Crestodian을 떠나 일반 TUI를 열려면 자연어 선택기를 사용하세요.openclaw tui, openclaw chat, openclaw terminal은 여전히 일반 에이전트 TUI를 직접 엽니다. Crestodian을 시작하지 않습니다.
일반 TUI로 전환한 뒤에는 /crestodian을 사용해 Crestodian으로 돌아갈 수 있습니다. 후속 요청을 포함할 수 있습니다.
/crestodian을 사용할 수 있다는 이동 경로를 남깁니다.
메시지 구조 모드
메시지 구조 모드는 Crestodian의 메시지 채널 진입점입니다. 일반 에이전트가 죽었지만 WhatsApp 같은 신뢰할 수 있는 채널은 여전히 명령을 받는 경우를 위한 것입니다. 지원되는 텍스트 명령:/crestodian <request>
- 샌드박싱이 활성화되어 있으면 비활성화됩니다. 에이전트/세션이 샌드박스 처리된 경우 Crestodian은 원격 구조를 거부하고 로컬 CLI 복구가 필요하다고 설명해야 합니다.
- 기본 유효 상태는
auto입니다. 런타임에 이미 샌드박스 없는 로컬 권한이 있는 신뢰된 YOLO 작업에서만 원격 구조를 허용합니다. - 명시적 소유자 신원이 필요합니다. 구조는 와일드카드 발신자 규칙, 공개 그룹 정책, 인증되지 않은 Webhook 또는 익명 채널을 허용해서는 안 됩니다.
- 기본적으로 소유자 DM만 허용합니다. 그룹/채널 구조에는 명시적 옵트인이 필요합니다.
- Plugin 검색과 목록은 읽기 전용입니다. Plugin 설치는 실행 가능한 코드를 다운로드하므로 기본적으로 로컬 전용입니다. 구조 정책이 영구 쓰기를 허용하는 경우 Plugin 제거는 승인된 복구 작업으로 허용될 수 있습니다.
- 원격 구조는 로컬 TUI를 열거나 대화형 에이전트 세션으로 전환할 수 없습니다. 에이전트 인계에는 로컬
openclaw를 사용하세요. - 영구 쓰기는 구조 모드에서도 여전히 승인이 필요합니다.
- 적용된 모든 구조 작업을 감사합니다. 메시지 채널 구조는 채널, 계정, 발신자, 소스 주소 메타데이터를 기록합니다. 구성 변경 작업은 변경 전후의 구성 해시도 기록합니다.
- 비밀 값을 절대 반향하지 마세요. SecretRef 검사는 값이 아니라 사용 가능 여부를 보고해야 합니다.
- Gateway가 살아 있으면 Gateway 형식화된 작업을 선호하세요. Gateway가 죽었으면 일반 에이전트 루프에 의존하지 않는 최소한의 로컬 복구 표면만 사용하세요.
enabled가 허용해야 하는 값:
"auto": 기본값입니다. 유효 런타임이 YOLO이고 샌드박싱이 꺼져 있을 때만 허용합니다.false: 메시지 채널 구조를 절대 허용하지 않습니다.true: 소유자/채널 검사를 통과하면 구조를 명시적으로 허용합니다. 그래도 샌드박싱 거부를 우회해서는 안 됩니다.
"auto" YOLO 태세:
- 샌드박스 모드가
off로 해석됨 tools.exec.security가full로 해석됨tools.exec.ask가off로 해석됨
/crestodian status를 확인합니다.
openclaw를 Crestodian으로 라우팅하고, 기본 모델을 설정하고, 추가 에이전트를 생성하고, Plugin 활성화와 토큰 SecretRef를 통해 Discord를 구성하고, 구성을 검증하고, 감사 로그를 확인합니다. QA Lab에도 같은 Ring 0 흐름에 대한 저장소 기반 시나리오가 있습니다.