Overview

概覽

使用此頁面選擇合適的能力介面。工具是可呼叫的動作，Skills教導代理如何工作，而外掛則新增執行階段能力，例如工具、提供者、頻道、鉤子與封裝的 Skills。

這是一個概覽與導覽頁面。如需完整的工具政策、預設值、群組成員資格、提供者限制及設定欄位，請參閱工具與自訂提供者。

從這裡開始

對大多數代理而言，請先從內建工具類別開始，只有在代理應看到較少工具或需要明確的主機存取權時，才調整政策。

工具是代理可呼叫的具型別函式，例如 exec、browser、 web_search、message 或 image_generate。當代理需要讀取資料、變更檔案、傳送訊息、呼叫提供者或操作其他系統時，請使用工具。可見的工具會以結構化函式定義傳送給模型。

模型只會看到通過目前設定檔、允許／拒絕政策、提供者限制、沙箱狀態、頻道權限及外掛可用性篩選的工具。

Skill 是載入代理提示中的 SKILL.md 指示套件。當代理已具備所需工具，但需要可重複使用的工作流程、審查準則、命令序列或操作限制時，請使用 Skill。

Skills 可以位於工作區、共用 Skill 目錄、受管理的 OpenClaw Skill 根目錄或外掛套件中。

外掛可以新增工具、Skills、頻道、模型提供者、語音、即時語音、媒體生成、網頁搜尋、網頁擷取、鉤子及其他執行階段能力。當能力包含程式碼、憑證、生命週期鉤子、資訊清單中繼資料或可安裝套件時，請使用外掛。現有外掛可從 ClawHub、npm、git、本機目錄或封存檔安裝。

此表列出代表性工具，協助你識別各個介面；它並不是完整的政策參考。如需確切群組、預設值及允許／拒絕語意，請參閱工具與自訂提供者。

類別	適用於代理需要……	代表性工具	接著閱讀
執行階段	執行命令、管理程序，或使用提供者支援的 Python 分析	`exec`、`process`、`code_execution`	執行命令、程式碼執行
檔案	讀取及變更工作區檔案	`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`	工具搜尋

外掛可以註冊額外的工具。外掛作者透過 api.registerTool(...) 及資訊清單的 contracts.tools 連接工具；如需合約詳細資訊，請參閱外掛 SDK與外掛資訊清單。

常見的外掛提供工具包括：

工具政策會在模型呼叫前執行。如果政策移除某項工具，模型在該次執行中不會收到該工具的結構描述。執行作業可能因全域設定、個別代理設定、頻道政策、提供者限制、沙箱規則、頻道／執行階段政策或外掛可用性而失去工具。

請依照你需要 OpenClaw 完成的工作選擇擴充途徑：

如果模型無法看到或呼叫某項工具，請先檢查目前執行回合的有效政策：