Overview
Tổng quan
Sử dụng trang này để chọn bề mặt Khả năng phù hợp. Công cụ là các hành động có thể gọi, kỹ năng hướng dẫn agent cách làm việc, còn plugin bổ sung các khả năng thời gian chạy như công cụ, nhà cung cấp, kênh, hook và kỹ năng đóng gói.
Đây là trang tổng quan và định tuyến. Để xem đầy đủ chính sách công cụ, giá trị mặc định, thành viên nhóm, hạn chế của 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
Đối với hầu hết agent, hãy bắt đầu với các danh mục công cụ tích hợp sẵn, sau đó chỉ điều chỉnh chính sách khi agent cầ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... | Trước tiên hãy dùng | Sau đó đọc |
|---|---|---|
| Cho phép agent hành động bằng các khả năng hiện có | Công cụ tích hợp sẵn | Danh mục công cụ |
| Kiểm soát những gì agent có thể gọi | Chính sách công cụ | Công cụ và nhà cung cấp tùy chỉnh |
| Hướng dẫn agent một quy trình làm việc | Skills | Skills, Tạo kỹ năng, Xưởng kỹ năng và Tự học |
| Thêm tích hợp hoặc bề mặt thời gian chạy mới | 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 agent hoặc harness | Agent con | Agent ACP và Gửi qua agent |
| Điều phối các agent đồng thời từ mã | Bầy agent | Chế độ mã và Agent con |
| Tìm kiếm danh mục công cụ OpenClaw lớn | Tìm kiếm công cụ | Tìm kiếm công cụ |
| Kết hợp nhiều công cụ trong một chương trình gọn nhẹ | Chế độ mã | Chế độ mã |
Chọn công cụ, kỹ năng hoặc plugin
Dùng công cụ khi agent cần hành động
Công cụ là một hàm có kiểu mà agent có thể gọi, chẳng hạn như exec, browser,
web_search, message hoặc image_generate. Hãy dùng công cụ khi agent
cần đọc dữ liệu, thay đổi tệp, gửi tin nhắn, gọi nhà cung cấp hoặc
vận hành một 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ế của nhà cung cấp, trạng thái sandbox, quyền của kênh và tính khả dụng của plugin.
Dùng kỹ năng khi agent cần hướng dẫn
Kỹ năng là một gói hướng dẫn SKILL.md được nạp vào prompt của agent. Hãy dùng
kỹ năng khi agent đã có các công cụ cần thiết nhưng cần một
quy trình làm việc có thể lặp lại, tiêu chí review, trình tự lệnh hoặc
ràng buộc vận hành.
Kỹ năng có thể nằm trong workspace, thư mục kỹ năng dùng chung, thư mục gốc kỹ năng OpenClaw được quản lý hoặc gói plugin.
Skills | Xưởng kỹ năng | Tự học | Tạo kỹ năng | Cấu hình kỹ năng
Dùng plugin khi OpenClaw cần một khả năng mới
Plugin có thể bổ sung công cụ, kỹ năng, kênh, nhà cung cấp mô hình, giọng nói, thoại thời gian thực, tạo nội dung đa phương tiện, tìm kiếm web, truy xuất web, hook và các khả năng thời gian chạy khác. Hãy dùng plugin khi khả năng đó 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. Có thể cài đặt các plugin hiện có từ ClawHub, npm, git, thư mục cục bộ hoặc kho lưu trữ.
Danh mục công cụ tích hợp sẵn
Bảng liệt kê các công cụ tiêu biểu để bạn có thể nhận diện bề mặt này. Đây không phải là tài liệu tham chiếu chính sách đầy đủ. Để biết chính xác các nhóm, giá trị 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 agent cần... | Công cụ tiêu biểu | Đọc tiếp |
|---|---|---|---|
| Thời gian chạy | Chạy lệnh, quản lý tiến trình hoặc dùng tính năng phân tích Python do nhà cung cấp hỗ trợ | exec, process, terminal, code_execution |
Thực thi, Terminal Control UI, 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á |
| Đầu vào của con người | Tạm dừng để người dùng đưa ra quyết định có cấu trúc | ask_user |
Hỏi người dùng |
| Web | Tìm kiếm trên web, tìm kiếm bài đăng X hoặc truy xuất nội dung trang dễ đọc | web_search, x_search, web_fetch |
Công cụ web, Truy xuất web |
| Trình duyệt | Vận hành một phiên trình duyệt | browser |
Trình duyệt |
| Giao diện người vận hành | Sắp xếp các ô, bảng điều khiển và điều hướng Control UI được kết nối | screen |
Màn hình |
| Nhắn tin và kênh | Gửi phản hồi hoặc hành động trên kênh | message |
Gửi qua agent |
| Phiên và agent | Kiểm tra phiên, ủy quyền công việc, điều phối bộ thu thập, định hướng lượt chạy khác hoặc báo cáo trạng thái | sessions_*, agents_wait, subagents, agents_list, session_status, get_goal, create_goal, update_goal |
Mục tiêu, Bầy agent, Agent con, Công cụ phiên |
| Tự động hóa | Lên lịch công việc hoặc phản hồi các 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 các thiết bị đích đã ghép nối | gateway, nodes |
Cấu hình Gateway, Node |
| Đa phương tiện | Phân tích, tạo hoặc phát giọng nói cho nội dung đa phương tiện | image, image_generate, music_generate, video_generate, tts |
Tổng quan về đa phương tiện |
| Danh mục OpenClaw lớn | Tìm kiếm, gọi và kết hợp nhiều công cụ đủ điều kiện mà không gửi mọi schema đến mô hình | exec, wait, tool_search_code, tool_search, tool_describe |
Chế độ mã, 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 kết nối công cụ thông qua
api.registerTool(...) và contracts.tools của manifest; hãy dùng
SDK Plugin và Manifest plugin
để biết chi tiết về hợp đồng.
Các công cụ phổ biến do plugin cung cấp gồm:
- Diff để hiển thị diff của tệp và Markdown
- Hiển thị tiện ích cho SVG và HTML nội tuyến độc lập trong các ứng dụng trò chuyện được hỗ trợ
- Màn hình để bố trí Control UI đã kết nối
- Tác vụ LLM cho các bước quy trình làm việc chỉ dùng JSON
- Lobster cho các quy trình làm việc có kiểu với phê duyệt có thể tiếp tục
- Tokenjuice để thu gọn đầu ra công cụ
execvàbashnhiề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 cần đưa mọi schema vào prompt
- Canvas để điều khiển Canvas của node và kết xuất 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 khi 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 được schema của công cụ đó trong lượt này. Một lần chạy có thể mất công cụ do cấu hình toàn cục, cấu hình theo agent, chính sách kênh, hạn chế của nhà cung cấp, quy tắc sandbox, chính sách kênh/runtime hoặc tình trạng khả dụng của plugin.
- Công cụ và nhà cung cấp tùy chỉnh trình bày hồ sơ công cụ, danh sách cho phép/từ chối, hạn chế theo từng nhà cung cấp, phát hiện vòng lặp và cài đặt công cụ do nhà cung cấp hỗ trợ.
- Phê duyệt thực thi trình bày chính sách phê duyệt lệnh trên máy chủ.
- Thực thi nâng quyền trình bày cách 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.
- Hạn chế sandbox và công cụ theo agent trình bày các hạn chế dành riêng cho agent trong những lần chạy được ủy quyền.
Mở rộng khả năng
Chọn phương thức 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ý một 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 các hướng dẫn có thể tái sử dụng cho agent bằng Skills và Tạo skill.
- Sử dụng SDK Plugin và Manifest plugin 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 với chính sách có hiệu lực cho lượt hiện tại:
- Kiểm tra hồ sơ đang hoạt động,
tools.allowvàtools.denytrong Công cụ và nhà cung cấp tùy chỉnh. - Kiểm tra các hạn chế theo từng 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ợ cấu trúc công cụ này.
- Kiểm tra quyền của kênh, trạng thái sandbox và quyền truy cập nâng cao bằng Sandbox so với chính sách công cụ so với nâng quyền và Thực thi nâng quyền.
- Kiểm tra xem plugin sở hữu công cụ đã được cài đặt và bật trong Plugin hay chưa.
- Đối với các lần chạy được ủy quyền, hãy kiểm tra các hạn chế theo agent trong Hạn chế sandbox và công cụ theo agent.
- Đối với các danh mục OpenClaw lớn, hãy xác nhận xem lần chạy sử dụng việc cung cấp công cụ trực tiếp, Chế độ mã 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, chỉ thị thường trực và Luồng tác vụ
- Agent cho mô hình agent, phiên, bộ nhớ và phối hợp đa agent
- Công cụ và nhà cung cấp tùy chỉnh để tham khảo chính sách công cụ chính thức
- Plugin để cài đặt và quản lý plugin
- SDK Plugin để tham khảo khi xây dựng plugin
- Skills để tìm hiểu thứ tự tải, cơ chế kiểm soát và cấu hình skill
- Xưởng Skill để tạo skill có quy trình sinh tự động và review
- Tìm kiếm công cụ để khám phá danh mục công cụ OpenClaw ở dạng rút gọn
- Chế độ mã cho các quy trình làm việc JavaScript hoặc TypeScript rút gọn trên một danh mục công cụ OpenClaw ẩn
- Swarm để phân nhánh có cấu trúc và thu thập kết quả từ Chế độ mã