從這裡開始
對大多數代理而言，先從內建工具類別開始，然後只在代理應該看到較少工具或需要明確主機存取權時調整政策。選擇工具、Skills 或外掛
Use a tool when the agent needs to act
工具是代理可以呼叫的型別化函式，例如
exec、browser、
web_search、message 或 image_generate。當代理需要讀取資料、
變更檔案、傳送訊息、呼叫供應商，或操作另一個系統時，請使用工具。
可見工具會以結構化函式定義的形式傳送給模型。模型只會看到通過作用中設定檔、允許/拒絕政策、供應商限制、沙箱狀態、
頻道權限，以及外掛可用性篩選後的工具。Use a skill when the agent needs instructions
Skill 是載入代理提示中的
SKILL.md 指令包。當代理已經具備所需工具，
但需要可重複的工作流程、審查準則、命令序列或操作限制時，請使用
Skill。Skills 可以存在於工作區、共用 Skill 目錄、受管理的 OpenClaw
Skill 根目錄，或外掛套件中。Skills | Skill Workshop | 建立 Skills | Skills 設定內建工具類別
此表列出代表性工具，讓你能辨識介面。它不是完整的政策參考。若要查看精確群組、 預設值，以及允許/拒絕語意，請使用工具與自訂供應商。| 類別 | 當代理需要……時使用 | 代表性工具 | 接著閱讀 |
|---|---|---|---|
| 執行階段 | 執行命令、管理程序，或使用供應商支援的 Python 分析 | exec、process、code_execution | Exec、程式碼執行 |
| 檔案 | 讀取與變更工作區檔案 | read、write、edit、apply_patch | 套用修補 |
| 網頁 | 搜尋網頁、搜尋 X 貼文，或擷取可讀頁面內容 | web_search、x_search、web_fetch | 網頁工具、網頁擷取 |
| 瀏覽器 | 操作瀏覽器工作階段 | browser | 瀏覽器 |
| 訊息與頻道 | 傳送回覆或頻道動作 | message | 代理傳送 |
| 工作階段與代理 | 檢查工作階段、委派工作、引導另一個執行，或回報狀態 | sessions_*、subagents、agents_list、session_status、get_goal、create_goal、update_goal | 目標、子代理、工作階段工具 |
| 自動化 | 排程工作或回應背景事件 | cron、heartbeat_respond | 自動化 |
| 閘道與節點 | 檢查閘道狀態或已配對的目標裝置 | gateway、nodes | 閘道設定、節點 |
| 媒體 | 分析、生成或朗讀媒體 | image、image_generate、music_generate、video_generate、tts | 媒體概覽 |
| 大型 OpenClaw 目錄 | 搜尋並呼叫許多符合資格的工具，而不將每個結構描述傳送給模型 | tool_search_code、tool_search、tool_describe | 工具搜尋 |
工具搜尋是實驗性的 OpenClaw 代理介面。Codex 測試框架執行會使用
Codex 原生程式碼模式、原生工具搜尋、延遲動態工具，以及巢狀工具呼叫，
而不是
tools.toolSearch。外掛提供的工具
外掛可以註冊額外工具。外掛作者透過api.registerTool(...) 與清單的
contracts.tools 連接工具；合約詳細資訊請使用外掛 SDK
與外掛清單。
常見的外掛提供工具包括：
- 差異，用於呈現檔案與 Markdown 差異
- LLM 任務，用於僅限 JSON 的工作流程步驟
- Lobster，用於具備可恢復核准的型別化工作流程
- Tokenjuice，用於壓縮嘈雜的
exec與bash工具 輸出 - 工具搜尋，用於探索並呼叫大型工具目錄，而不將每個結構描述放入提示
- Canvas，用於節點 Canvas 控制與 A2UI 呈現
設定存取權與核准
工具政策會在模型呼叫之前強制執行。如果政策移除某個工具，模型在該回合不會收到該工具的結構描述。 一次執行可能因為全域設定、個別代理設定、頻道政策、供應商限制、沙箱規則、 頻道/執行階段政策，或外掛可用性而失去工具。- 工具與自訂供應商記錄工具設定檔、 允許/拒絕清單、供應商特定限制、迴圈偵測，以及 供應商支援的工具設定。
- Exec 核准記錄主機命令核准 政策。
- 提升權限 exec記錄沙箱外的受控執行。
- 沙箱、工具政策與提升權限 說明哪一層控制檔案與程序存取。
- 個別代理沙箱與工具限制 記錄委派執行的代理特定限制。
擴充功能
依照你需要 OpenClaw 執行的工作選擇擴充路徑：- 使用外掛安裝或管理現有外掛。
- 使用建置外掛建置新的整合、供應商、頻道、工具或鉤子。
- 使用 Skills 與建立 Skills新增或調整可重複使用的代理指令。
- 當你需要實作合約時，使用外掛 SDK與 外掛清單。
疑難排解遺失的工具
如果模型看不到或無法呼叫某個工具，請先從目前回合的有效政策開始：- 檢查工具與自訂供應商中的作用中設定檔、
tools.allow與tools.deny。 - 檢查工具與自訂供應商中的供應商特定限制， 並確認所選模型供應商支援該工具形狀。
- 使用沙箱、工具政策與提升權限 與提升權限 exec檢查頻道權限、沙箱狀態與提升權限存取。
- 檢查擁有該工具的外掛是否已在外掛中安裝並啟用。
- 對於委派執行，請檢查個別代理沙箱與工具限制中的個別代理限制。
- 對於大型 OpenClaw 目錄，請確認該執行使用直接工具暴露還是工具搜尋。