Encuestas

Encuestas

Canales compatibles

• Telegram
• WhatsApp (canal web)
• Discord
• Microsoft Teams (Tarjetas adaptables)

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 [email protected] \
  --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

# Microsoft Teams
openclaw message poll --channel msteams --target conversation:19:[email protected] \
  --poll-question "Lunch?" --poll-option "Pizza" --poll-option "Sushi"

Opciones:

• --channel: whatsapp (predeterminado), telegram, discord o msteams
• --poll-multi: permitir seleccionar múltiples opciones
• --poll-duration-hours: solo para Discord (el valor predeterminado es 24 si se omite)
• --poll-duration-seconds: solo para Telegram (5-600 segundos)
• --poll-anonymous / --poll-public: visibilidad de la encuesta, solo para Telegram

Gateway RPC

Método: poll

Parámetros:

• to (cadena, obligatorio)
• question (cadena, obligatorio)
• options (cadena[], obligatorio)
• maxSelections (número, opcional)
• durationHours (número, opcional)
• durationSeconds (número, opcional, solo para Telegram)
• isAnonymous (booleano, opcional, solo para Telegram)
• channel (cadena, opcional, predeterminado: whatsapp)
• idempotencyKey (cadena, obligatorio)

Diferencias de canal

• Telegram: de 2 a 10 opciones. Admite temas del foro a través de destinos threadId o :topic:. Usa durationSeconds en lugar de durationHours, limitado a 5-600 segundos. Admite encuestas anónimas y públicas.
• WhatsApp: de 2 a 12 opciones, maxSelections debe estar dentro del recuento de opciones, ignora durationHours.
• Discord: de 2 a 10 opciones, durationHours limitado a 1-768 horas (predeterminado 24). maxSelections > 1 habilita la selección múltiple; Discord no admite un recuento de selección estricto.
• Microsoft Teams: encuestas de Tarjetas adaptables (administradas por OpenClaw). Sin API nativa de encuestas; durationHours se ignora.

Herramienta de agente (Mensaje)

Use la herramienta message con la acción poll (to, pollQuestion, pollOption, opcional pollMulti, pollDurationHours, channel).

Para Telegram, la herramienta también acepta pollDurationSeconds, pollAnonymous y pollPublic.

Use action: "poll" para la creación de encuestas. Los campos de encuesta pasados con action: "send" son rechazados.

Nota: Discord no tiene modo de “elegir exactamente N”; pollMulti se asigna a selección múltiple. Las encuestas de Teams se representan como tarjetas adaptables y requieren que la puerta de enlace permanezca en línea para registrar los votos en ~/.openclaw/msteams-polls.json.