Overview

Tổng quan

Dùng trang này để chọn đúng bề mặt Capabilities. Công cụ là các hành động có thể gọi, Skills dạy tác tử cách làm việc, và Plugin thêm các capability thời gian chạy như công cụ, nhà cung cấp, kênh, hook và Skills được đóng gói.

Đây là trang tổng quan và định tuyến. Để xem đầy đủ chính sách công cụ, mặc định, thành viên nhóm, hạn chế theo nhà cung cấp và các trường cấu hình, hãy dùng Công cụ và nhà cung cấp tùy chỉnh.

Bắt đầu tại đây

Với hầu hết tác tử, hãy bắt đầu bằng các danh mục công cụ tích hợp sẵn, rồi điều chỉnh chính sách chỉ khi tác tử nên thấy ít công cụ hơn hoặc cần quyền truy cập máy chủ rõ ràng.

Nếu bạn cần...	Dùng mục này trước	Sau đó đọc
Cho phép tác tử hành động bằng các capability sẵn có	Công cụ tích hợp sẵn	Danh mục công cụ
Kiểm soát tác tử có thể gọi gì	Chính sách công cụ	Công cụ và nhà cung cấp tùy chỉnh
Dạy tác tử một workflow	Skills	Skills, Tạo Skills, và Skill Workshop
Thêm tích hợp mới hoặc bề mặt thời gian chạy	Plugin	Plugin và Xây dựng Plugin
Chạy công việc sau hoặc trong nền	Tự động hóa	Tổng quan về tự động hóa
Điều phối nhiều tác tử hoặc harness	Tác tử phụ	Tác tử ACP và Gửi tác tử
Tìm kiếm một danh mục công cụ OpenClaw lớn	Tìm kiếm công cụ	Tìm kiếm công cụ

Chọn công cụ, Skills hoặc Plugin

Use a tool when the agent needs to act

Công cụ là một hàm có kiểu mà tác tử có thể gọi, chẳng hạn như exec, browser, web_search, message, hoặc image_generate. Dùng công cụ khi tác tử cần đọc dữ liệu, thay đổi tệp, gửi tin nhắn, gọi một nhà cung cấp, hoặc vận hành hệ thống khác. Các công cụ hiển thị được gửi đến mô hình dưới dạng định nghĩa hàm có cấu trúc.

Mô hình chỉ thấy các công cụ vượt qua hồ sơ đang hoạt động, chính sách cho phép/từ chối, hạn chế theo nhà cung cấp, trạng thái sandbox, quyền của kênh và tình trạng sẵn có của Plugin.

Use a skill when the agent needs instructions

Skill là một gói chỉ dẫn SKILL.md được nạp vào prompt của tác tử. Dùng Skill khi tác tử đã có các công cụ cần thiết, nhưng cần một workflow có thể lặp lại, rubric đánh giá, chuỗi lệnh, hoặc ràng buộc vận hành.

Skills có thể nằm trong workspace, thư mục Skill dùng chung, gốc Skill do OpenClaw quản lý, hoặc gói Plugin.

Skills | Skill Workshop | Tạo Skills | Cấu hình Skills

Use a plugin when OpenClaw needs a new capability

Plugin có thể thêm công cụ, Skills, kênh, nhà cung cấp mô hình, giọng nói, thoại thời gian thực, tạo media, tìm kiếm web, lấy nội dung web, hook và các capability thời gian chạy khác. Dùng Plugin khi capability có mã, thông tin xác thực, hook vòng đời, siêu dữ liệu manifest hoặc gói có thể cài đặt. Plugin hiện có có thể được cài đặt từ ClawHub, npm, git, thư mục cục bộ, hoặc tệp lưu trữ.

Cài đặt và cấu hình Plugin | Xây dựng Plugin | Plugin SDK

Danh mục công cụ tích hợp sẵn

Bảng này liệt kê các công cụ đại diện để bạn có thể nhận diện bề mặt. Đây không phải tài liệu tham chiếu chính sách đầy đủ. Để biết chính xác các nhóm, mặc định và ngữ nghĩa cho phép/từ chối, hãy dùng Công cụ và nhà cung cấp tùy chỉnh.

