openclaw message

Discord、Google Chat、iMessage、Matrix、Mattermost（Plugin）、Microsoft Teams、 Signal、Slack、Telegram、WhatsAppでメッセージやチャネルアクションを送信するための 単一の送信コマンドです。

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）

チャネル名の検索: ディレクトリを持つプロバイダー（Discord、Slackなど）では、 Help や #help のような名前をディレクトリキャッシュから解決します。キャッシュに ない場合、プロバイダーが対応していればライブディレクトリ検索にフォールバックします。

共通フラグ

すべてのアクションで --channel <name>、--account <id>、--json、 --dry-run、--verbose を使用できます。宛先を取るアクションでは、 -t, --target <dest> も使用できます。

SecretRefの解決

openclaw message はアクションを実行する前に、可能な限り狭いスコープで チャネルのSecretRefを解決します。

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

無関係なチャネルで未解決のSecretRefがあっても、対象を指定したアクションは ブロックされません。選択したチャネル／アカウントのSecretRefが未解決の場合、 アクションは安全側に倒して失敗します。

アクション

コア

送信

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 "Choose:" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Approve","value":"approve","style":"success"},{"label":"Decline","value":"decline","style":"danger"}]}]}'

openclaw message send --channel telegram --target @mychat --message "Choose:" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Yes","value":"cmd:yes"},{"label":"No","value":"cmd:no"}]}]}'

Slackでは対応しているチャートブロックをネイティブにレンダリングします。 その他のチャネルでは、同じデータを読みやすいテキストとして受信します。

openclaw message send --channel slack --target channel:C123 \  --presentation '{"blocks":[{"type":"chart","chartType":"bar","title":"Quarterly revenue","categories":["Q1","Q2"],"series":[{"name":"Revenue","values":[120,145]}],"xLabel":"Quarter"}]}'

Slack は明示的なテーブルブロックもネイティブにレンダリングします。ほかのチャネルでは、キャプションとすべての行を決定的なテキストとして受信します。

openclaw message send --channel slack --target channel:C123 \  --presentation '{"title":"Pipeline report","blocks":[{"type":"table","caption":"Open pipeline","headers":["Account","Stage","ARR"],"rows":[["Acme","Won",125000],["Globex","Review",82000]],"rowHeaderColumnIndex":0}]}'

Telegram Mini App のボタンは webApp（従来の JSON 用として web_app も引き続き解析されます）を使用し、ユーザーとボット間のプライベートチャットでのみレンダリングされます。

openclaw message send --channel telegram --target 123456789 --message "Open app:" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Launch","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":"Status update","blocks":[{"type":"text","text":"Build completed"}]}'

投票

openclaw message poll --channel discord \  --target channel:123 \  --poll-question "Snack?" \  --poll-option Pizza --poll-option Sushi \  --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 "Lunch?" \  --poll-option Pizza --poll-option Sushi \  --poll-duration-seconds 120 --silent

openclaw message poll --channel msteams \  --target conversation:19:abc@thread.tacv2 \  --poll-question "Lunch?" \  --poll-option Pizza --poll-option Sushi

スレッド

• 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]

1 つのペイロードを複数のターゲットに送信します。--targets には、スペース区切りのリストを指定します。設定済みのすべてのプロバイダーを対象にするには、--channel all を使用します。

関連項目

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