openclaw message

メッセージ送信とチャネルアクションのための単一のアウトバウンドコマンドです （Discord/Google Chat/Slack/Mattermost（プラグイン）/Telegram/WhatsApp/Signal/iMessage/MS Teams）。

使用方法

openclaw message <subcommand> [flags]

チャネル選択：

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

ターゲット形式（--target）：

  • 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>（繰り返し可能；broadcast のみ）
  • --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

  • 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（リスト）

    • チャネル：Discord/Slack
    • 必須：--target

  • permissions

    • チャネル：Discord
    • 必須：--target

  • search

    • チャネル：Discord
    • 必須：--guild-id、--query
    • オプション：--channel-id、--channel-ids（繰り返し可能）、--author-id、--author-ids（繰り返し可能）、--limit

スレッド

  • thread create

    • チャネル：Discord
    • 必須：--thread-name、--target（チャネル ID）
    • オプション：--message-id、--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

ロール / チャネル / メンバー / ボイス

  • 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

イベント

  • event list（Discord）：--guild-id
  • event create（Discord）：--guild-id、--event-name、--start-time
    • オプション：--end-time、--desc、--channel-id、--location、--event-type

モデレーション（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
    • チャネル：設定されているすべてのチャネル；すべてのプロバイダーをターゲットにするには --channel all を使用します
    • 必須：--targets（繰り返し可能）
    • オプション：--message、--media、--dry-run

例

Discord で返信を送信：

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

Discord 投票を作成：

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

Teams のプロアクティブメッセージを送信：

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

Teams 投票を作成：

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

Slack でリアクション：

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

Signal グループでリアクション：

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

Telegram インラインボタンを送信：

openclaw message send --channel telegram --target @mychat --message "Choose:" \
  --buttons '[ [{"text":"Yes","callback_data":"cmd:yes"}], [{"text":"No","callback_data":"cmd:no"}] ]'
← ドキュメントに戻る