跳轉到主要內容

​
openclaw agent（直接執行 agent）

  1. openclaw agent 可在不需要傳入聊天訊息的情況下執行單次代理回合。 openclaw agent 可在不需要傳入聊天訊息的情況下執行單次代理回合。 By default it goes through the Gateway; add --local to force the embedded runtime on the current machine.

​
行為

  • 必要項目：--message <text>
  • Session selection:
    • --to <dest> 會推導工作階段金鑰（群組／頻道目標會保留隔離；私聊會合併為 main），或
    • --session-id <id> 依 id 重用既有工作階段，或
    • --agent <id> 直接指定已設定的 agent（使用該 agent 的 main 工作階段金鑰）
  • 執行與一般入站回覆相同的內嵌 agent runtime。
  • Thinking/verbose flags persist into the session store.
  • Output:
    • 預設：列印回覆文字（外加 MEDIA:<url> 行）
    • --json：列印結構化酬載與中繼資料
  • 可使用 --deliver + --channel 將結果回傳至頻道（目標格式與 openclaw message --target 相同）。
  • 使用 --reply-channel/--reply-to/--reply-account 可在不變更工作階段的情況下覆寫傳送設定。
If the Gateway is unreachable, the CLI falls back to the embedded local run.

​
範例

openclaw agent --to +15555550123 --message "status update"
openclaw agent --agent ops --message "Summarize logs"
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json
openclaw agent --to +15555550123 --message "Summon reply" --deliver
openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"

​
旗標

  • --local：於本機執行（需要在 shell 中設定模型提供者 API 金鑰）
  • --deliver：將回覆傳送到所選頻道
  • --channel：傳送頻道（whatsapp|telegram|discord|googlechat|slack|signal|imessage，預設：whatsapp）
  • --reply-to：傳送目標覆寫
  • --reply-channel：傳送頻道覆寫
  • --reply-account：傳送帳號 id 覆寫
  • --thinking <off|minimal|low|medium|high|xhigh>：持久化 thinking 等級（僅限 GPT-5.2 + Codex 模型）
  • --verbose <on|full|off>：持久化 verbose 等級
  • --timeout <seconds>：覆寫 agent 逾時
  • --json：輸出結構化 JSON