OpenClaw 명령어

여러 메시징 채널과 플랫폼에서 개인 AI 에이전트를 관리하기 위한 종합 OpenClaw 명령어 모음입니다.

설치

플랫폼	명령어
macOS/Linux	`curl -fsSL https://openclaw.ai/install.sh \| bash`
npm (전역)	`npm install -g openclaw`
업데이트	`openclaw update`
확인	`openclaw --version`

설정 및 온보딩

명령어	설명
`openclaw onboard`	게이트웨이, 워크스페이스, 채널, 스킬을 위한 대화형 설정 마법사
`openclaw onboard --install-daemon`	설정 후 게이트웨이를 백그라운드 서비스로 설치
`openclaw onboard --flow quickstart`	합리적인 기본값으로 빠른 설정
`openclaw onboard --flow advanced`	모든 구성 옵션을 포함한 전체 설정
`openclaw onboard --non-interactive`	헤드리스 설정 (명시적 플래그 필요)
`openclaw setup --workspace ~/my-agent`	구성 및 워크스페이스 디렉토리 초기화
`openclaw configure`	모델, 채널, 스킬, 게이트웨이를 위한 대화형 마법사
`openclaw doctor`	구성 및 게이트웨이 상태 점검 및 빠른 수정
`openclaw doctor --deep`	시스템 서비스를 포함한 심층 스캔
`openclaw reset --scope config`	구성만 초기화
`openclaw reset --scope full --yes`	구성, 자격 증명, 세션 전체 초기화

구성

명령어	설명
`openclaw config get <path>`	구성 값 출력
`openclaw config set <path> <value>`	구성 값 설정 (JSON5 또는 원시 문자열)
`openclaw config unset <path>`	구성 값 제거
`openclaw configure`	대화형 구성 마법사 실행

환경 변수

변수	용도
`OPENCLAW_HOME`	기본 홈 디렉토리 재정의
`OPENCLAW_STATE_DIR`	사용자 정의 상태 디렉토리
`OPENCLAW_CONFIG_PATH`	사용자 정의 구성 파일 경로

게이트웨이 관리

명령어	설명
`openclaw gateway run`	포그라운드에서 WebSocket 게이트웨이 실행
`openclaw gateway run --port 18789`	특정 포트에서 게이트웨이 실행
`openclaw gateway run --bind lan`	LAN 인터페이스에 바인딩
`openclaw gateway run --bind tailnet`	Tailscale을 통해 바인딩
`openclaw gateway status`	RPC를 통해 게이트웨이 상태 확인
`openclaw gateway health`	실행 중인 게이트웨이의 상태 조회
`openclaw gateway install`	게이트웨이를 시스템 서비스로 설치
`openclaw gateway start`	설치된 서비스 시작
`openclaw gateway stop`	실행 중인 서비스 중지
`openclaw gateway restart`	서비스 재시작
`openclaw gateway uninstall`	서비스 제거
`openclaw gateway discover`	네트워크에서 게이트웨이 검색
`openclaw logs --follow`	실시간 게이트웨이 로그 추적
`openclaw logs --limit 100 --json`	마지막 100개 로그 항목을 JSON으로 출력

채널 관리

명령어	설명
`openclaw channels list`	구성된 모든 채널 및 인증 프로필 표시
`openclaw channels status`	게이트웨이 접근성 및 채널 상태 확인
`openclaw channels add --channel telegram`	Telegram 채널 추가
`openclaw channels add --channel whatsapp`	WhatsApp 채널 추가
`openclaw channels add --channel discord`	Discord 채널 추가
`openclaw channels add --channel slack`	Slack 채널 추가
`openclaw channels add --channel signal`	Signal 채널 추가
`openclaw channels add --channel imessage`	iMessage 채널 추가
`openclaw channels add --channel msteams`	Microsoft Teams 채널 추가
`openclaw channels remove --channel telegram`	채널 제거
`openclaw channels login --channel discord`	대화형 채널 로그인
`openclaw channels logout --channel telegram`	채널에서 로그아웃
`openclaw channels logs --channel whatsapp`	최근 채널 로그 표시

메시징

명령어	설명
`openclaw message send --text "Hello"`	메시지 보내기
`openclaw message send --to user123 --text "Hi"`	특정 대상에게 메시지 보내기
`openclaw message poll`	새 메시지 폴링
`openclaw message read`	메시지를 읽음으로 표시
`openclaw message edit --text "Updated"`	보낸 메시지 수정
`openclaw message delete`	메시지 삭제
`openclaw message react --emoji "👍"`	메시지에 반응
`openclaw message reactions`	메시지의 반응 목록
`openclaw message search --text "query"`	메시지 검색
`openclaw message pin`	메시지 고정
`openclaw message unpin`	메시지 고정 해제
`openclaw message pins`	고정된 메시지 목록
`openclaw message thread create`	메시지 스레드 생성
`openclaw message thread list`	스레드 목록
`openclaw message thread reply`	스레드에 답글

