English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

CLI commands

メッセージ

openclaw message

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

使用方法

openclaw message <subcommand> [flags]

チャンネル選択:

  • 複数のチャンネルが設定されている場合、--channel が必要。
  • ちょうど1つのチャンネルだけが設定されている場合、それがデフォルトになる。
  • 値: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost には Plugin が必要)
  • openclaw message は、--channel またはチャンネル接頭辞付きのターゲットが存在する場合、選択されたチャンネルをその所有 Plugin に解決する。それ以外の場合は、デフォルトチャンネル推論のために設定済みのチャンネル Plugin を読み込む。

ターゲット形式 (--target):

  • WhatsApp: E.164、グループ JID、または WhatsApp Channel/Newsletter JID (...@newsletter)
  • Telegram: チャット ID、@username、またはフォーラムトピックターゲット (-1001234567890:topic:42、または --thread-id 42)
  • Discord: channel:<id> または user:<id> (または <@id> メンション。生の数値 ID はチャンネルとして扱われる)
  • Google Chat: spaces/<spaceId> または users/<userId>
  • Slack: channel:<id> または user:<id> (生のチャンネル ID も受け付ける)
  • Mattermost (Plugin): 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>
  • Matrix: @user:server、!room:server、または #alias:server
  • Microsoft Teams: 会話 ID (19:[email protected]) または conversation:<id> または user:<aad-object-id>

名前検索:

  • 対応プロバイダー (Discord/Slack など) では、Help や #help のようなチャンネル名はディレクトリキャッシュ経由で解決される。
  • キャッシュミス時、プロバイダーが対応している場合、OpenClaw はライブディレクトリ検索を試行する。

共通フラグ

  • --channel <name>
  • --account <id>
  • --target <dest> (送信/ポーリング/読み取りなどの対象チャンネルまたはユーザー)
  • --targets <name> (繰り返し指定。ブロードキャスト専用)
  • --json
  • --dry-run
  • --verbose

SecretRef の動作

  • openclaw message は、選択されたアクションを実行する前に、対応チャンネルの SecretRef を解決する。
  • 可能な場合、解決はアクティブなアクションターゲットにスコープされる:
    • --channel が設定されている場合 (または discord:... のような接頭辞付きターゲットから推論される場合) はチャンネルスコープ
    • --account が設定されている場合はアカウントスコープ (チャンネルグローバル + 選択されたアカウントのサーフェス)
    • --account が省略されている場合、OpenClaw は default アカウントの SecretRef スコープを強制しない
  • 無関係なチャンネル上の未解決 SecretRef は、対象を絞ったメッセージアクションをブロックしない。
  • 選択されたチャンネル/アカウントの SecretRef が未解決の場合、コマンドはそのアクションについてフェイルクローズする。

アクション

コア

  • send

    • チャンネル: WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (Plugin)/Signal/iMessage/Matrix/Microsoft Teams
    • 必須: --target、加えて --message、--media、または --presentation
    • 任意: --media、--presentation、--delivery、--pin、--reply-to、--thread-id、--gif-playback、--force-document、--silent
    • 共有プレゼンテーションペイロード: --presentation は、コアが選択されたチャンネルの宣言済みケイパビリティを通じてレンダリングするセマンティックブロック (text、context、divider、buttons、select) を送信する。詳細は メッセージプレゼンテーション を参照。
    • 汎用配信設定: --delivery は { "pin": true } のような配信ヒントを受け付ける。--pin は、チャンネルが対応している場合のピン留め配信の短縮形。
    • Telegram のみ: --force-document (Telegram の圧縮を避けるため、画像と GIF をドキュメントとして送信)
    • Telegram のみ: --thread-id (フォーラムトピック ID)
    • Slack のみ: --thread-id (スレッドのタイムスタンプ。--reply-to は同じフィールドを使用)
    • Telegram + Discord: --silent
    • WhatsApp のみ: --gif-playback。WhatsApp Channels/Newsletters はネイティブの @newsletter JID で指定する。

  • poll

    • チャンネル: WhatsApp/Telegram/Discord/Matrix/Microsoft Teams
    • 必須: --target、--poll-question、--poll-option (繰り返し指定)
    • 任意: --poll-multi
    • Discord のみ: --poll-duration-hours、--silent、--message
    • Telegram のみ: --poll-duration-seconds (5-600)、--silent、--poll-anonymous / --poll-public、--thread-id

  • react

    • チャンネル: Discord/Google Chat/Slack/Telegram/WhatsApp/Signal/Matrix
    • 必須: --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/Matrix
    • 必須: --message-id、--target
    • 任意: --limit

  • read

    • チャンネル: Discord/Slack/Matrix
    • 必須: --target
    • 任意: --limit、--message-id、--before、--after
    • Slack のみ: --message-id は特定の Slack メッセージタイムスタンプを読み取る。正確なスレッド返信を読み取るには --thread-id と組み合わせる。
    • Discord のみ: --around

  • edit

    • チャンネル: Discord/Slack/Matrix
    • 必須: --message-id、--message、--target

  • delete

    • チャンネル: Discord/Slack/Telegram/Matrix
    • 必須: --message-id、--target

  • pin / unpin

    • チャンネル: Discord/Slack/Matrix
    • 必須: --message-id、--target

  • pins (一覧)

    • チャンネル: Discord/Slack/Matrix
    • 必須: --target

  • permissions

    • チャンネル: Discord/Matrix
    • 必須: --target
    • Matrix のみ: Matrix 暗号化が有効で、検証アクションが許可されている場合に利用可能

  • search

    • チャンネル: Discord
    • 必須: --guild-id、--query
    • 任意: --channel-id、--channel-ids (繰り返し指定)、--author-id、--author-ids (繰り返し指定)、--limit

スレッド

  • 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

ロール / チャンネル / メンバー / 音声

  • 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 <target...>
    • 任意: --message、--media、--dry-run

例

Discord 返信を送信する:

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

セマンティックボタン付きのメッセージを送信する:

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"}]}]}'

コアは、同じ presentation ペイロードを、チャンネルのケイパビリティに応じて Discord コンポーネント、Slack ブロック、Telegram インラインボタン、Mattermost props、または Teams/Feishu カードにレンダリングする。完全なコントラクトとフォールバックルールについては、メッセージプレゼンテーション を参照。

よりリッチなプレゼンテーションペイロードを送信する:

openclaw message send --channel googlechat --target spaces/AAA... \
  --message "Choose:" \
  --presentation '{"title":"Deploy approval","tone":"warning","blocks":[{"type":"text","text":"Choose a path"},{"type":"buttons","buttons":[{"label":"Approve","value":"approve"},{"label":"Decline","value":"decline"}]}]}'

Discord 投票を作成する:

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

Telegram 投票を作成する (2分後に自動クローズ):

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

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:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Yes","value":"cmd:yes"},{"label":"No","value":"cmd:no"}]}]}'

汎用プレゼンテーションを通じて Teams カードを送信する:

openclaw message send --channel msteams \
  --target conversation:19:[email protected] \
  --presentation '{"title":"Status update","blocks":[{"type":"text","text":"Build completed"}]}'

圧縮を避けるため、Telegram 画像をドキュメントとして送信する:

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

関連