Sign In

CLI 명령어

Clawdbot의 모든 CLI 명령어와 사용법

📋 명령어 목록

명령
설명
카테고리
gateway
Gateway 데몬 제어
운영
agent
에이전트 직접 실행
에이전트
send
메시지 전송
채팅
onboard
온보딩 위저드
설정
doctor
시스템 진단
진단
status
상태 확인
상태
channels
채널 관리
채널
config
설정 관리
설정
skills
스킬 관리
스킬
logs
로그 조회
로깅
memory
메모리 관리
메모리
sessions
세션 관리
세션
plugins
플러그인 관리
플러그인
pairing
페어링 관리
보안
approvals
승인 관리
보안
health
건강 체크
진단
reset
시스템 리셋
유지보수

🚀 Gateway 명령어

clawdbot gateway start

# Gateway 데몬 시작 clawdbot gateway start # 포그라운드로 실행 clawdbot gateway start --background # 로그 디렉토리 지정 clawdbot gateway start --log-dir ~/logs

clawdbot gateway stop

# Gateway 데몬 중지 clawdbot gateway stop # 강제 중지 clawdbot gateway stop --force

clawdbot gateway restart

# Gateway 데몬 재시작 clawdbot gateway restart

clawdbot gateway run

# 포그라운드로 실행 (개발용) clawdbot gateway run # 상세 로그 출력 clawdbot gateway run --verbose # 디버그 모드 clawdbot gateway run --debug # 포트 지정 clawdbot gateway run --port 18790 # 바인드 주소 지정 clawdbot gateway run --bind 0.0.0.0 # Tailscale Serve 모드 clawdbot gateway run --tailscale serve

🤖 에이전트 명령어

clawdbot agent

# 기본 실행 (메시지 입력) clawdbot agent # 메시지 직접 지정 clawdbot agent --message "안녕하세요!" # 사고 레벨 지정 clawdbot agent --thinking high # 모델 지정 clawdbot agent --model anthropic/claude-opus-4-5 # 워크스페이스 지정 clawdbot agent --workspace ~/clawd-personal # JSON 출력 clawdbot agent --json # 스트리밍 출력 clawdbot agent --stream

clawdbot agents add

# 새로운 에이전트 추가 clawdbot agents add personal \ --workspace ~/clawd-personal \ --model anthropic/claude-sonnet-4-5 \ --thinking medium # 에이전트 설명 clawdbot agents add work \ --workspace ~/clawd-work \ --model openai/gpt-5.1 \ --thinking low \ --description "Work용 에이전트"

clawdbot agents list

# 모든 에이전트 목록 clawdbot agents list # JSON 출력 clawdbot agents list --json # 워크스페이스만 표시 clawdbot agents list --workspaces

📨 전송 명령어

clawdbot send

# 기본 사용 (대화형) clawdbot send # 채널 및 수신자 지정 clawdbot send --to whatsapp:+1234567890 \ --message "테스트 메시지" # 멘션으로 그룹 전송 clawdbot send --to discord:server:123456789 \ --message "@username 이 작업을 해줘" # 첨부 파일 clawdbot send --to telegram:@username \ --message "파일 첨부" \ --attach ~/Downloads/file.pdf # 리플 지정 clawdbot send --to slack:channel:U1234567890 \ --message "답변입니다" \ --reply-to msg-id

⚙ 설정 명령어

clawdbot config get

# 모든 설정 조회 clawdbot config get # 특정 설정 조회 clawdbot config get agent.model # 중첩 설정 조회 clawdbot config get channels.whatsapp.enabled # 스키마 조회 clawdbot config get --schema

clawdbot config set

# 설정 변경 clawdbot config set agent.model "anthropic/claude-opus-4-5" # 중첩 설정 변경 clawdbot config set channels.whatsapp.dmPolicy "open" # 복수 설정 변경 clawdbot config set gateway.auth.mode password # 설정 삭제 clawdbot config set channels.whatsapp.dmPolicy null

clawdbot config edit

# 설정 편집기 열기 clawdbot config edit # 특정 파일 편집 clawdbot config edit channels

📱 채널 명령어

clawdbot channels login

# WhatsApp 로그인 clawdbot channels login whatsapp # QR 코드 가져오기 clawdbot channels login whatsapp --qr-import # Telegram 로그인 clawdbot channels login telegram # Slack 로그인 clawdbot channels login slack # Discord 로그인 clawdbot channels login discord # Google Chat 로그인 clawdbot channels login googlechat

clawdbot channels status