에이전트 관리

명령어	설명
`openclaw agent --message "Research this topic"`	게이트웨이를 통해 단일 에이전트 턴 실행
`openclaw agent --message "Hello" --thinking high`	확장된 사고 기능으로 에이전트 턴 실행
`openclaw agent --message "task" --local`	로컬에서 에이전트 실행 (내장)
`openclaw agent --message "task" --deliver`	채널로 응답 전달
`openclaw agents list`	구성된 에이전트 목록
`openclaw agents add myagent --workspace ~/work`	워크스페이스가 있는 격리된 에이전트 추가
`openclaw agents add myagent --model claude-sonnet`	특정 모델로 에이전트 추가
`openclaw agents delete myagent --force`	에이전트 삭제

모델 구성

명령어	설명
`openclaw models list`	사용 가능한 모델 목록
`openclaw models list --all`	사용 불가능한 모델을 포함한 모든 모델 목록
`openclaw models list --local`	로컬 모델만 목록
`openclaw models list --provider anthropic`	제공업체별 필터링
`openclaw models status`	토큰 및 인증 상태 표시
`openclaw models status --probe`	인증 프로필 실시간 점검
`openclaw models set claude-sonnet`	기본 모델 설정
`openclaw models set-image dall-e-3`	기본 이미지 모델 설정
`openclaw models scan`	사용 가능한 모델 스캔 및 검색
`openclaw models auth add`	대화형 인증 도우미
`openclaw models auth setup-token --provider openai`	제공업체 토큰 설정
`openclaw models fallbacks add gpt-4o`	대체 모델 추가
`openclaw models fallbacks list`	대체 모델 목록
`openclaw models aliases add sonnet claude-sonnet`	모델 별칭 생성

브라우저 제어

명령어	설명
`openclaw browser start`	제어 브라우저 실행
`openclaw browser stop`	브라우저 종료
`openclaw browser status`	브라우저 상태 확인
`openclaw browser open "https://example.com"`	브라우저에서 URL 열기
`openclaw browser tabs`	열린 탭 목록
`openclaw browser focus <targetId>`	특정 탭으로 포커스
`openclaw browser close <targetId>`	특정 탭 닫기
`openclaw browser screenshot`	뷰포트 스크린샷 촬영
`openclaw browser screenshot --full-page`	전체 페이지 스크린샷
`openclaw browser snapshot --format aria`	접근성 트리 가져오기
`openclaw browser navigate "https://url"`	URL로 이동
`openclaw browser click <ref>`	요소 클릭
`openclaw browser type <ref> "text"`	요소에 텍스트 입력
`openclaw browser press Enter`	키보드 키 누르기
`openclaw browser evaluate --fn "document.title"`	JavaScript 실행
`openclaw browser pdf`	현재 페이지의 PDF 생성
`openclaw browser profiles`	브라우저 프로필 목록
`openclaw browser create-profile --name work`	브라우저 프로필 생성

노드 관리

명령어	설명
`openclaw node run --host gateway.local --port 18789`	헤드리스 노드 실행
`openclaw node install --host gw.local`	노드를 서비스로 설치
`openclaw node status`	노드 상태 확인
`openclaw nodes list`	모든 노드 목록
`openclaw nodes status --connected`	연결된 노드만 표시
`openclaw nodes pending`	대기 중인 승인 요청 표시
`openclaw nodes approve <requestId>`	노드 요청 승인
`openclaw nodes run --node mypc "ls -la"`	원격 노드에서 명령어 실행
`openclaw nodes camera snap --node phone`	카메라 이미지 캡처
`openclaw nodes screen record --node desktop`	화면 녹화
`openclaw nodes location get --node mobile`	기기 위치 가져오기

예약 작업 (Cron)

