対応チャンネル
- Telegram
- WhatsApp(Web チャンネル)
- Discord
- MS Teams(Adaptive Cards)
CLI
--channel:whatsapp(デフォルト)、telegram、discord、またはmsteams--poll-multi: 複数選択を許可--poll-duration-hours: Discord 専用(省略時のデフォルトは 24)--poll-duration-seconds: Telegram 専用(5〜600 秒)--poll-anonymous/--poll-public: Telegram 専用の投票公開設定
ゲートウェイ RPC
メソッド:poll
パラメータ:
to(string、必須)question(string、必須)options(string[]、必須)maxSelections(number、任意)durationHours(number、任意)durationSeconds(number、任意、Telegram 専用)isAnonymous(boolean、任意、Telegram 専用)channel(string、任意、デフォルト:whatsapp)idempotencyKey(string、必須)
チャンネルごとの違い
- Telegram: 選択肢は 2〜10 個。
threadIdまたは:topic:ターゲットによるフォーラムトピックに対応。durationHoursの代わりにdurationSecondsを使用し、5〜600 秒に制限される。匿名投票と公開投票に対応。 - WhatsApp: 選択肢は 2〜12 個。
maxSelectionsは選択肢の数以内である必要がある。durationHoursは無視される。 - Discord: 選択肢は 2〜10 個。
durationHoursは 1〜768 時間にクランプされる(デフォルト 24)。maxSelections > 1で複数選択が有効になる。Discord は厳密な選択数の制限に対応していない。 - MS Teams: Adaptive Card による投票(OpenClaw 管理)。ネイティブの投票 API はなく、
durationHoursは無視される。
エージェントツール(Message)
message ツールの poll アクションを使用する(to、pollQuestion、pollOption、任意で pollMulti、pollDurationHours、channel)。
Telegram の場合、ツールは pollDurationSeconds、pollAnonymous、pollPublic も受け付ける。
投票作成には action: "poll" を使用する。action: "send" で投票フィールドを渡すと拒否される。
注意: Discord には「ちょうど N 個を選択」するモードがなく、pollMulti は複数選択にマッピングされる。
Teams の投票は Adaptive Cards としてレンダリングされ、投票を ~/.openclaw/msteams-polls.json に記録するため、ゲートウェイがオンラインである必要があります。