メインコンテンツへスキップ

対応チャンネル

  • Telegram
  • WhatsApp(Web チャンネル)
  • Discord
  • MS Teams(Adaptive Cards)

CLI

オプション:
  • --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 に記録するため、ゲートウェイがオンラインである必要があります。