Polls（投票）

サポートされている Channel

  • WhatsApp（Web Channel）
  • Discord
  • MS Teams（Adaptive Cards）

CLI

# 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

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

オプション:

  • --channel: whatsapp（デフォルト）、discord、または msteams
  • --poll-multi: 複数のオプションの選択を許可
  • --poll-duration-hours: Discord のみ（省略時のデフォルトは24）

Gateway RPC

メソッド: poll

パラメータ:

  • to（string、必須）
  • question（string、必須）
  • options（string[]、必須）
  • maxSelections（number、オプション）
  • durationHours（number、オプション）
  • channel（string、オプション、デフォルト: whatsapp）
  • idempotencyKey（string、必須）

Channel の違い

  • WhatsApp: 2-12 オプション、maxSelections はオプション数以内でなければなりません。durationHours は無視されます。
  • Discord: 2-10 オプション、durationHours は 1-768 時間にクランプされます（デフォルト 24）。maxSelections > 1 は複数選択を有効にします。Discord は厳密な選択数をサポートしていません。
  • MS Teams: Adaptive Card の投票（OpenClaw 管理）。ネイティブの投票 API はありません。durationHours は無視されます。

Agent ツール（Message）

message ツールを poll アクション（to、pollQuestion、pollOption、オプションの pollMulti、pollDurationHours、channel）で使用します。

注意: Discord には「正確に N を選択」モードがありません。pollMulti は複数選択にマップされます。 Teams の投票は Adaptive Cards としてレンダリングされ、投票を記録するためには Gateway がオンラインである必要があります（~/.openclaw/msteams-polls.json に記録）。

← ドキュメントに戻る