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.Chọn công cụ, kỹ năng hoặc plugin
1
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.2
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ăng3
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ữ.Cài đặt và cấu hình plugin | Xây dựng plugin | SDK Plugin
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.Chế độ mã và Tìm kiếm công cụ là các bề mặt agent OpenClaw thử nghiệm. Các lượt chạy bằng
harness Codex sử dụng chế độ mã gốc của Codex, tìm kiếm công cụ gốc, công cụ động
được trì hoãn và các lệnh gọi công cụ lồng nhau thay cho
tools.codeMode hoặc tools.toolSearch.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 quaapi.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ã