명령 개요
openclaw channels는 OpenClaw 메시지 채널을 관리하는 핵심 명령으로, 채널의 추가, 삭제, 수정, 조회, 상태 모니터링 및 장애 진단을 지원합니다.
채널 목록 조회
openclaw channels list
출력:
Channels:
telegram-main Telegram ✓ Connected Agent: default
discord-dev Discord ✓ Connected Agent: code-expert
whatsapp-cs WhatsApp ✗ Disconnected Agent: customer-svc
webchat Web Chat ✓ Active Agent: default
채널 추가
대화형 추가
openclaw channels add
Add New Channel
===============
Channel type:
[1] Telegram
[2] Discord
[3] WhatsApp
[4] Slack
[5] Web Chat
[6] Matrix
[7] Signal
> 1
Channel name [telegram-default]: telegram-main
Bot token: 123456:ABC-DEF...
Testing connection... ✓ Connected!
Bot name: @my_openclaw_bot
Configure webhook? [Y/n] Y
Webhook URL: https://gateway.example.com/webhook/telegram-main
Setting webhook... ✓ Done
Agent to assign [default]: default
Channel 'telegram-main' added successfully!
명령줄에서 직접 추가
openclaw channels add telegram-main \
--type telegram \
--token "123456:ABC-DEF" \
--webhook-url "https://gateway.example.com/webhook/telegram-main" \
--agent default
채널 상세 정보 조회
openclaw channels show telegram-main
Channel: telegram-main
Type: Telegram
Status: Connected
Agent: default
Model: gpt-4o-mini
Webhook: https://gateway.example.com/webhook/telegram-main
System Prompt: 당신은 유용한 어시스턴트입니다...
History Limit: 20
Rate Limit: 30 msg/min
Allowed Users: all
Created: 2026-03-01
Last Message: 2 minutes ago
Total Messages: 5,230
채널 설정 수정
# 사용할 에이전트 변경
openclaw channels set telegram-main --agent code-expert
# 시스템 프롬프트 변경
openclaw channels set telegram-main --system-prompt "새로운 프롬프트"
# 대화 기록 제한 변경
openclaw channels set telegram-main --history-limit 50
# 속도 제한 변경
openclaw channels set telegram-main --rate-limit 60
채널 상태 관리
# 채널 일시정지 (메시지 처리 중지)
openclaw channels pause telegram-main
# 채널 재개
openclaw channels resume telegram-main
# 재연결
openclaw channels reconnect whatsapp-cs
채널 삭제
openclaw channels remove telegram-main
채널 진단
openclaw channels diagnose telegram-main
Diagnosing channel: telegram-main
✓ Configuration: valid
✓ Token: valid
✓ Webhook: configured and reachable
✓ Bot permissions: sufficient
✓ Last message: 2 minutes ago
✓ Response time: 1.2s average
채널 통계
openclaw channels stats telegram-main
openclaw channels stats telegram-main --period 7d
Channel Stats: telegram-main (last 7 days)
Messages received: 1,520
Messages sent: 1,480
Avg response time: 1.8s
Unique users: 45
Error rate: 0.5%
Token usage: 250,000
사용자 관리
# 채널 사용자 조회
openclaw channels users telegram-main
# 사용자 차단
openclaw channels block telegram-main --user 12345678
# 사용자 차단 해제
openclaw channels unblock telegram-main --user 12345678
# 화이트리스트 모드 설정
openclaw channels set telegram-main --allowlist-only
openclaw channels allow telegram-main --user 12345678
일괄 작업
# 모든 채널 일시정지
openclaw channels pause --all
# 모든 채널 재개
openclaw channels resume --all
# 채널 설정 내보내기
openclaw channels export channels.json
# 채널 설정 가져오기
openclaw channels import channels.json
Webhook 관리
# webhook 정보 조회
openclaw channels webhook telegram-main
# webhook 재설정
openclaw channels webhook telegram-main --set "https://new-url.com/webhook/telegram"
# webhook 삭제
openclaw channels webhook telegram-main --delete
정리
openclaw channels는 완전한 채널 라이프사이클 관리 기능을 제공합니다. 추가, 설정부터 모니터링, 진단까지 모든 채널 관련 작업을 이 명령 그룹으로 수행할 수 있으며, 일상 운영에서 가장 자주 사용되는 명령 중 하나입니다.