명령어	설명
`openclaw cron list`	모든 예약 작업 목록
`openclaw cron status`	cron 시스템 상태 표시
`openclaw cron add --name "Daily report" --every 24h --message "Generate daily report"`	반복 작업 추가
`openclaw cron add --name "Morning brief" --at "08:00" --message "Brief me"`	시간 기반 작업 추가
`openclaw cron add --name "Backup" --cron "0 2 * * *" --system-event "run backup"`	cron 표현식 작업 추가
`openclaw cron enable <id>`	작업 활성화
`openclaw cron disable <id>`	작업 비활성화
`openclaw cron run <id>`	작업 즉시 실행
`openclaw cron runs --id <id>`	작업 실행 이력 표시
`openclaw cron edit <id>`	기존 작업 수정
`openclaw cron rm <id>`	작업 삭제

플러그인 및 스킬

명령어	설명
`openclaw plugins list`	사용 가능한 플러그인 검색
`openclaw plugins info <id>`	플러그인 상세 정보 표시
`openclaw plugins install <path>`	경로 또는 npm에서 플러그인 설치
`openclaw plugins enable <id>`	플러그인 활성화
`openclaw plugins disable <id>`	플러그인 비활성화
`openclaw plugins doctor`	플러그인 로드 오류 보고
`openclaw skills list`	사용 가능한 스킬 목록
`openclaw skills list --eligible`	준비된 스킬만 표시
`openclaw skills info <name>`	스킬 상세 정보 표시
`openclaw skills check`	모든 스킬의 준비 상태 요약

보안 및 승인

명령어	설명
`openclaw security audit`	구성 및 로컬 상태 감사
`openclaw security audit --deep`	실시간 게이트웨이 보안 점검
`openclaw security audit --fix`	안전한 기본값 자동 적용
`openclaw approvals get`	현재 승인 설정 보기
`openclaw approvals set`	승인 워크플로 구성
`openclaw approvals allowlist add`	승인 허용 목록에 추가
`openclaw pairing list telegram`	대기 중인 페어링 요청 목록
`openclaw pairing approve telegram <code>`	DM 페어링 승인

메모리 및 세션

명령어	설명
`openclaw memory status`	메모리 인덱스 통계 표시
`openclaw memory index`	메모리 파일 재색인
`openclaw memory search "query"`	메모리에 대한 시맨틱 검색
`openclaw sessions`	저장된 대화 세션 목록
`openclaw sessions --active 60`	최근 60분 내 활성 세션 표시
`openclaw status`	연결된 세션 상태 표시
`openclaw status --all --deep`	채널 점검을 포함한 전체 진단

일반적인 사용 사례

Telegram으로 빠른 설정

# 설치 및 온보딩
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

# Telegram 채널 추가
openclaw channels add --channel telegram

# 모든 것이 작동하는지 확인
openclaw doctor
openclaw status --all

사용자 정의 모델로 에이전트 실행

# 선호 모델 설정
openclaw models set claude-sonnet

# 대체 모델 추가
openclaw models fallbacks add gpt-4o

# 에이전트 턴 실행
openclaw agent --message "Summarize my emails" --thinking high

일일 보고서 예약

# 오전 8시에 일일 작업 생성
openclaw cron add \
  --name "Morning briefing" \
  --at "08:00" \
  --message "Give me a summary of today's tasks and any urgent notifications"

# 예약 확인
openclaw cron list

원격 노드 제어

# 연결된 노드 목록
openclaw nodes status --connected

# 원격 머신에서 명령어 실행
openclaw nodes run --node "desktop" "df -h"

# 원격 화면 스크린샷 촬영
openclaw nodes screen record --node "desktop" --duration 5s

모범 사례

온보딩 시 --install-daemon 사용 — 게이트웨이를 백그라운드 서비스로 실행
openclaw doctor를 정기적으로 실행 — 구성 문제를 조기에 발견
모델 대체 설정 — 기본 모델이 속도 제한될 때 가용성 보장
복잡한 에이전트 작업에 --thinking high 사용 — 심층 추론이 필요한 경우
브라우저 프로필 생성 — 다양한 작업에 대한 브라우징 컨텍스트 격리
스크립팅 시 --json 플래그 사용 — 출력을 다른 도구로 파이핑할 때
게이트웨이를 네트워크에 노출하기 전 --deep 플래그로 보안 감사 실행

문제 해결

문제	해결 방법
게이트웨이가 시작되지 않음	`openclaw doctor --deep`를 실행하여 진단
채널 연결 끊김	`openclaw channels status`로 확인 후 재로그인
모델 인증 실패	`openclaw models status --probe`로 토큰 테스트
플러그인 로드 오류	`openclaw plugins doctor`로 진단 실행
노드 연결 안 됨	`openclaw nodes pending`으로 확인 후 필요 시 승인
느린 응답	`openclaw status --usage`로 속도 제한 확인
구성 손상	`openclaw reset --scope config`로 안전하게 초기화