​

openclaw message

​

使用方法

openclaw message <subcommand> [flags]

• 複数のチャンネルが設定されている場合は --channel が必須です。
• ちょうど 1 つのチャンネルのみが設定されている場合、それがデフォルトになります。
• 値: whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams（Mattermost はプラグインが必要）

• WhatsApp: E.164 またはグループ JID
• Telegram: チャット ID または @username
• Discord: channel:<id> または user:<id>（または <@id> メンション。生の数値 ID はチャンネルとして扱われます）
• Google Chat: spaces/<spaceId> または users/<userId>
• Slack: channel:<id> または user:<id>（生のチャンネル ID を受け付けます）
• Mattermost（プラグイン）: channel:<id>、user:<id>、または @username（裸の ID はチャンネルとして扱われます）
• Signal: +E.164、group:<id>、signal:+E.164、signal:group:<id>、または username:<name>/u:<name>
• iMessage: ハンドル、chat_id:<id>、chat_guid:<guid>、または chat_identifier:<id>
• MS Teams: 会話 ID（19:[email protected]）または conversation:<id> または user:<aad-object-id>

• 対応プロバイダー（Discord/Slack など）では、Help や #help のようなチャンネル名はディレクトリキャッシュを介して解決されます。
• キャッシュミスの場合、プロバイダーが対応していれば OpenClaw はライブのディレクトリ参照を試みます。

​

共通フラグ

• --channel <name>
• --account <id>
• --target <dest>（send/poll/read などの対象チャンネルまたはユーザー）
• --targets <name>（繰り返し。ブロードキャストのみ）
• --json
• --dry-run
• --verbose

​

アクション

​

コア

• send
  • チャンネル: WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost（プラグイン）/Signal/iMessage/MS Teams
  • 必須: --target、および --message または --media
  • 任意: --media、--reply-to、--thread-id、--gif-playback
  • Telegram のみ: --buttons（許可するには channels.telegram.capabilities.inlineButtons が必要）
  • Telegram のみ: --thread-id（フォーラムのトピック ID）
  • Slack のみ: --thread-id（スレッドのタイムスタンプ。--reply-to は同じフィールドを使用）
  • WhatsApp のみ: --gif-playback
• poll
  • チャンネル: WhatsApp/Discord/MS Teams
  • 必須: --target、--poll-question、--poll-option（繰り返し）
  • 任意: --poll-multi
  • Discord のみ: --poll-duration-hours、--message
  • Telegram のみ: --poll-duration-seconds（5〜600）、--silent、--poll-anonymous / --poll-public、--thread-id
• react
  • チャンネル: Discord/Google Chat/Slack/Telegram/WhatsApp/Signal
  • 必須: --message-id、--target
  • 任意: --emoji、--remove、--participant、--from-me、--target-author、--target-author-uuid
  • 注記: --remove には --emoji が必要です（対応している場合、自分のリアクションをクリアするには --emoji を省略します。/tools/reactions を参照）
  • WhatsApp のみ: --participant、--from-me
  • Signal のグループリアクション: --target-author または --target-author-uuid が必須
• reactions
  • チャンネル: Discord/Google Chat/Slack
  • 必須: --message-id、--target
  • 任意: --limit
• read
  • チャンネル: Discord/Slack
  • 必須: --target
  • 任意: --limit、--before、--after
  • Discord のみ: --around
• edit
  • チャンネル: Discord/Slack
  • 必須: --message-id、--message、--target
• delete
  • チャンネル: Discord/Slack/Telegram
  • 必須: --message-id、--target
• pin / unpin
  • チャンネル: Discord/Slack
  • 必須: --message-id、--target
• pins（list）
  • チャンネル: Discord/Slack
  • 必須: --target
• permissions
  • チャンネル: Discord
  • 必須: --target
• search
  • チャンネル: Discord
  • 必須: --guild-id、--query
  • 任意: --channel-id、--channel-ids（繰り返し）、--author-id、--author-ids（繰り返し）、--limit

​

Threads

• 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

​

Emojis

• emoji list
  • Discord: --guild-id
  • Slack: 追加フラグはありません
• emoji upload
  • チャンネル: Discord
  • 必須: --guild-id、--emoji-name、--media
  • 任意: --role-ids（繰り返し）

​

Stickers

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

​

Roles / Channels / Members / Voice

• role info（Discord）: --guild-id
• role add / role remove（Discord）: --guild-id、--user-id、--role-id
• channel info（Discord）: --target
• channel list（Discord）: --guild-id
• member info（Discord/Slack）: --user-id（+ Discord 用に --guild-id）
• voice status（Discord）: --guild-id、--user-id

​

Events

• event list（Discord）: --guild-id
• event create（Discord）: --guild-id、--event-name、--start-time
  • 任意: --end-time、--desc、--channel-id、--location、--event-type

​

Moderation（Discord）

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

​

Broadcast

• broadcast
  • チャンネル: 設定済みの任意のチャンネル。すべてのプロバイダーを対象にするには --channel all を使用します
  • 必須: --targets（繰り返し）
  • 任意: --message、--media、--dry-run

​

Examples

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

openclaw message poll --channel discord \
  --target channel:123 \
  --poll-question "Snack?" \
  --poll-option Pizza --poll-option Sushi \
  --poll-multi --poll-duration-hours 48

openclaw message poll --channel telegram \
  --target @mychat \
  --poll-question "Lunch?" \
  --poll-option Pizza --poll-option Sushi \
  --poll-duration-seconds 120 --silent

openclaw message send --channel msteams \
  --target conversation:19:[email protected] --message "hi"

openclaw message poll --channel msteams \
  --target conversation:19:[email protected] \
  --poll-question "Lunch?" \
  --poll-option Pizza --poll-option Sushi

openclaw message react --channel slack \
  --target C123 --message-id 456 --emoji "✅"

openclaw message react --channel signal \
  --target signal:group:abc123 --message-id 1737630212345 \
  --emoji "✅" --target-author-uuid 123e4567-e89b-12d3-a456-426614174000

openclaw message send --channel telegram --target @mychat --message "Choose:" \
  --buttons '[ [{"text":"Yes","callback_data":"cmd:yes"}], [{"text":"No","callback_data":"cmd:no"}] ]'