Skip to content
OpenClaw Docs

概覽

使用此頁面選擇正確的「功能」介面。工具是可呼叫的動作，技能教導代理程式如何運作，而外掛程式則新增執行階段功能，例如工具、提供者、通道、掛鉤和封裝的技能。

這是一個總覽和路由頁面。如需完整的工具政策、預設值、群組成員資格、提供者限制和設定欄位，請使用 工具和自訂提供者。

從這裡開始

Section titled “從這裡開始”

對於大多數代理程式，請先從內建工具類別開始，然後僅在代理程式應該看到較少工具或需要明確主機存取權時調整政策。

如果您需要…先使用這個然後閱讀
讓代理程式使用現有功能進行動作內建工具工具類別
控制代理程式可以呼叫的內容工具政策工具和自訂提供者
教導代理程式工作流程技能技能 和 建立技能
新增新的整合或執行階段介面外掛程式外掛程式 和 建置外掛程式
稍後或在背景執行工作自動化自動化總覽
協調多個代理程式或線束子代理程式ACP 代理程式 和 代理程式傳送
搜尋大型 PI 工具目錄工具搜尋工具搜尋

選擇工具、技能或外掛程式

Section titled “選擇工具、技能或外掛程式”

  1. 當代理需要執行操作時使用工具

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

    模型只能看到那些通過了啟用設定檔、允許/拒絕 原則、供應商限制、沙箱狀態、通道權限 和外掛程式可用性檢查的工具。

  2. 當代理需要指示時使用技能

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

    技能可以存在於工作區、共用技能目錄、受控的 OpenClaw 技能根目錄或外掛程式套件中。

    技能 | 建立技能 | 技能設定

  3. 當 OpenClaw 需要新功能時使用外掛程式

    外掛程式可以新增工具、技能、通道、模型供應商、語音、即時 語音、媒體生成、網路搜尋、網路擷取、掛鉤和其他執行時 功能。當功能包含程式碼、認證資訊、 生命週期掛鉤、清單元資料或可安裝套件時，請使用外掛程式。現有的 外掛程式可以從 ClawHub、npm、git、本機目錄或 封存檔案安裝。

    安裝和設定外掛程式 | 建置外掛程式 | 外掛程式 SDK

內建工具類別

Section titled “內建工具類別”

該表列出了代表性工具，以便您識別相關介面。這並 非完整的原則參考。如需確切的群組、預設值和允許/拒絕 語意，請使用 工具和自訂供應商。

類別當代理需要時使用…代表性工具閱讀下一步
Runtime執行指令、管理程序，或使用供應商支援的 Python 分析exec, process, code_executionExec, Code execution
檔案讀取和變更工作區檔案read, write, edit, apply_patchApply patch
Web搜尋網路、搜尋 X 帖文，或取得可讀取的頁面內容web_search, x_search, web_fetchWeb tools, Web fetch
瀏覽器操作瀏覽器工作階段browserBrowser
訊息傳遞與頻道傳送回覆或頻道動作messageAgent send
工作階段與代理程式檢查工作階段、委派工作、引導另一個執行，或回報狀態sessions_*, subagents, agents_list, session_statusSub-agents, Session tool
自動化排程工作或回應背景事件cron, heartbeat_respondAutomation
閘道與節點檢查閘道狀態或已配對的目標裝置gateway, nodesGateway configuration, Nodes
媒體分析、產生或說出媒體內容image, image_generate, music_generate, video_generate, ttsMedia overview
大型 PI 目錄搜尋並呼叫許多符合資格的工具，無需將每個架構傳送至模型tool_search_code, tool_search, tool_describe工具搜尋

外掛程式提供的工具

Section titled “外掛程式提供的工具”

外掛程式可以註冊其他工具。外掛程式作者透過 api.registerTool(...) 和清單的 contracts.tools 連線工具；請使用 外掛程式 SDK 和 外掛程式清單 了解合約詳細資訊。

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

  • Diffs 用於呈現檔案和 markdown 差異
  • LLM Task 用於僅限 JSON 的工作流程步驟
  • Lobster 用於具有可恢復核准的類型化工作流程
  • Tokenjuice 用於壓縮嘈雜的 exec 和 bash 工具 輸出
  • 工具搜尋 用於探索和呼叫大型工具 目錄，而無需將每個架構放入提示中
  • Canvas 用於節點 Canvas 控制和 A2UI 呈現

設定存取和核准

Section titled “設定存取和核准”

工具政策會在模型呼叫之前強制執行。如果政策移除了工具，模型 在該輪次中不會收到該工具的架構。執行可能會因為全域設定、每個代理程式的設定、通道政策、供應商 限制、沙箱規則、僅限擁有者的閘道，或外掛程式可用性而失去工具。

擴充功能

Section titled “擴充功能”

根據您需要 OpenClaw 執行的工作來選擇擴充路徑：

疑難排解缺少的工具

Section titled “疑難排解缺少的工具”

如果模型無法看到或呼叫工具，請從目前輪次的有效原則開始：

  1. 請在 工具與自訂提供者 中檢查使用中的設定檔、tools.allow 和 tools.deny。
  2. 請在 工具與自訂提供者 中檢查特定提供者的限制，並確認選取的 模型提供者 支援該工具類型。
  3. 請使用 沙箱與工具原則與提升權限 和 提升執行權限 檢查通道權限、沙箱狀態和提升權限存取。
  4. 請在 外掛程式 中檢查擁有者外掛程式是否已安裝並啟用。
  5. 對於委派執行，請在 每個代理程式的沙箱與工具限制 中檢查特定代理程式的限制。
  6. 對於大型 PI 目錄，請確認執行是使用直接工具公開還是 工具搜尋。

相關主題

Section titled “相關主題”