> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 概覽

使用此頁面選擇正確的能力介面。**工具**是可呼叫的
動作，**Skills** 教導代理如何工作，而**外掛**會新增執行階段
能力，例如工具、供應商、頻道、鉤子，以及封裝的 Skills。

這是一個概觀與導覽頁面。如需完整的工具政策、預設值、
群組成員資格、供應商限制與設定欄位，請使用
[工具與自訂供應商](/zh-TW/gateway/config-tools)。

## 從這裡開始

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

| 如果你需要……            | 請先使用                                      | 接著閱讀                                                                                                                    |
| ------------------ | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| 讓代理使用現有能力行動        | [內建工具](#built-in-tool-categories)         | [工具類別](#built-in-tool-categories)                                                                                       |
| 控制代理可以呼叫的內容        | [工具政策](#configure-access-and-approvals)   | [工具與自訂供應商](/zh-TW/gateway/config-tools)                                                                                 |
| 教導代理工作流程           | [Skills](#choose-tools-skills-or-plugins) | [Skills](/zh-TW/tools/skills)、[建立 Skills](/zh-TW/tools/creating-skills) 與 [Skill Workshop](/zh-TW/tools/skill-workshop) |
| 新增整合或執行階段介面        | [外掛](#extend-capabilities)                | [外掛](/zh-TW/tools/plugin) 與 [建置外掛](/zh-TW/plugins/building-plugins)                                                     |
| 稍後或在背景執行工作         | [自動化](/zh-TW/automation)                  | [自動化概觀](/zh-TW/automation)                                                                                              |
| 協調多個代理或測試框架        | [子代理](/zh-TW/tools/subagents)             | [ACP 代理](/zh-TW/tools/acp-agents) 與 [代理傳送](/zh-TW/tools/agent-send)                                                     |
| 搜尋大型 OpenClaw 工具目錄 | [工具搜尋](/zh-TW/tools/tool-search)          | [工具搜尋](/zh-TW/tools/tool-search)                                                                                        |

## 選擇工具、Skills 或外掛

<Steps>
  <Step title="當代理需要行動時使用工具">
    工具是代理可以呼叫的型別化函式，例如 `exec`、`browser`、
    `web_search`、`message` 或 `image_generate`。當代理需要讀取資料、
    變更檔案、傳送訊息、呼叫供應商或操作另一個系統時，請使用工具。
    可見工具會以結構化函式定義傳送給模型。

    模型只會看到通過作用中設定檔、允許/拒絕政策、供應商限制、
    沙盒狀態、頻道權限與外掛可用性的工具。
  </Step>

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

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

    [Skills](/zh-TW/tools/skills) | [Skill Workshop](/zh-TW/tools/skill-workshop) | [建立 Skills](/zh-TW/tools/creating-skills) | [Skills 設定](/zh-TW/tools/skills-config)
  </Step>

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

    [安裝與設定外掛](/zh-TW/tools/plugin) | [建置外掛](/zh-TW/plugins/building-plugins) | [外掛 SDK](/zh-TW/plugins/sdk-overview)
  </Step>
</Steps>

## 內建工具類別

此表列出代表性工具，方便你辨識介面。這不是完整的政策參考。
如需精確的群組、預設值與允許/拒絕語意，請使用
[工具與自訂供應商](/zh-TW/gateway/config-tools)。

| 類別             | 當代理需要……時使用                    | 代表性工具                                                            | 接著閱讀                                                                                         |
| -------------- | ----------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| 執行階段           | 執行命令、管理程序，或使用供應商支援的 Python 分析 | `exec`、`process`、`code_execution`                                | [Exec](/zh-TW/tools/exec)、[程式碼執行](/zh-TW/tools/code-execution)                               |
| 檔案             | 讀取與變更工作區檔案                    | `read`、`write`、`edit`、`apply_patch`                              | [套用修補](/zh-TW/tools/apply-patch)                                                             |
| Web            | 搜尋網頁、搜尋 X 貼文，或擷取可讀頁面內容        | `web_search`、`x_search`、`web_fetch`                              | [Web 工具](/zh-TW/tools/web)、[Web 擷取](/zh-TW/tools/web-fetch)                                  |
| 瀏覽器            | 操作瀏覽器工作階段                     | `browser`                                                        | [瀏覽器](/zh-TW/tools/browser)                                                                  |
| 訊息與頻道          | 傳送回覆或頻道動作                     | `message`                                                        | [代理傳送](/zh-TW/tools/agent-send)                                                              |
| 工作階段與代理        | 檢查工作階段、委派工作、引導另一個執行，或回報狀態     | `sessions_*`、`subagents`、`agents_list`、`session_status`、`goal`   | [目標](/zh-TW/tools/goal)、[子代理](/zh-TW/tools/subagents)、[工作階段工具](/zh-TW/concepts/session-tool) |
| 自動化            | 排定工作或回應背景事件                   | `cron`、`heartbeat_respond`                                       | [自動化](/zh-TW/automation)                                                                     |
| 閘道與節點          | 檢查閘道狀態或已配對的目標裝置               | `gateway`、`nodes`                                                | [閘道設定](/zh-TW/gateway/configuration)、[節點](/zh-TW/nodes)                                      |
| 媒體             | 分析、生成或朗讀媒體                    | `image`、`image_generate`、`music_generate`、`video_generate`、`tts` | [媒體概觀](/zh-TW/tools/media-overview)                                                          |
| 大型 OpenClaw 目錄 | 搜尋並呼叫許多符合資格的工具，而不將每個結構描述傳送給模型 | `tool_search_code`、`tool_search`、`tool_describe`                 | [工具搜尋](/zh-TW/tools/tool-search)                                                             |

<Note>
  工具搜尋是實驗性的 OpenClaw 代理介面。Codex 測試框架執行使用
  Codex 原生程式碼模式、原生工具搜尋、延後的動態工具，以及巢狀
  工具呼叫，而不是 `tools.toolSearch`。
</Note>

## 外掛提供的工具

外掛可以註冊額外工具。外掛作者會透過 `api.registerTool(...)`
與清單的 `contracts.tools` 接入工具；請使用
[外掛 SDK](/zh-TW/plugins/sdk-overview) 與 [外掛清單](/zh-TW/plugins/manifest)
了解合約詳細資訊。

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

* [差異](/zh-TW/tools/diffs)，用於呈現檔案與 Markdown 差異
* [LLM 任務](/zh-TW/tools/llm-task)，用於僅 JSON 的工作流程步驟
* [Lobster](/zh-TW/tools/lobster)，用於具備可續傳核准的型別化工作流程
* [Tokenjuice](/zh-TW/tools/tokenjuice)，用於壓縮嘈雜的 `exec` 與 `bash` 工具
  輸出
* [工具搜尋](/zh-TW/tools/tool-search)，用於探索並呼叫大型工具
  目錄，而不把每個結構描述放入提示中
* [Canvas](/zh-TW/plugins/reference/canvas)，用於節點 Canvas 控制與 A2UI
  轉譯

## 設定存取權與核准

工具政策會在模型呼叫前強制執行。如果政策移除某個工具，
模型在該回合不會收到該工具的結構描述。一次執行可能因為全域設定、
每代理設定、頻道政策、供應商限制、沙盒規則、頻道/執行階段政策
或外掛可用性而失去工具。

* [工具與自訂供應商](/zh-TW/gateway/config-tools) 記錄工具設定檔、
  允許/拒絕清單、供應商專屬限制、迴圈偵測，以及
  供應商支援的工具設定。
* [Exec 核准](/zh-TW/tools/exec-approvals) 記錄主機命令核准
  政策。
* [提升權限 exec](/zh-TW/tools/elevated) 記錄沙盒外受控執行。
* [沙盒、工具政策與提升權限](/zh-TW/gateway/sandbox-vs-tool-policy-vs-elevated) 說明哪一層控制檔案與程序存取。
* [每代理沙盒與工具限制](/zh-TW/tools/multi-agent-sandbox-tools)
  記錄委派執行的代理專屬限制。

## 擴充能力

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

* 使用[外掛](/zh-TW/tools/plugin)安裝或管理現有外掛。
* 使用[建置外掛](/zh-TW/plugins/building-plugins)建置新的整合、供應商、頻道、工具或鉤子。
* 使用 [Skills](/zh-TW/tools/skills) 與[建立 Skills](/zh-TW/tools/creating-skills)新增或調整可重用的代理指示。
* 需要實作合約時，請使用[外掛 SDK](/zh-TW/plugins/sdk-overview) 與[外掛清單](/zh-TW/plugins/manifest)。

## 疑難排解缺少的工具

如果模型看不到或無法呼叫某個工具，請從目前回合的有效政策開始：

1. 在[工具與自訂供應商](/zh-TW/gateway/config-tools)中檢查作用中設定檔、
   `tools.allow` 與 `tools.deny`。
2. 在[工具與自訂供應商](/zh-TW/gateway/config-tools)中檢查供應商專屬限制，
   並確認選取的[模型供應商](/zh-TW/concepts/model-providers)支援該工具形狀。
3. 使用[沙盒、工具政策與提升權限](/zh-TW/gateway/sandbox-vs-tool-policy-vs-elevated)與[提升權限 exec](/zh-TW/tools/elevated)
   檢查頻道權限、沙盒狀態與提升權限存取。
4. 在[外掛](/zh-TW/tools/plugin)中檢查擁有該工具的外掛是否已安裝並啟用。
5. 對於委派執行，請在[每代理沙盒與工具限制](/zh-TW/tools/multi-agent-sandbox-tools)中檢查每代理限制。
6. 對於大型 OpenClaw 目錄，請確認該執行使用直接工具公開，還是
   [工具搜尋](/zh-TW/tools/tool-search)。

## 相關

* [自動化](/zh-TW/automation)：排程、任務、心跳偵測、承諾、鉤子、常駐指令與任務流程
* [代理](/zh-TW/concepts/agent)：代理模型、工作階段、記憶體與多代理協調
* [工具與自訂供應商](/zh-TW/gateway/config-tools)：標準工具政策參考
* [外掛](/zh-TW/tools/plugin)：外掛安裝與管理
* [外掛 SDK](/zh-TW/plugins/sdk-overview)：外掛作者參考
* [Skills](/zh-TW/tools/skills)：Skill 載入順序、門控與設定
* [Skill Workshop](/zh-TW/tools/skill-workshop)：已生成並經審查的 Skill 建立
* [工具搜尋](/zh-TW/tools/tool-search)：精簡的 OpenClaw 工具目錄探索