Webhook 개요
Webhook은 OpenClaw과 외부 플랫폼 간 통신의 핵심 메커니즘입니다. 채널 플랫폼(Telegram, Discord 등)은 Webhook을 통해 사용자 메시지를 OpenClaw에 푸시하고, OpenClaw도 아웃바운드 Webhook을 통해 이벤트를 외부 시스템에 푸시할 수 있습니다.
Webhook 목록 조회
openclaw webhooks list
인바운드 Webhook 설정
openclaw webhooks set-inbound telegram \
--url "https://gateway.example.com/webhook/telegram" \
--verify-signature
아웃바운드 Webhook 생성
openclaw webhooks create event-logger \
--url "https://log.example.com/events" \
--events message.received,message.sent,error \
--secret "webhook-signing-secret"
사용 가능한 이벤트 유형: message.received, message.sent, message.error, channel.connected, channel.disconnected, agent.switched, system.started, system.stopped
재시도 전략
{
"webhooks": {
"outbound": {
"event-logger": {
"url": "https://log.example.com/events",
"retries": 3,
"retryDelay": 5000,
"timeout": 10000,
"retryStatusCodes": [500, 502, 503, 504]
}
}
}
}
일시정지 및 재개
openclaw webhooks pause event-logger
openclaw webhooks resume event-logger
정리
Webhook 시스템은 OpenClaw과 외부 세계를 연결하는 다리입니다. 인바운드 Webhook은 채널 메시지를 수신하고, 아웃바운드 Webhook은 이벤트를 외부 시스템에 푸시합니다. 재시도 전략과 서명 검증을 적절히 설정하면 메시지 전달의 신뢰성과 보안성을 보장할 수 있습니다.