Skip to main content

対応チャンネル

  • Telegram
  • WhatsApp(Web チャンネル)
  • 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(デフォルト)、telegramdiscord、または 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 アクションを使用する(topollQuestionpollOption、任意で pollMultipollDurationHourschannel)。 Telegram の場合、ツールは pollDurationSecondspollAnonymouspollPublic も受け付ける。 投票作成には action: "poll" を使用する。action: "send" で投票フィールドを渡すと拒否される。 注意: Discord には「ちょうど N 個を選択」するモードがなく、pollMulti は複数選択にマッピングされる。 Teams の投票は Adaptive Cards としてレンダリングされ、投票を ~/.openclaw/msteams-polls.json に記録するため、ゲートウェイがオンラインである必要があります。