주요 명령어 상세 가이드

가장 자주 사용되는 핵심 명령어들의 상세 옵션과 활용 예시입니다.

---

1. onboard

OpenClaw를 처음 설치했거나 새로운 서버에 연결할 때 사용하는 마법사입니다.

• 전체 설정: openclaw onboard
• 빠른 시작: openclaw onboard --flow quickstart (최소한의 질문으로 즉시 설정)
• 원격 연결: openclaw onboard --mode remote --remote-url ws://<ip>:18789 (이미 실행 중인 다른 서버에 연결)

2. gateway

모든 통신의 중심인 게이트웨이 프로세스를 관리합니다.

• 실행: openclaw gateway run
• 상태 확인: openclaw gateway status
• 포트 지정: openclaw gateway run --port 18789

3. configure

인증 정보나 에이전트 행동 지침을 수정합니다.

• 대화형 수정: openclaw configure
• 특정 섹션 바로가기: openclaw configure --section models
• 직접 값 설정: openclaw configure set providers.anthropic.apiKey "..."

4. status & doctor

시스템의 건강 상태를 확인하고 고치는 도구입니다.

• 전체 상태: openclaw status --all
• 심층 진단: openclaw status --deep (API 연결 상태까지 확인)
• 자동 복구: openclaw doctor --repair (권한 문제나 누락된 폴더를 자동 수정)

5. logs

에이전트가 무슨 생각을 하는지, 게이트웨이에 어떤 메시지가 오가는지 실시간으로 확인합니다.

• 실시간 추적: openclaw logs -f
• JSON 출력: openclaw logs --json (프로그래밍 방식으로 로그 분석 시 유용)

6. message

UI 없이 터미널에서 직접 메시징 채널로 명령을 보냅니다.

• 메시지 전송: openclaw message send --channel discord --target "#general" "안녕하세요!"
• 이모지 반응: openclaw message react --channel slack --target "msg_id" --emoji "white_check_mark"

7. agents & sessions

• 에이전트 목록: openclaw agents list
• 세션 내역 조회: openclaw sessions --active 60 (최근 1시간 내 활성 세션 표시)