Chuyển đến nội dung chính

Công cụ và Plugin

Mọi hoạt động của agent ngoài việc tạo văn bản đều thông qua công cụ. Công cụ giúp agent đọc file, chạy lệnh, duyệt web, gửi tin nhắn và tương tác với thiết bị.

Công cụ, kỹ năng và plugin

OpenClaw có ba lớp hoạt động cùng nhau:
1

Công cụ là những gì agent gọi

Công cụ là một hàm có kiểu mà agent có thể gọi (ví dụ: exec, browser, web_search, message). OpenClaw cung cấp một bộ công cụ tích hợp sẵn và plugin có thể đăng ký thêm.Agent xem công cụ như các định nghĩa hàm có cấu trúc được gửi đến API mô hình.
2

Kỹ năng hướng dẫn agent khi nào và cách nào

Kỹ năng là một file markdown (SKILL.md) được đưa vào hệ thống nhắc nhở. Kỹ năng cung cấp cho agent ngữ cảnh, ràng buộc và hướng dẫn từng bước để sử dụng công cụ hiệu quả. Kỹ năng có thể nằm trong workspace, thư mục chia sẻ hoặc đi kèm trong plugin.Tham khảo kỹ năng | Tạo kỹ năng
3

Plugin đóng gói mọi thứ lại với nhau

Plugin là một gói có thể đăng ký bất kỳ sự kết hợp nào của các khả năng: kênh, nhà cung cấp mô hình, công cụ, kỹ năng, giọng nói, tạo hình ảnh và nhiều hơn nữa. Một số plugin là cốt lõi (đi kèm với OpenClaw), số khác là bên ngoài (được cộng đồng phát hành trên npm).Cài đặt và cấu hình plugin | Tự xây dựng plugin

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

Những công cụ này đi kèm với OpenClaw và có sẵn mà không cần cài đặt plugin:
Công cụChức năngTrang
exec / processChạy lệnh shell, quản lý tiến trình nềnExec
browserĐiều khiển trình duyệt Chromium (điều hướng, nhấp, chụp màn hình)Browser
web_search / web_fetchTìm kiếm web, lấy nội dung trangWeb
read / write / editI/O file trong workspace
apply_patchVá file nhiều phầnApply Patch
messageGửi tin nhắn qua tất cả các kênhAgent Send
canvasĐiều khiển node Canvas (trình bày, đánh giá, chụp nhanh)
nodesKhám phá và nhắm mục tiêu thiết bị ghép đôi
cron / gatewayQuản lý công việc định kỳ, khởi động lại gateway
image / image_generatePhân tích hoặc tạo hình ảnh
sessions_* / agents_listQuản lý phiên, sub-agentSub-agents

Công cụ do plugin cung cấp

Plugin có thể đăng ký thêm công cụ. Một số ví dụ:
  • Lobster — runtime workflow có kiểu với phê duyệt có thể tiếp tục
  • LLM Task — bước LLM chỉ JSON cho đầu ra có cấu trúc
  • Diffs — trình xem và render diff
  • OpenProse — điều phối workflow ưu tiên markdown

Cấu hình công cụ

Danh sách cho phép và từ chối

Kiểm soát công cụ mà agent có thể gọi qua tools.allow / tools.deny trong cấu hình. Từ chối luôn ưu tiên hơn cho phép.
{
  tools: {
    allow: ["group:fs", "browser", "web_search"],
    deny: ["exec"],
  },
}

Hồ sơ công cụ

tools.profile thiết lập danh sách cho phép cơ bản trước khi áp dụng allow/deny. Ghi đè theo agent: agents.list[].tools.profile.
Hồ sơBao gồm gì
fullTất cả công cụ (mặc định)
codingI/O file, runtime, phiên, bộ nhớ, hình ảnh
messagingNhắn tin, danh sách/lịch sử/gửi/trạng thái phiên
minimalChỉ session_status

Nhóm công cụ

Sử dụng viết tắt group:* trong danh sách cho phép/từ chối:
NhómCông cụ
group:runtimeexec, bash, process
group:fsread, write, edit, apply_patch
group:sessionssessions_list, sessions_history, sessions_send, sessions_spawn, session_status
group:memorymemory_search, memory_get
group:webweb_search, web_fetch
group:uibrowser, canvas
group:automationcron, gateway
group:messagingmessage
group:nodesnodes
group:openclawTất cả công cụ tích hợp sẵn của OpenClaw (không bao gồm công cụ plugin)

Hạn chế theo nhà cung cấp

Sử dụng tools.byProvider để hạn chế công cụ cho các nhà cung cấp cụ thể mà không thay đổi mặc định toàn cầu:
{
  tools: {
    profile: "coding",
    byProvider: {
      "google-antigravity": { profile: "minimal" },
    },
  },
}
Last modified on March 22, 2026