從這裡開始
對多數代理而言，請先從內建工具類別開始，只有在代理應看到較少工具或需要明確的主機存取權時，才調整政策。選擇工具、Skills 或外掛
1
當代理需要執行動作時，使用工具
工具是代理可呼叫的具型別函式，例如
exec、browser、
web_search、message 或 image_generate。當代理需要
讀取資料、變更檔案、傳送訊息、呼叫供應商或操作其他系統時，請使用工具。
可見的工具會以結構化函式定義的形式傳送給模型。模型只會看到通過目前設定檔、允許／拒絕政策、供應商限制、
沙箱狀態、頻道權限與外掛可用性篩選的工具。2
內建工具類別
此表列出代表性工具，協助你辨識其介面；它並非完整的政策參考。如需確切的群組、預設值與允許／拒絕語意，請參閱工具與自訂供應商。程式碼模式與工具搜尋是實驗性的 OpenClaw 代理介面。Codex
測試框架執行會使用 Codex 原生程式碼模式、原生工具搜尋、延後載入的動態
工具與巢狀工具呼叫，而非
tools.codeMode 或 tools.toolSearch。外掛提供的工具
外掛可以註冊其他工具。外掛作者會透過api.registerTool(...) 與資訊清單的 contracts.tools 串接工具；如需
合約詳細資訊，請參閱外掛 SDK與外掛資訊清單。
常見的外掛提供工具包括：
- 差異，用於呈現檔案與 Markdown 差異
- 顯示小工具，用於在支援的聊天用戶端中顯示自包含的行內 SVG 與 HTML
- 螢幕，用於配置已連線的控制介面
- LLM 任務，用於僅輸出 JSON 的工作流程步驟
- Lobster，用於具備可恢復核准機制的型別化工作流程
- Tokenjuice，用於壓縮嘈雜的
exec與bash工具 輸出 - 工具搜尋，用於探索及呼叫大型工具 目錄，而不必將每個結構描述都放入提示中
- 畫布，用於節點畫布控制與 A2UI 呈現
設定存取權與核准
工具政策會在模型呼叫前強制執行。如果政策移除某項工具， 模型在該回合就不會收到該工具的結構描述。執行可能會因全域設定、 各代理程式設定、頻道政策、提供者限制、沙箱規則、 頻道／執行階段政策或外掛可用性而失去工具。- 工具與自訂提供者說明工具設定檔、 允許／拒絕清單、提供者特定限制、迴圈偵測，以及 提供者支援的工具設定。
- 執行核准說明主機命令核准 政策。
- 提高權限執行說明在沙箱外進行的受控 執行。
- 沙箱、工具政策與提高權限的比較 說明哪一層控制檔案與程序存取。
- 各代理程式的沙箱與工具限制 說明委派執行的代理程式特定限制。
擴充功能
依據你需要 OpenClaw 執行的工作，選擇擴充途徑：- 使用外掛安裝或管理現有外掛。
- 使用建置外掛建立新的整合、提供者、頻道、工具或掛鉤。
- 使用 Skills 與建立 Skills 新增或調整可重複使用的代理程式指示。
- 需要實作契約時，請使用外掛 SDK 與 外掛資訊清單。
疑難排解缺少的工具
如果模型看不到或無法呼叫某項工具，請先檢查目前回合的有效政策：- 在工具與自訂提供者中檢查作用中的設定檔、
tools.allow與tools.deny。 - 在工具與自訂提供者中檢查提供者特定限制，並確認所選的 模型提供者支援該工具 形式。
- 使用沙箱、工具政策與提高權限的比較 與提高權限執行，檢查頻道權限、沙箱狀態及提高權限存取。
- 在外掛中檢查擁有該工具的外掛是否已安裝並啟用。
- 對於委派執行，請在各代理程式的沙箱與工具限制中檢查各代理程式的限制。
- 對於大型 OpenClaw 目錄，請確認執行使用的是直接公開工具、程式碼模式，還是工具搜尋。