Agent coordination
エージェント送信
openclaw agent は、受信チャットメッセージなしで、コマンドラインからエージェントのターンを1回実行します。スクリプト化されたワークフロー、テスト、プログラムによる配信に使用します。フラグと動作の完全なリファレンス：
エージェント CLI リファレンス。
クイックスタート
Run a simple agent turn
openclaw agent --agent main --message "What is the weather today?"Gateway を介してメッセージを送信し、応答を表示します。
Send a multiline prompt from a file
openclaw agent --agent ops --message-file ./task.md有効な UTF-8 ファイルをエージェントメッセージの本文として読み取ります。
Target a specific agent or session
# Target a specific agentopenclaw agent --agent ops --message "Summarize logs" # Target a phone number (derives session key)openclaw agent --to +15555550123 --message "Status update" # Reuse an existing sessionopenclaw agent --session-id abc123 --message "Continue the task" # Target an exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status"Deliver the reply to a channel
# Deliver to WhatsApp (default channel)openclaw agent --to +15555550123 --message "Report ready" --deliver # Deliver to Slackopenclaw agent --agent ops --message "Generate report" \ --deliver --reply-channel slack --reply-to "#reports"フラグ
| フラグ | 説明 |
|---|---|
--message <text> |
送信するインラインメッセージ |
--message-file <path> |
有効な UTF-8 ファイルからメッセージを読み取る |
--to <dest> |
対象（電話番号、チャット ID）からセッションキーを導出する |
--session-key <key> |
明示的なセッションキーを使用する |
--agent <id> |
設定済みのエージェントを対象にする（その main セッションを使用） |
--session-id <id> |
ID を指定して既存のセッションを再利用する |
--model <id> |
この実行でモデルを上書きする（provider/model またはモデル ID） |
--local |
ローカルの組み込みランタイムを強制する（Gateway をスキップ） |
--deliver |
応答をチャットチャンネルへ送信する |
--channel <name> |
配信チャンネル。--agent + --to と併用すると DM スコープにも適用 |
--reply-to <target> |
配信先を上書きする |
--reply-channel <name> |
配信チャンネルを上書きする |
--reply-account <id> |
配信アカウント ID を上書きする |
--thinking <level> |
選択したモデルプロファイルの思考レベルを設定する |
--verbose <on|full|off> |
セッションの詳細レベルを永続化する（full はツール出力も記録） |
--timeout <seconds> |
エージェントのタイムアウトを上書きする（既定値は600秒または設定値） |
--json |
構造化 JSON を出力する |
動作
- 既定では、CLI は Gateway を経由します。現在のマシン上にある組み込みランタイムを強制するには、
--localを追加します。 --messageまたは--message-fileのどちらか一方だけを渡してください。ファイルメッセージでは、任意の UTF-8 BOM を削除した後も複数行の内容が保持されます。- Gateway リクエストが失敗した場合、CLI はローカルの組み込み実行へフォールバックします。Gateway がタイムアウトした場合は、元のトランスクリプトと競合することを避けるため、新しいセッションでフォールバックします。
- セッションの選択：
--toはセッションキーを導出します（グループ／チャンネルの対象では分離が維持され、ダイレクトチャットはmainに集約されます）。--agent、--channel、--toを同時に指定すると、ルーティングはチャンネルの正規の受信者とsession.dmScopeに従います。安定した送信専用 ID では、エージェントのメインセッションから分離された、プロバイダー所有のセッションが使用されます。 --session-keyは明示的なキーを選択します。エージェント接頭辞付きのキーはagent:<agent-id>:<session-key>を使用する必要があり、--agentも指定する場合は、そのエージェント ID と一致する必要があります。センチネルではない接頭辞なしのキーは、--agentが指定されている場合、そのエージェントのスコープになります。たとえば、--agent ops --session-key incident-42はagent:ops:incident-42にルーティングされます。--agentがない場合、センチネルではない接頭辞なしのキーは、設定済みの既定エージェントのスコープになります。リテラル値globalとunknownは、--agentが指定されていない場合にのみスコープなしのままになります。組み込みのフォールバック経路では、これらのセンチネルセッションは設定済みの既定エージェントに解決されます。--reply-channelと--reply-accountは配信のみに影響します。- 思考フラグと詳細フラグはセッションストアに永続化されます。
- 出力：既定ではプレーンテキスト、
--jsonを指定すると構造化されたペイロードとメタデータが出力されます。 --json --deliverを指定すると、JSON には送信済み、抑制済み、部分送信、送信失敗の配信状態が含まれます。JSON の配信状態を参照してください。
例
# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with a model overrideopenclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs" # Turn with thinking levelopenclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # Multiline prompt from a fileopenclaw agent --agent ops --message-file ./task.md # Exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status" # Legacy key scoped to an agentopenclaw agent --agent ops --session-key incident-42 --message "Summarize status" # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"関連項目
Was this useful?
