​

투표 (Polls)

​

지원 채널

• Telegram: 네이티브 투표 기능 지원.
• WhatsApp: 웹 채널 기반 네이티브 투표 기능 지원.
• Discord: 명령어 기반 투표 생성 지원.
• MS Teams: 어댑티브 카드(Adaptive Cards)를 활용한 투표 구현.

​

CLI 사용법

# Telegram
openclaw message poll --channel telegram --target 123456789 \
  --poll-question "Ship it?" --poll-option "Yes" --poll-option "No"
openclaw message poll --channel telegram --target -1001234567890:topic:42 \
  --poll-question "Pick a time" --poll-option "10am" --poll-option "2pm" \
  --poll-duration-seconds 300

# WhatsApp
openclaw message poll --target +15555550123 \
  --poll-question "Lunch today?" --poll-option "Yes" --poll-option "No" --poll-option "Maybe"
openclaw message poll --target 123456789@g.us \
  --poll-question "Meeting time?" --poll-option "10am" --poll-option "2pm" --poll-option "4pm" --poll-multi

# Discord
openclaw message poll --channel discord --target channel:123456789 \
  --poll-question "Snack?" --poll-option "Pizza" --poll-option "Sushi"
openclaw message poll --channel discord --target channel:123456789 \
  --poll-question "Plan?" --poll-option "A" --poll-option "B" --poll-duration-hours 48

# MS Teams
openclaw message poll --channel msteams --target conversation:19:abc@thread.tacv2 \
  --poll-question "Lunch?" --poll-option "Pizza" --poll-option "Sushi"

​

주요 옵션

• --channel: whatsapp (기본값), telegram, discord, msteams 중 선택.
• --poll-multi: 사용자가 여러 보기를 동시에 선택할 수 있도록 허용함.
• --poll-duration-hours: (Discord 전용) 투표 유지 시간 지정 (기본값: 24시간).
• --poll-duration-seconds: (Telegram 전용) 투표 유지 시간 지정 (5~600초 사이).
• --poll-anonymous / --poll-public: (Telegram 전용) 투표 결과 공개 여부 설정.

​

Gateway RPC 명세

• to: (문자열, 필수) 수신 대상 ID.
• question: (문자열, 필수) 투표 질문 내용.
• options: (문자열 배열, 필수) 투표 보기 목록.
• maxSelections: (숫자, 선택) 최대 선택 가능 개수.
• durationHours: (숫자, 선택) 유지 시간 (시간).
• durationSeconds: (숫자, 선택, Telegram 전용) 유지 시간 (초).
• isAnonymous: (불리언, 선택, Telegram 전용) 익명 투표 여부.
• channel: (문자열, 선택, 기본값: whatsapp) 대상 채널.
• idempotencyKey: (문자열, 필수) 중복 생성 방지를 위한 멱등성 키.

​

채널별 동작 차이점

• Telegram: 보기(Options)는 210개까지 가능함. threadId 또는 :topic: 형식을 통해 포럼 주제를 지원함. 유지 시간은 초 단위(durationSeconds)로만 설정 가능하며 5600초 사이로 제한됨. 익명 및 공개 투표 모드를 모두 지원함.
• WhatsApp: 보기는 2~12개까지 가능함. maxSelections 값은 보기 총합 이내여야 함. 유지 시간 설정은 무시됨.
• Discord: 보기는 210개까지 가능함. 유지 시간은 1768시간 사이로 자동 조정(Clamp)되며 기본값은 24시간임. maxSelections > 1 설정 시 다중 선택이 활성화되나, 정확한 개수 제한 기능은 지원하지 않음.
• MS Teams: OpenClaw가 직접 관리하는 어댑티브 카드(Adaptive Card) 형태로 렌더링됨. 네이티브 투표 API를 사용하지 않으므로 유지 시간 설정은 적용되지 않음.

​

에이전트 도구 (Message)

• Discord: “정확히 N개 선택” 모드를 지원하지 않으므로 pollMulti 설정 시 일반 다중 선택 모드로 동작함.
• MS Teams: 투표 데이터는 Gateway 서버의 ~/.openclaw/msteams-polls.json 파일에 실시간으로 기록됨. 따라서 투표가 진행되는 동안 Gateway 서버가 상시 가동 중이어야 함.