부록 A. 명령어 치트시트

OpenClaw CLI는 대체로 openclaw <영역> <동작> 패턴으로 움직인다. 한 번 이 문법에 익숙해지면, 모르는 명령도 꽤 높은 확률로 맞혀낼 수 있다. 채널은 channels, 모델은 models, 스케줄은 cron, 상태 점검은 status와 doctor다. 이 부록은 그중에서도 실제 운영 중 가장 자주 손이 가는 명령만 골라 담았다.¹

가장 먼저 외울 15개

급할 때는 이 표만 봐도 된다. 설치 직후, 채널이 잠잠할 때, 스킬이 말을 안 들을 때, 대개 여기서 해결의 실마리가 나온다.⁶

설치와 첫 실행

공식 설치 경로는 설치 스크립트나 npm 글로벌 설치다. 최근 문서 기준으로 Node 22.14+ 이상이 필요하고, 가능하면 최신 권장 버전을 쓰는 편이 덜 삐걱거린다. Windows는 네이티브보다 WSL2 경로가 더 안정적으로 권장된다.²³

# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

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

# Node를 직접 관리 중이라면
npm install -g openclaw@latest
openclaw onboard --install-daemon

설치가 끝났으면 세 가지만 확인하면 된다.

openclaw --version
openclaw doctor
openclaw gateway status

Windows에서 WSL2로 가는 가장 짧은 길은 이렇다.³

wsl --install -d Ubuntu-24.04

그다음 WSL 안에서 OpenClaw를 설치하고, 서비스 자동 시작이 필요하면 온보딩 중 --install-daemon을 쓰면 된다. WSL에서 게이트웨이 서비스를 제대로 돌리려면 systemd 활성화가 필요한 경우가 많다.³

Gateway 관리

Gateway는 OpenClaw의 본체다. 채널도, 스킬도, 대시보드도 결국 이 문을 통과한다. 그래서 이상할 때는 감정적으로 추리하지 말고, 먼저 Gateway부터 본다. "에이전트가 멍하니 있다"는 말은 종종 "게이트웨이가 죽어 있다"의 우아한 표현이다.

가장 자주 쓰는 조합은 보통 이 셋이다.

openclaw gateway status
openclaw logs --follow
openclaw gateway restart

설정과 모델

OpenClaw 설정은 보통 ~/.openclaw/openclaw.json에 모여 있다. 손으로 편집해도 되지만, 빠른 확인은 CLI가 편하다. 설정을 바꿨으면 저장으로 끝이 아니라, 거의 항상 gateway restart까지 해야 반영된다.¹²

설정 파일 다루기

자주 쓰는 예시는 이 정도다.

openclaw config get gateway.port
openclaw config get agent.workspace
openclaw config set gateway.bind loopback
openclaw config validate
openclaw gateway restart

모델과 인증

복붙용 예시는 이렇다.

openclaw models list --provider anthropic
openclaw models auth add
openclaw models set anthropic/claude-sonnet-4-6
openclaw models status --probe

채널 연결과 테스트

메신저가 붙지 않으면 OpenClaw는 똑똑한데 입이 없는 상태가 된다. 텔레그램은 토큰 기반이라 가장 빠르고, WhatsApp은 로그인 흐름이 따로 있다.⁶

처음 연결 후 페어링 승인이 필요한 경우도 있다. 그럴 땐 페어링 대기 목록부터 본다.¹

openclaw pairing list
openclaw pairing approve <requestId>

디바이스 페어링을 쓰는 환경이라면 이쪽도 함께 기억해두면 좋다.

openclaw devices list
openclaw devices approve <requestId>
openclaw devices revoke <deviceId>

스킬 관리

요즘 문서 기준으로 스킬 검색·설치·업데이트는 openclaw skills ... 계열로 다룰 수 있다. 예전 글이나 커뮤니티 자료에서 clawhub나 npx clawhub를 보더라도 놀라지 말자. 시대가 조금 다른 것이다. 중요한 건 현재 워크스페이스에 어떤 스킬이 보이고, 요구사항이 충족되며, 실제로 로드되느냐다.⁴

또 한 가지. 스킬 로더는 감시 모드와 우선순위 규칙을 가진다. 즉, 스킬을 넣었다고 무조건 원하는 버전이 잡히는 게 아니다. 워크스페이스 경로, 사용자 전역 경로, 번들 스킬 중 누가 우선인지 항상 의식해야 한다.⁵

복붙용 흐름은 이렇다.

openclaw skills search "gmail"
openclaw skills install gmail
openclaw skills check
openclaw skills list --eligible

