從這裡開始
對大多數代理而言，請先從內建工具類別開始，再只在代理應看到較少工具 或需要明確主機存取權時調整政策。選擇工具、Skills 或外掛
當代理需要行動時使用工具
工具是代理可以呼叫的型別化函式，例如
exec、browser、
web_search、message 或 image_generate。當代理需要讀取資料、
變更檔案、傳送訊息、呼叫供應商或操作另一個系統時，請使用工具。
可見工具會以結構化函式定義傳送給模型。模型只會看到通過作用中設定檔、允許/拒絕政策、供應商限制、
沙盒狀態、頻道權限與外掛可用性的工具。當代理需要指示時使用 Skill
Skill 是載入到代理提示中的
SKILL.md 指示包。當代理已經具備所需工具，
但需要可重複的工作流程、審查準則、命令序列或操作限制時，請使用
Skill。Skills 可以位於工作區、共享 Skill 目錄、受管理的 OpenClaw
Skill 根目錄，或外掛套件中。Skills | Skill Workshop | 建立 Skills | Skills 設定內建工具類別
此表列出代表性工具，方便你辨識介面。這不是完整的政策參考。 如需精確的群組、預設值與允許/拒絕語意，請使用 工具與自訂供應商。| 類別 | 當代理需要……時使用 | 代表性工具 | 接著閱讀 |
|---|---|---|---|
| 執行階段 | 執行命令、管理程序，或使用供應商支援的 Python 分析 | exec、process、code_execution | Exec、程式碼執行 |
| 檔案 | 讀取與變更工作區檔案 | read、write、edit、apply_patch | 套用修補 |
| Web | 搜尋網頁、搜尋 X 貼文，或擷取可讀頁面內容 | web_search、x_search、web_fetch | Web 工具、Web 擷取 |
| 瀏覽器 | 操作瀏覽器工作階段 | browser | 瀏覽器 |
| 訊息與頻道 | 傳送回覆或頻道動作 | message | 代理傳送 |
| 工作階段與代理 | 檢查工作階段、委派工作、引導另一個執行，或回報狀態 | sessions_*、subagents、agents_list、session_status、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 目錄，請確認該執行使用直接工具公開，還是 工具搜尋。