跳轉到主要內容
ask_user 可讓代理程式向使用者提出一至三個結構化問題,並 等待回答。此工具用於確實應由使用者決定的事項, 而非例行確認,或代理程式能從要求、程式碼或合理預設值 推導出的資訊。 此工具僅適用於主要工作階段。子代理程式及其他非主要 執行不會取得此工具。

回答問題

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

平台行為

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

逾時與未回答

預設逾時時間為 900 秒。timeoutSeconds 會限制在 30 至 3600 秒的範圍內。 如果問題在收到回答前到期或遭取消,工具會 傳回 status: "no_answer"。接著,代理程式會依其最佳判斷繼續執行。 代理程式執行中止時,會取消其待處理的閘道問題。

工具結構描述

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

模型指引

面向模型的契約會指示代理程式:
  • 僅在確實需要由使用者決定的事項導致作業受阻時提問;
  • 以一個問題為優先,且不得超過三個;
  • 將建議選項放在第一個,並在其標籤後加上 (Recommended)
  • 省略自行編寫的 Other 選項,因為系統會自動加入自由文字輸入;
  • no_answer 後依最佳判斷繼續執行。
代理程式不應使用 ask_user 詢問是否可以繼續,也不應用它來確認 自己的計畫。