Danh mục	Dùng khi tác tử cần...	Công cụ đại diện	Đọc tiếp
Thời gian chạy	Chạy lệnh, quản lý tiến trình, hoặc dùng phân tích Python dựa trên nhà cung cấp	`exec`, `process`, `code_execution`	Exec, Thực thi mã
Tệp	Đọc và thay đổi tệp trong workspace	`read`, `write`, `edit`, `apply_patch`	Áp dụng bản vá
Web	Tìm kiếm web, tìm kiếm bài đăng X, hoặc lấy nội dung trang có thể đọc	`web_search`, `x_search`, `web_fetch`	Công cụ web, Lấy nội dung web
Trình duyệt	Vận hành một phiên trình duyệt	`browser`	Trình duyệt
Nhắn tin và kênh	Gửi phản hồi hoặc hành động kênh	`message`	Gửi tác tử
Phiên và tác tử	Kiểm tra phiên, ủy quyền công việc, điều hướng lượt chạy khác, hoặc báo cáo trạng thái	`sessions_*`, `subagents`, `agents_list`, `session_status`, `goal`	Mục tiêu, Tác tử phụ, Công cụ phiên
Tự động hóa	Lên lịch công việc hoặc phản hồi sự kiện nền	`cron`, `heartbeat_respond`	Tự động hóa
Gateway và node	Kiểm tra trạng thái Gateway hoặc thiết bị đích đã ghép nối	`gateway`, `nodes`	Cấu hình Gateway, Node
Media	Phân tích, tạo hoặc nói media	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`	Tổng quan media
Danh mục OpenClaw lớn	Tìm kiếm và gọi nhiều công cụ đủ điều kiện mà không gửi mọi schema đến mô hình	`tool_search_code`, `tool_search`, `tool_describe`	Tìm kiếm công cụ

Công cụ do Plugin cung cấp

Plugin có thể đăng ký thêm công cụ. Tác giả Plugin nối công cụ qua api.registerTool(...) và contracts.tools của manifest; dùng Plugin SDK và Plugin manifest để xem chi tiết hợp đồng.

Các công cụ phổ biến do Plugin cung cấp gồm:

Diff để render diff tệp và markdown
LLM Task cho các bước workflow chỉ dùng JSON
Lobster cho workflow có kiểu với phê duyệt có thể tiếp tục
Tokenjuice để nén đầu ra công cụ exec và bash nhiều nhiễu
Tìm kiếm công cụ để khám phá và gọi các danh mục công cụ lớn mà không đưa mọi schema vào prompt
Canvas để điều khiển node Canvas và render A2UI

Cấu hình quyền truy cập và phê duyệt

Chính sách công cụ được thực thi trước lời gọi mô hình. Nếu chính sách loại bỏ một công cụ, mô hình sẽ không nhận schema của công cụ đó cho lượt này. Một lượt chạy có thể mất công cụ vì cấu hình toàn cục, cấu hình theo tác tử, chính sách kênh, hạn chế theo nhà cung cấp, quy tắc sandbox, chính sách kênh/thời gian chạy, hoặc tình trạng sẵn có của Plugin.

Công cụ và nhà cung cấp tùy chỉnh ghi lại hồ sơ công cụ, danh sách cho phép/từ chối, hạn chế theo nhà cung cấp, phát hiện vòng lặp và thiết lập công cụ dựa trên nhà cung cấp.
Phê duyệt exec ghi lại chính sách phê duyệt lệnh máy chủ.
Exec nâng quyền ghi lại việc thực thi được kiểm soát bên ngoài sandbox.
Sandbox so với chính sách công cụ so với nâng quyền giải thích lớp nào kiểm soát quyền truy cập tệp và tiến trình.
Sandbox và hạn chế công cụ theo tác tử ghi lại các hạn chế riêng cho tác tử trong lượt chạy được ủy quyền.

Mở rộng capability

Chọn đường mở rộng theo công việc bạn cần OpenClaw thực hiện:

Cài đặt hoặc quản lý Plugin hiện có bằng Plugin.
Xây dựng tích hợp, nhà cung cấp, kênh, công cụ hoặc hook mới bằng Xây dựng Plugin.
Thêm hoặc tinh chỉnh chỉ dẫn tác tử có thể tái sử dụng bằng Skills và Tạo Skills.
Dùng Plugin SDK và Plugin manifest khi bạn cần các hợp đồng triển khai.

Khắc phục sự cố thiếu công cụ

Nếu mô hình không thể thấy hoặc gọi một công cụ, hãy bắt đầu bằng chính sách hiệu lực cho lượt hiện tại:

Kiểm tra hồ sơ đang hoạt động, tools.allow, và tools.deny trong Công cụ và nhà cung cấp tùy chỉnh.
Kiểm tra hạn chế theo nhà cung cấp trong Công cụ và nhà cung cấp tùy chỉnh và xác nhận nhà cung cấp mô hình đã chọn hỗ trợ hình dạng công cụ.
Kiểm tra quyền của kênh, trạng thái sandbox và quyền truy cập nâng quyền bằng Sandbox so với chính sách công cụ so với nâng quyền và Exec nâng quyền.
Kiểm tra Plugin sở hữu đã được cài đặt và bật trong Plugin.
Với lượt chạy được ủy quyền, kiểm tra hạn chế theo tác tử trong Sandbox và hạn chế công cụ theo tác tử.
Với các danh mục OpenClaw lớn, xác nhận lượt chạy dùng phơi bày công cụ trực tiếp hay Tìm kiếm công cụ.

Liên quan

Tự động hóa cho cron, tác vụ, heartbeat, cam kết, hook, lệnh thường trực và Task Flow
Tác tử cho mô hình tác tử, phiên, bộ nhớ và điều phối nhiều tác tử
Công cụ và nhà cung cấp tùy chỉnh cho tài liệu tham chiếu chính sách công cụ chuẩn
Plugin cho cài đặt và quản lý Plugin
Plugin SDK cho tài liệu tham chiếu dành cho tác giả Plugin
Skills cho thứ tự nạp Skill, gating và cấu hình
Skill Workshop cho việc tạo Skill được sinh và được đánh giá
Tìm kiếm công cụ cho khám phá danh mục công cụ OpenClaw gọn nhẹ

Was this useful?