メインコンテンツへスキップ
openclaw agent は、受信チャットメッセージなしでコマンドラインから単一のエージェントターンを実行します。スクリプト化されたワークフロー、テスト、プログラムによる配信に使用します。フラグと動作の完全なリファレンス: Agent CLI リファレンス。

​
クイックスタート

1

Run a simple agent turn

openclaw agent --agent main --message "What is the weather today?"
Gateway 経由でメッセージを送信し、返信を出力します。
2

Send a multiline prompt from a file

openclaw agent --agent ops --message-file ./task.md
有効な UTF-8 ファイルをエージェントメッセージ本文として読み取ります。
3

Target a specific agent or session

# Target a specific agent
openclaw agent --agent ops --message "Summarize logs"

# Target a phone number (derives session key)
openclaw agent --to +15555550123 --message "Status update"

# Reuse an existing session
openclaw agent --session-id abc123 --message "Continue the task"

# Target an exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"
4

Deliver the reply to a channel

# Deliver to WhatsApp (default channel)
openclaw agent --to +15555550123 --message "Report ready" --deliver

# Deliver to Slack
openclaw 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>配信チャンネル（discord、slack、telegram、whatsapp など）
--reply-to <target>配信ターゲットの上書き
--reply-channel <name>配信チャンネルの上書き
--reply-account <id>配信アカウント ID の上書き
--thinking <level>選択したモデルプロファイルの思考レベルを設定する
--verbose <on|full|off>セッションの verbose レベルを永続化する（full はツール出力もログに記録）
--timeout <seconds>エージェントタイムアウトを上書きする（デフォルト 600、または設定値）
--json構造化 JSON を出力する

​
動作

  • デフォルトでは、CLI は Gateway 経由で実行されます。現在のマシン上の埋め込みランタイムを強制するには --local を追加します。
  • --message または --message-file のどちらか一方だけを渡します。ファイルメッセージは、任意の UTF-8 BOM を削除した後も複数行コンテンツを保持します。
  • Gateway リクエストが失敗した場合、CLI はローカル埋め込み実行へフォールバックします。Gateway タイムアウト時は、元のトランスクリプトと競合させる代わりに、新しいセッションでフォールバックします。
  • セッション選択: --to はセッションキーを導出します（グループ/チャンネルターゲットは分離を保持し、直接チャットは main に統合されます）。
  • --session-key は明示的なキーを選択します。エージェント接頭辞付きキーは agent:<agent-id>:<session-key> を使用する必要があり、両方が指定された場合は --agent がそのエージェント ID と一致している必要があります。素の非センチネルキーは、指定されている場合は --agent にスコープされます。たとえば、--agent ops --session-key incident-42 は agent:ops:incident-42 にルーティングされます。--agent がない場合、素の非センチネルキーは設定済みのデフォルトエージェントにスコープされます。リテラルの global と unknown は、--agent が指定されていない場合にのみスコープなしのままです。埋め込みフォールバックパスは、これらのセンチネルセッションを設定済みのデフォルトエージェントに解決します。
  • --channel、--reply-channel、--reply-account は返信配信に影響し、セッションルーティングには影響しません。
  • thinking フラグと verbose フラグはセッションストアに永続化されます。
  • 出力: デフォルトはプレーンテキスト、構造化ペイロード + メタデータには --json を使用します。
  • --json --deliver では、JSON に送信済み、抑制済み、部分的、失敗した送信の配信ステータスが含まれます。JSON 配信ステータスを参照してください。

​
例

# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Turn with a model override
openclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs"

# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Multiline prompt from a file
openclaw agent --agent ops --message-file ./task.md

# Exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Legacy key scoped to an agent
openclaw agent --agent ops --session-key incident-42 --message "Summarize status"

# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​
関連

Agent CLI reference

openclaw agent のフラグとオプションの完全なリファレンス。

Sub-agents

バックグラウンドのサブエージェント生成。

Sessions

セッションキーの仕組みと、--to、--agent、--session-id がそれらを解決する方法。

Slash commands

エージェントセッション内で使用されるネイティブコマンドカタログ。