詢問使用者

ask_user 可讓代理程式向使用者提出一至三個結構化問題，並 等待回答。此工具用於確實應由使用者決定的事項， 而非例行確認，或代理程式能從要求、程式碼或合理預設值 推導出的資訊。

此工具僅適用於主要工作階段。子代理程式及其他非主要 執行不會取得此工具。

回答問題

你可以從任何支援的對話介面回答：

• 網頁版控制介面會將問題面板停駐在輸入框正上方。對於 包含多個問題的提示，面板一次顯示一個問題，並透過簡短的步驟導覽 逐題前進。完成回答後，面板會關閉，而聊天中 只保留精簡的回答摘要。
• 對於只有一個問題且為單選的提示，Telegram、Discord 和 Slack 會顯示原生按鈕。
• 純文字回覆適用於任何頻道。你可以回覆數字、選項標籤， 或自行輸入答案。

OpenClaw 一律提供可輸入自由文字的 其他 答案。代理程式不得在編寫的選項清單中加入 Other 選項。

平台行為

所有支援的對話介面都可回答問題。網頁版控制介面使用 停駐式步驟導覽，展開時會取代輸入框；收合後則會在精簡的問題列下方恢復 完整輸入框。iOS、macOS 和 Android 會顯示 行內卡片；多個問題會保持堆疊，這是刻意採用、方便觸控操作的 呈現方式。每個平台都會在使用中的聊天 時間軸保留問題與回答摘要，不會定時移除，且所有平台都提供 略過。

無法使用原生按鈕的提示，包括多問題和 多選提示，在頻道中會降級為易讀的文字。控制介面 則會保留完整的結構化步驟導覽。

逾時與未回答

預設逾時時間為 900 秒。timeoutSeconds 會限制在 30 至 3600 秒的範圍內。

如果問題在收到回答前到期或遭取消，工具會 傳回 status: "no_answer"。接著，代理程式會依其最佳判斷繼續執行。 代理程式執行中止時，會取消其待處理的閘道問題。

工具結構描述

{  questions: Array<{    id: string; // 唯一的 snake_case 回答鍵    header: string; // 簡短標籤；截短為 12 個字元    question: string; // 一個句子    options: Array<{      label: string;      description?: string;    }>; // 2-4 個選項    multiSelect?: boolean;  }>; // 1-3 個問題  timeoutSeconds?: number; // 整數；預設值為 900，限制在 30-3600}

使用 multiSelect: true 時，使用者可選擇多個選項。每個問題的回答 值都會以陣列形式傳回。

已回答結果範例：

{  "status": "answered",  "answers": {    "answers": {      "deploy_target": ["Staging (Recommended)"]    }  }}

模型指引

面向模型的契約會指示代理程式：

• 僅在確實需要由使用者決定的事項導致作業受阻時提問；
• 以一個問題為優先，且不得超過三個；
• 將建議選項放在第一個，並在其標籤後加上 (Recommended)；
• 省略自行編寫的 Other 選項，因為系統會自動加入自由文字輸入；
• 在 no_answer 後依最佳判斷繼續執行。

代理程式不應使用 ask_user 詢問是否可以繼續，也不應用它來確認 自己的計畫。