​

openclaw message

openclaw message <subcommand> [flags]

​

チャンネルの選択

• 複数のチャンネルが設定されている場合、--channel <name> は必須です。 設定されているチャンネルが 1 つだけの場合は、そのチャンネルがデフォルトになります。
• 値: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp （Mattermost には Plugin が必要です）。
• チャンネル接頭辞付きのターゲット（例: discord:channel:123）は、明示的な --channel がなくても、そのターゲットを所有する Plugin に解決されます。

​

ターゲット形式（-t, --target）

​

共通フラグ

​

SecretRef の解決

• --channel が設定されている場合（または接頭辞付きターゲットから推測された場合）はチャンネルスコープ
• --account も設定されている場合はアカウントスコープ
• どちらも設定されていない場合は、設定済みのすべてのチャンネル

​

アクション

​

コア

​

送信

openclaw message send --channel discord \
  --target channel:123 --message "hi" --reply-to 456

• --media <path-or-url>: 画像／音声／動画／ドキュメント（ローカルパスまたは URL）を添付します。
• --presentation <json>: text、context、divider、 chart、table、buttons、select ブロックを含む共有ペイロードです。各チャンネルの 機能に応じてレンダリングされます。メッセージプレゼンテーションを参照してください。
• --delivery <json>: 一般的な配信設定です（例: {"pin": true}）。--pin は、チャンネルが対応している場合に ピン留め配信を指定する短縮形です。
• --reply-to <id>、--thread-id <id>（Telegram のフォーラムトピック、Slack のスレッド タイムスタンプ。--reply-to と同じフィールドです）。
• --force-document（Telegram、WhatsApp）: チャンネルによる圧縮を避けるため、画像／GIF／動画を ドキュメントとして送信します。
• --silent（Telegram、Discord）: 通知なしで送信します。
• --gif-playback（WhatsApp のみ）: 動画メディアを GIF として再生します。

openclaw message send --channel discord \
  --target channel:123 --message "選択してください:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"承認","value":"approve","style":"success"},{"label":"拒否","value":"decline","style":"danger"}]}]}'

openclaw message send --channel telegram --target @mychat --message "選択してください:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"はい","value":"cmd:yes"},{"label":"いいえ","value":"cmd:no"}]}]}'

openclaw message send --channel slack --target channel:C123 \
  --presentation '{"blocks":[{"type":"chart","chartType":"bar","title":"四半期売上高","categories":["第1四半期","第2四半期"],"series":[{"name":"売上高","values":[120,145]}],"xLabel":"四半期"}]}'

openclaw message send --channel slack --target channel:C123 \
  --presentation '{"title":"パイプラインレポート","blocks":[{"type":"table","caption":"進行中のパイプライン","headers":["アカウント","ステージ","ARR"],"rows":[["Acme","Won",125000],["Globex","Review",82000]],"rowHeaderColumnIndex":0}]}'

openclaw message send --channel telegram --target 123456789 --message "アプリを開く:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"起動","webApp":{"url":"https://example.com/app"}}]}]}'

openclaw message send --channel telegram --target @mychat \
  --media ./diagram.png --force-document

openclaw message send --channel msteams \
  --target conversation:19:abc@thread.tacv2 \
  --presentation '{"title":"ステータス更新","blocks":[{"type":"text","text":"ビルドが完了しました"}]}'

​

投票

openclaw message poll --channel discord \
  --target channel:123 \
  --poll-question "軽食は？" \
  --poll-option ピザ --poll-option 寿司 \
  --poll-multi --poll-duration-hours 48

• --poll-option <choice>: 2～12回繰り返します。
• --poll-multi: 複数選択を許可します。
• Discord: --poll-duration-hours、--silent、--message。
• Telegram: --poll-duration-seconds <n>（5～600）、--silent、 --poll-anonymous / --poll-public、--thread-id。

openclaw message poll --channel telegram \
  --target @mychat \
  --poll-question "昼食は？" \
  --poll-option ピザ --poll-option 寿司 \
  --poll-duration-seconds 120 --silent

openclaw message poll --channel msteams \
  --target conversation:19:abc@thread.tacv2 \
  --poll-question "昼食は？" \
  --poll-option ピザ --poll-option 寿司

​

スレッド

• thread create: 対応チャンネルは Discord。必須: --thread-name、--target （チャンネル ID）。任意: --message-id、--message、--auto-archive-min。
• thread list: 対応チャンネルは Discord。必須: --guild-id。任意: --channel-id、--include-archived、--before、--limit。
• thread reply: 対応チャンネルは Discord。必須: --target（スレッド ID）、 --message。任意: --media、--reply-to。

​

絵文字

• emoji list: Discord（--guild-id）、Slack（追加フラグなし）。
• emoji upload: Discord。必須: --guild-id、--emoji-name、--media。 任意: --role-ids（繰り返し）。

​

ステッカー

• sticker send: Discord。必須: --target、--sticker-id（繰り返し）。 任意: --message。
• sticker upload: Discord。必須: --guild-id、--sticker-name、 --sticker-desc、--sticker-tags、--media。

​

ロール、チャンネル、ボイス、イベント（Discord）

• role info: --guild-id。
• role add / role remove: --guild-id、--user-id、--role-id。
• channel info: --target。
• channel list: --guild-id。
• voice status: --guild-id、--user-id。
• event list: --guild-id。
• event create: 必須 --guild-id、--event-name、--start-time。 任意 --end-time、--desc、--channel-id、--location、 --event-type、--image <url-or-path>。

​

モデレーション（Discord）

• timeout: --guild-id、--user-id。任意で --duration-min または --until（タイムアウトを解除する場合は両方とも省略）、--reason。
• kick: --guild-id、--user-id、--reason。
• ban: --guild-id、--user-id、--delete-days、--reason。

​

ブロードキャスト

openclaw message broadcast --targets <target...> [--channel all] [--message <text>] [--media <url>] [--dry-run]

​

関連項目

• CLI リファレンス
• エージェント送信
• メッセージプレゼンテーション