# 채널 상태 확인 clawdbot channels status # 특정 채널 상태 clawdbot channels status whatsapp # 채널 탐색 clawdbot channels status --probe # JSON 출력 clawdbot channels status --json

clawdbot channels logout

# 채널 로그아웃 clawdbot channels logout whatsapp # 모든 채널 로그아웃 clawdbot channels logout --all

🎯 스킬 명령어

clawdbot skills list

# 설치된 스킬 목록 clawdbot skills list # 사용 가능한 스킬 검색 clawdbot skills list --search notion # 설치되지 않은 스킬 표시 clawdbot skills list --uninstalled

clawdbot skills install

# 스킬 설치 clawdbot skills install notion # 특정 버전 설치 clawdbot skills install notion@1.2.0 # 개발 모드로 설치 clawdbot skills install --dev /path/to/skill # GitHub에서 설치 clawdbot skills install github:user/repo

clawdbot skills remove

# 스킬 제거 clawdbot skills remove notion # 강제 제거 clawdbot skills remove notion --force

📊 상태 명령어

clawdbot status

# 전체 상태 확인 clawdbot status # 채널 상태만 clawdbot status --channels # 에이전트 상태만 clawdbot status --agent # 세션 상태만 clawdbot status --sessions # JSON 출력 clawdbot status --json # 심플 출력 clawdbot status --simple
예시 출력:
🦞 Clawdbot Status Gateway: Status: Running Uptime: 2h 34m Port: 18789 Channels: WhatsApp: ✅ Connected (+1234567890) Telegram: ✅ Connected (@clawdbot_bot) Slack: ❌ Disconnected Discord: ✅ Connected (server) Agent: Model: anthropic/claude-opus-4-5 Status: Ready Active Sessions: 3

🔍 진단 명령어

clawdbot doctor

# 기본 진단 clawdbot doctor # 자동 수정 시도 clawdbot doctor --fix # 상세한 진단 clawdbot doctor --verbose # 특정 카테고리만 clawdbot doctor --only channels # 카테고리 제외 clawdbot doctor --except dependencies
진단 카테고리:
카테고리
검사 항목
dependencies
Node.js, pnpm, 필수 의존성
channels
채널 연결 상태
agent
에이전트 런타임 상태
gateway
Gateway 실행 상태
browser
브라우저 설치 상태
workspace
워크스페이스 구조
config
설정 파일 상태
sandbox
샌드박스 설치 상태

📝 로그 명령어

clawdbot logs

# 모든 로그 추적 clawdbot logs # Gateway 로그만 clawdbot logs gateway # 에이전트 로그만 clawdbot logs agent # 특정 세션 로그 clawdbot logs sessions --session whatsapp:+1234567890 # 실시간 로그 추적 clawdbot logs --follow # 마지막 N줄만 clawdbot logs --tail 100 # 오류만 필터 clawdbot logs --filter error # JSON 출력 clawdbot logs --json

🔒 보안 명령어

clawdbot pairing approve

# 페어링 승인 clawdbot pairing approve whatsapp pairing-code-ABC123 # 페어링 목록 clawdbot pairing list # 페어링 거부 clawdbot pairing deny whatsapp +9876543210 # 모든 페어링 청소 clawdbot pairing clear

clawdbot approvals list

# 보류 중인 승인 목록 clawdbot approvals list # 특정 세션의 승인 목록 clawdbot approvals list --session whatsapp:+1234567890 # 모두 승인 clawdbot approvals approve --all # 모두 거부 clawdbot approvals deny --all

🔄 리셋 명령어

clawdbot reset

# 모든 리셋 clawdbot reset # 채널만 리셋 clawdbot reset --channels # 에이전트만 리셋 clawdbot reset --agent # 세션만 리셋 clawdbot reset --sessions # 특정 세션만 리셋 clawdbot reset --sessions whatsapp:+1234567890 # 확인 없이 강제 리셋 clawdbot reset --force

📱 채널별 명령어

WhatsApp

# WhatsApp QR 코드 재생성 clawdbot channels whatsapp regenerate-qr # 연결 해제 clawdbot channels whatsapp disconnect # 연결 상태 확인 clawdbot channels whatsapp status

Telegram

# Telegram Bot 설정 업데이트 clawdbot channels telegram set-webhook # 인라인 모드 활성화 clawdbot channels telegram set-inline # 업데이트 허용 목록 clawdbot channels telegram update-allowlist

Discord

# Discord 서버 목록 clawdbot channels discord servers # 특정 서버 정보 clawdbot channels discord server-info 1234567890123456789 # 채널 목록 clawdbot channels discord channels # 역할 관리 clawdbot channels discord roles

🔗 관련 문서