스킬이 방금 설치됐는데도 안 보이면 두 가지를 본다. 첫째, 감시 모드가 켜져 있는지. 둘째, 재시작이 필요한 상태인지다.⁵

openclaw config get skills.load.watch
openclaw skills list
openclaw gateway restart

상태, 로그, 메모리

이 장은 운영자의 생존 본능과 직결된다. 이상하다 싶을 때 로그를 안 보면, 어두운 방에서 레고를 발로 찾는 기분을 오래 즐기게 된다.

가장 현실적인 디버깅 루틴은 이렇다.

openclaw status --deep
openclaw channels status --probe
openclaw models status --probe
openclaw logs --follow

자동화: cron과 heartbeat

cron은 시계처럼 정확한 반복 작업에 좋고, heartbeat는 에이전트가 주기적으로 스스로 점검하게 만들 때 좋다. 하나는 알람시계이고, 다른 하나는 부지런한 비서다.

cron 기본 명령

가장 자주 쓰는 예시는 두 가지다.

# 평일 오전 9시 브리핑
openclaw cron add --name "daily-brief" --cron "0 9 * * 1-5" --message "오늘의 이메일, 일정, 우선순위 할 일을 요약해줘"

# 매시간 체크
openclaw cron add --name "hourly-check" --every 3600000 --message "새 메시지와 급한 이슈가 있는지 점검해줘"

heartbeat 기본 명령

openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system heartbeat disable

시스템 이벤트로 바로 찌르기

openclaw system event --text "지금 인박스 정리 시작"
openclaw system event --text "오늘 주간보고 초안 생성" --mode now

업데이트, 백업, 복구

운영은 설치보다 길다. 그러니 업데이트와 백업 명령을 반드시 손에 익혀둬야 한다. 특히 워크스페이스 파일은 에이전트의 성격, 기억, 습관이 담긴 뇌 조직에 가깝다.

# 업데이트 상태
openclaw update status

# 업데이트 미리보기
openclaw update --dry-run

# 업데이트 마법사
openclaw update wizard

# 백업 생성
openclaw backup create

# 백업 검증
openclaw backup verify <archive>

# 설정만 초기화
openclaw reset --scope config --yes

# 완전 제거
openclaw uninstall

설정을 싹 밀기 전에, 정말 싹 밀고 싶은 게 맞는지 한 번만 더 생각하자. 대개는 doctor, config validate, gateway restart로 끝난다. 운영자는 포맷보다 복구를 먼저 떠올리는 사람이 오래 산다.

상황별 즉시 처방

실전 복붙 세트

1. 새 머신에서 5분 안에 띄우기

npm install -g openclaw@latest
openclaw onboard --install-daemon
openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboard

2. 텔레그램 연결 직후 점검하기

openclaw channels list
openclaw channels status --probe
openclaw message send --channel telegram --account default --text "연결 테스트"
openclaw logs --follow

3. 새 스킬 붙이고 살아 있는지 보기

openclaw skills search "notion"
openclaw skills install notion
openclaw skills check
openclaw skills list --eligible
openclaw gateway restart

4. 아침 브리핑 자동화 만들기

openclaw cron add --name "morning-brief" --cron "0 9 * * 1-5" --message "이메일, 일정, 할 일을 요약해서 보내줘"
openclaw cron list --all
openclaw cron runs --id <id> --limit 10

5. 문제 생겼을 때 가장 안전한 디버깅 루틴

openclaw doctor
openclaw status --deep
openclaw models status --probe
openclaw channels status --probe
openclaw logs --follow

외우면 편한 운영 습관

세 가지만 몸에 익히면 운영 난이도가 눈에 띄게 내려간다.

• 설정을 바꾼 뒤에는 반사적으로 openclaw config validate와 openclaw gateway restart를 실행한다.

• 채널 문제는 감으로 만지지 말고 channels status --probe와 채널 로그로 본다.

• 스킬 문제는 설치보다 skills check, 우선순위, 재시작 여부를 먼저 의심한다.

커맨드를 전부 기억할 필요는 없다. 자주 쓰는 몇 개를 손에 익히고, 나머지는 이 부록으로 돌아오면 된다. 좋은 운영자는 모든 명령을 외운 사람이 아니라, 문제를 만났을 때 어느 명령부터 칠지 아는 사람이다.

참고

¹CLI reference - OpenClaw

²Install - OpenClaw

³Windows (WSL2) | OpenClaw Docs

⁴Manage OpenClaw Skills: List and Validate Requirements

⁵Skills config - OpenClaw

⁶OpenClaw Cheatsheet — Core Commands & Quick Reference