Overview
概覽
使用本頁選擇適合的功能介面。工具是可呼叫的動作，Skills 用於教導代理如何工作，而外掛則會新增執行階段功能，例如工具、供應商、頻道、鉤子與封裝的 Skills。
本頁是概覽與導覽頁面。如需完整的工具政策、預設值、群組成員資格、供應商限制與設定欄位，請參閱工具與自訂供應商。
從這裡開始
對多數代理而言，請先從內建工具類別開始，只有在代理應看到較少工具或需要明確的主機存取權時，才調整政策。
| 如果你需要…… | 請先使用 | 接著閱讀 |
|---|---|---|
| 讓代理使用現有功能執行動作 | 內建工具 | 工具類別 |
| 控制代理可呼叫的項目 | 工具政策 | 工具與自訂供應商 |
| 教導代理工作流程 | Skills | Skills、建立 Skills、Skill 工作坊與自我學習 |
| 新增整合或執行階段介面 | 外掛 | 外掛與建置外掛 |
| 稍後或在背景執行工作 | 自動化 | 自動化概覽 |
| 協調多個代理或測試框架 | 子代理 | ACP 代理與代理傳送 |
| 從程式碼協調並行代理 | 群集 | 程式碼模式與子代理 |
| 搜尋大型 OpenClaw 工具目錄 | 工具搜尋 | 工具搜尋 |
| 在一個精簡程式中結合多項工具 | 程式碼模式 | 程式碼模式 |
選擇工具、Skills 或外掛
當代理需要執行動作時，使用工具
工具是代理可呼叫的具型別函式，例如 exec、browser、
web_search、message 或 image_generate。當代理需要
讀取資料、變更檔案、傳送訊息、呼叫供應商或操作其他系統時，請使用工具。
可見的工具會以結構化函式定義的形式傳送給模型。
模型只會看到通過目前設定檔、允許／拒絕政策、供應商限制、 沙箱狀態、頻道權限與外掛可用性篩選的工具。
當代理需要指示時，使用 Skill
Skill 是載入代理提示詞中的 SKILL.md 指示套件。當代理已具備所需工具，
但需要可重複使用的工作流程、審查準則、命令順序或操作限制時，請使用 Skill。
Skills 可以位於工作區、共用 Skill 目錄、受管理的 OpenClaw Skill 根目錄或外掛套件中。
當 OpenClaw 需要新功能時，使用外掛
外掛可以新增工具、Skills、頻道、模型供應商、語音、 即時語音、媒體生成、網頁搜尋、網頁擷取、鉤子與其他 執行階段功能。當功能包含程式碼、認證資訊、生命週期鉤子、 資訊清單中繼資料或可安裝的封裝時，請使用外掛。 現有外掛可從 ClawHub、npm、git、本機目錄或封存檔安裝。
內建工具類別
此表列出代表性工具，協助你辨識其介面；它並非完整的政策參考。如需確切的群組、預設值與允許／拒絕語意，請參閱工具與自訂供應商。
| 類別 | 適用於代理需要…… | 代表性工具 | 接著閱讀 |
|---|---|---|---|
| 執行階段 | 執行命令、管理程序，或使用供應商支援的 Python 分析 | exec、process、terminal、code_execution |
執行、控制介面終端機、程式碼執行 |
| 檔案 | 讀取及變更工作區檔案 | read、write、edit、apply_patch |
套用修補程式 |
| 人工輸入 | 暫停並等待由使用者決定的結構化選項 | ask_user |
詢問使用者 |
| 網頁 | 搜尋網頁、搜尋 X 貼文，或擷取可讀的頁面內容 | web_search、x_search、web_fetch |
網頁工具、網頁擷取 |
| 瀏覽器 | 操作瀏覽器工作階段 | browser |
瀏覽器 |
| 操作員介面 | 排列已連線的控制介面窗格、面板與導覽 | screen |
畫面 |
| 訊息與頻道 | 傳送回覆或執行頻道動作 | message |
代理傳送 |
| 工作階段與代理 | 檢查工作階段、委派工作、協調收集器、引導另一個執行程序或回報狀態 | sessions_*、agents_wait、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 目錄 | 搜尋、呼叫及結合多項符合資格的工具，而不將每個結構描述都傳送給模型 | exec、wait、tool_search_code、tool_search、tool_describe |
程式碼模式、工具搜尋 |
外掛提供的工具
外掛可以註冊其他工具。外掛作者會透過
api.registerTool(...) 與資訊清單的 contracts.tools 串接工具；如需
合約詳細資訊，請參閱外掛 SDK與外掛資訊清單。
常見的外掛提供工具包括：
- 差異，用於呈現檔案與 Markdown 差異
- 顯示小工具，用於在支援的聊天用戶端中顯示自包含的行內 SVG 與 HTML
- 螢幕，用於配置已連線的控制介面
- LLM 任務，用於僅輸出 JSON 的工作流程步驟
- Lobster，用於具備可恢復核准機制的型別化工作流程
- Tokenjuice，用於壓縮嘈雜的
exec與bash工具 輸出 - 工具搜尋，用於探索及呼叫大型工具 目錄，而不必將每個結構描述都放入提示中
- 畫布，用於節點畫布控制與 A2UI 呈現
設定存取權與核准
工具政策會在模型呼叫前強制執行。如果政策移除某項工具， 模型在該回合就不會收到該工具的結構描述。執行可能會因全域設定、 各代理程式設定、頻道政策、提供者限制、沙箱規則、 頻道／執行階段政策或外掛可用性而失去工具。
- 工具與自訂提供者說明工具設定檔、 允許／拒絕清單、提供者特定限制、迴圈偵測，以及 提供者支援的工具設定。
- 執行核准說明主機命令核准 政策。
- 提高權限執行說明在沙箱外進行的受控 執行。
- 沙箱、工具政策與提高權限的比較 說明哪一層控制檔案與程序存取。
- 各代理程式的沙箱與工具限制 說明委派執行的代理程式特定限制。
擴充功能
依據你需要 OpenClaw 執行的工作，選擇擴充途徑：
- 使用外掛安裝或管理現有外掛。
- 使用建置外掛建立新的整合、提供者、頻道、工具或掛鉤。
- 使用 Skills 與建立 Skills 新增或調整可重複使用的代理程式指示。
- 需要實作契約時，請使用外掛 SDK 與 外掛資訊清單。
疑難排解缺少的工具
如果模型看不到或無法呼叫某項工具，請先檢查目前回合的有效政策：
- 在工具與自訂提供者中檢查作用中的設定檔、
tools.allow與tools.deny。 - 在工具與自訂提供者中檢查提供者特定限制，並確認所選的 模型提供者支援該工具 形式。
- 使用沙箱、工具政策與提高權限的比較 與提高權限執行，檢查頻道權限、沙箱狀態及提高權限存取。
- 在外掛中檢查擁有該工具的外掛是否已安裝並啟用。
- 對於委派執行，請在各代理程式的沙箱與工具限制中檢查各代理程式的限制。
- 對於大型 OpenClaw 目錄，請確認執行使用的是直接公開工具、程式碼模式，還是工具搜尋。
