OpenClaw 치트시트

빠른 시작

설치 + 첫 실행

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw doctor
openclaw status
openclaw health
openclaw dashboard

일상 운영

openclaw doctor
openclaw status --all
openclaw logs --follow

자주 쓰는 슬래시 명령어

/status
/new
/compact
/model
/stop
/think

설치

원라인 설치 (권장)

macOS / Linux

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

온보딩을 건너뛴 경우

openclaw onboard --install-daemon

수동 설치 (Node.js)

npm 또는 pnpm

npm install -g openclaw@latest
# or
pnpm add -g openclaw@latest

openclaw onboard --install-daemon

sharp 빌드 오류 수정

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

시스템 요구 사항

Node >= 22
macOS, Linux 또는 Windows (WSL2)

게이트웨이

게이트웨이 실행

openclaw gateway --port 18789

시스템 서비스로 관리

openclaw gateway service status
openclaw gateway service install
openclaw gateway service start
openclaw gateway service stop
openclaw gateway service restart

게이트웨이 로그

openclaw logs --follow
openclaw logs --limit 200
openclaw logs --plain
openclaw logs --json

채널

WhatsApp 로그인

openclaw channels login
openclaw channels logout

채널 계정 추가

openclaw channels add --channel telegram --account alerts --name "Alerts Bot" --token $TELEGRAM_BOT_TOKEN
openclaw channels add --channel discord --account work --name "Work Bot" --token $DISCORD_BOT_TOKEN

채널 상태

openclaw channels status
openclaw channels status --probe

진단

상태 확인

openclaw doctor
openclaw status
openclaw health --json
openclaw dashboard

심층 진단

openclaw doctor --deep
openclaw status --all
openclaw status --deep

모델 및 인증

모델 목록 및 전환

openclaw models list
openclaw models status
openclaw models set <model>

인증

openclaw models auth add
openclaw models auth setup-token --provider anthropic
openclaw models auth paste-token --provider <provider>

스킬 및 플러그인

스킬

openclaw skills list
openclaw skills info <name>
openclaw skills check

플러그인

openclaw plugins list
openclaw plugins install <path|.tgz|npm-spec>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins doctor

메모리

openclaw memory status
openclaw memory index
openclaw memory search "<query>"

브라우저

브라우저 자동화

openclaw browser status
openclaw browser start
openclaw browser tabs
openclaw browser open https://example.com
openclaw browser snapshot
openclaw browser screenshot

슬래시 명령어

명령어는 Gateway에서 처리됩니다. 대부분 독립된 메시지로 보내야 합니다.

명령어

	상태, 프로바이더 쿼터 표시
	ID 표시 (별칭: /id)
	새 세션 (/new [model])
	컨텍스트 압축
	모델 전환/목록
	현재 실행 중단
	재시작 (commands.restart: true 필요)

디렉티브 (세션 토글)

	사고 강도
	상세 출력
	추론 메시지
	상승 모드
	도구 실행 라우팅

Bash (기본 비활성)

	호스트 셸 실행 (commands.bash: true 필요)
	백그라운드 bash 작업 보기/중지

워크스페이스

워크스페이스는 에이전트의 "홈"으로, 컨텍스트로 읽고 쓰입니다. 상태 디렉토리에는 설정, 자격 증명, 세션, 인덱스가 저장됩니다.

기본 위치

상태 루트 디렉토리
기본 워크스페이스
멀티 프로필
개발 격리

주요 워크스페이스 파일

`AGENTS.md`	에이전트 상위 지시 (행동/목표)
`SOUL.md`	페르소나 (정체성, 톤, 경계)
`USER.md`	사용자 선호/배경
`IDENTITY.md`	ID 정보 (첫 부팅 시 작성)
`TOOLS.md`	현재 머신/스킬 관련 환경 메모
`HEARTBEAT.md`	하트비트 작업 지시 (액티브 모드)
`BOOTSTRAP.md`	첫 실행 Q&A; 설정 후 삭제
`memory/YYYY-MM-DD.md`	일일 메모리 (추가 전용); 오늘+어제 로드
`MEMORY.md`	장기 메모리 (선택; 프라이빗 메인 세션만)

openclaw setup

경로 참조

메인 설정 (state)
자격 증명 (state)
세션 (state)
로그 (기본)
메모리 인덱스 (SQLite)
Cron 작업

Cron 작업

작업은 ~/.openclaw/cron/jobs.json에 저장되며 Gateway 재시작 후에도 유지됩니다. 실행 위치는 'main' (시스템 이벤트) 또는 'isolated' (독립 세션).

Cron 작업 관리

openclaw cron list
openclaw cron status
openclaw cron add --name "Reminder" --at "20m" --session main --system-event "Reminder: ..." --wake now
openclaw cron run <jobId> --force
openclaw cron runs --id <jobId>

문제 해결

DM 응답 없음?

페어링/허용 목록 문제일 가능성이 높음

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <code> --notify

그룹 채팅에서 무응답?

routing.groupChat.mentionPatterns 및 requireMention 설정 확인. /status를 보내 테스트.

게이트웨이 다운?

심층 진단 실행

openclaw doctor --deep
openclaw status --deep

메모리 검색 문제?

인덱스 재구축

openclaw memory index
openclaw memory status