openclaw agent 會從命令列執行單次代理程式回合，且不需要傳入的聊天訊息。可用於指令碼工作流程、測試與程式化交付。完整旗標與行為參考：
代理程式命令列介面參考.
快速開始
旗標
| 旗標 | 說明 |
|---|---|
--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 | 強制使用本機嵌入式執行階段（略過閘道） |
--deliver | 將回覆傳送到聊天頻道 |
--channel <name> | 交付頻道（discord、slack、telegram、whatsapp 等） |
--reply-to <target> | 交付目標覆寫 |
--reply-channel <name> | 交付頻道覆寫 |
--reply-account <id> | 交付帳戶 ID 覆寫 |
--thinking <level> | 設定所選模型設定檔的思考等級 |
--verbose <on|full|off> | 保存工作階段的詳細程度（full 也會記錄工具輸出） |
--timeout <seconds> | 覆寫代理程式逾時（預設 600，或設定值） |
--json | 輸出結構化 JSON |
行為
- 預設情況下，命令列介面會經由閘道。加入
--local可強制在目前機器上使用嵌入式執行階段。 - 只能傳入
--message或--message-file其中之一。檔案訊息會在移除選用的 UTF-8 BOM 後保留多行內容。 - 如果閘道請求失敗，命令列介面會退回到本機嵌入式執行；閘道逾時會改用全新的工作階段退回，而不是與原始逐字稿競速。
- 工作階段選擇：
--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會影響回覆交付，而不是工作階段路由。- 思考與詳細旗標會保存到工作階段儲存區。
- 輸出：預設為純文字，或使用
--json取得結構化承載資料與中繼資料。 - 使用
--json --deliver時，JSON 會包含已傳送、已抑制、部分和失敗傳送的交付狀態。請參閱 JSON 交付狀態。
範例
相關
代理程式命令列介面參考
完整的
openclaw agent 旗標與選項參考。子代理程式
背景子代理程式產生。
工作階段
工作階段金鑰如何運作，以及
--to、--agent 和 --session-id 如何解析它們。斜線命令
代理程式工作階段內使用的原生命令目錄。