Công cụ và Plugin

Mọi thứ agent thực hiện ngoài việc tạo văn bản đều diễn ra thông qua công cụ. Công cụ là cách agent đọc tệp, 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ụ, Skills và Plugin

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

Công cụ là thứ 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 tập hợp công cụ tích hợp sẵn và Plugin có thể đăng ký thêm các công cụ khác.Agent nhìn thấy công cụ dưới dạng các định nghĩa hàm có cấu trúc được gửi đến API mô hình.

Skills dạy agent khi nào và cách thực hiện

Skill là một tệp markdown (SKILL.md) được chèn vào system prompt. Skills 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ả. Skills nằm trong workspace của bạn, trong các thư mục dùng chung, hoặc được đóng gói bên trong Plugin.Tham chiếu Skills | Tạo Skills

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ỳ tổ hợp năng lực nào: kênh, nhà cung cấp mô hình, công cụ, Skills, giọng nói, phiên âm thời gian thực, thoại thời gian thực, hiểu nội dung đa phương tiện, tạo ảnh, tạo video, truy xuất web, tìm kiếm web, và hơn thế nữa. Một số Plugin là cốt lõi (được phát hành cùng OpenClaw), số khác là bên ngoài (do cộng đồng xuất bản trên npm).Cài đặt và cấu hình Plugin | Tự xây dựng Plugin của bạn

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

Các công cụ này được phát hành cùng OpenClaw và có sẵn mà không cần cài đặt bất kỳ Plugin nào:

Công cụ	Chức năng	Trang
`exec` / `process`	Chạy lệnh shell, quản lý tiến trình nền	Exec, Phê duyệt Exec
`code_execution`	Chạy phân tích Python từ xa trong sandbox	Thực thi mã
`browser`	Điều khiển trình duyệt Chromium (điều hướng, nhấp, chụp màn hình)	Trình duyệt
`web_search` / `x_search` / `web_fetch`	Tìm kiếm web, tìm kiếm bài đăng X, truy xuất nội dung trang	Web, Truy xuất Web
`read` / `write` / `edit`	I/O tệp trong workspace
`apply_patch`	Bản vá tệp nhiều hunk	Áp dụng bản vá
`message`	Gửi tin nhắn qua tất cả các kênh	Agent gửi
`canvas`	Điều khiển Canvas của Node (trình bày, eval, snapshot)
`nodes`	Khám phá và nhắm tới các thiết bị đã ghép nối
`cron` / `gateway`	Quản lý tác vụ đã lên lịch; kiểm tra, vá, khởi động lại hoặc cập nhật gateway
`image` / `image_generate`	Phân tích hoặc tạo ảnh	Tạo ảnh
`music_generate`	Tạo bản nhạc	Tạo nhạc
`video_generate`	Tạo video	Tạo video
`tts`	Chuyển văn bản thành giọng nói một lần	TTS
`sessions_*` / `subagents` / `agents_list`	Quản lý phiên, trạng thái và điều phối sub-agent	Sub-agent
`session_status`	Đọc lại nhẹ kiểu `/status` và ghi đè mô hình phiên	Công cụ phiên

Với công việc ảnh, dùng image để phân tích và image_generate để tạo hoặc chỉnh sửa. Nếu bạn nhắm tới openai/*, google/*, fal/*, hoặc một nhà cung cấp ảnh không mặc định khác, hãy cấu hình khóa xác thực/API của nhà cung cấp đó trước. Với công việc nhạc, dùng music_generate. Nếu bạn nhắm tới google/*, minimax/*, hoặc một nhà cung cấp nhạc không mặc định khác, hãy cấu hình khóa xác thực/API của nhà cung cấp đó trước. Với công việc video, dùng video_generate. Nếu bạn nhắm tới qwen/* hoặc một nhà cung cấp video không mặc định khác, hãy cấu hình khóa xác thực/API của nhà cung cấp đó trước. Để tạo âm thanh theo workflow, dùng music_generate khi một Plugin như ComfyUI đăng ký công cụ đó. Điều này tách biệt với tts, vốn là chuyển văn bản thành giọng nói. session_status là công cụ trạng thái/đọc lại nhẹ trong nhóm phiên. Nó trả lời các câu hỏi kiểu /status về phiên hiện tại và có thể tùy chọn đặt ghi đè mô hình cho từng phiên; model=default xóa ghi đè đó. Giống như /status, nó có thể điền ngược các bộ đếm token/cache thưa thớt và nhãn mô hình runtime đang hoạt động từ mục usage transcript mới nhất. gateway là công cụ runtime chỉ dành cho chủ sở hữu cho các thao tác gateway:

config.schema.lookup cho một cây con cấu hình theo phạm vi đường dẫn trước khi chỉnh sửa
config.get cho snapshot cấu hình hiện tại + hash
config.patch cho cập nhật cấu hình từng phần kèm khởi động lại
config.apply chỉ dành cho thay thế toàn bộ cấu hình
update.run cho tự cập nhật rõ ràng + khởi động lại

Với thay đổi từng phần, ưu tiên config.schema.lookup rồi config.patch. Chỉ dùng config.apply khi bạn chủ ý thay thế toàn bộ cấu hình. Để xem tài liệu cấu hình rộng hơn, đọc Cấu hình và Tham chiếu cấu hình. Công cụ cũng từ chối thay đổi tools.exec.ask hoặc tools.exec.security; các bí danh cũ tools.bash.* được chuẩn hóa về cùng các đường dẫn exec được bảo vệ.

Công cụ do Plugin cung cấp

Plugin có thể đăng ký thêm các công cụ. Một số ví dụ:

Diffs — trình xem và trình kết xuất diff
Tác vụ LLM — bước LLM chỉ JSON cho đầu ra có cấu trúc
Lobster — runtime workflow có kiểu với phê duyệt có thể tiếp tục
Tạo nhạc — công cụ music_generate dùng chung với các nhà cung cấp dựa trên workflow
OpenProse — điều phối workflow ưu tiên markdown
Tokenjuice — nén gọn các kết quả công cụ exec và bash nhiễu

Cấu hình công cụ

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

Kiểm soát công cụ nào agent có thể gọi thông qua tools.allow / tools.deny trong cấu hình. Từ chối luôn thắng cho phép.

{
  tools: {
    allow: ["group:fs", "browser", "web_search"],
    deny: ["exec"],
  },
}

OpenClaw đóng theo hướng an toàn khi một danh sách cho phép rõ ràng không phân giải được công cụ nào có thể gọi. Ví dụ, tools.allow: ["query_db"] chỉ hoạt động nếu một Plugin đã tải thực sự đăng ký query_db. Nếu không có công cụ tích hợp sẵn, Plugin, hoặc công cụ MCP đóng gói nào khớp với danh sách cho phép, lượt chạy sẽ dừng trước lệnh gọi mô hình thay vì tiếp tục như một lượt chạy chỉ văn bản có thể bịa ra kết quả công cụ.

Hồ sơ công cụ

tools.profile đặt danh sách cho phép cơ sở trước khi áp dụng allow/deny. Ghi đè theo từng agent: agents.list[].tools.profile.

Hồ sơ	Nội dung bao gồm
`full`	Nền tảng không hạn chế cho quyền truy cập lệnh/điều khiển rộng hơn; giống như để `tools.profile` chưa đặt
`coding`	`group:fs`, `group:runtime`, `group:web`, `group:sessions`, `group:memory`, `cron`, `image`, `image_generate`, `music_generate`, `video_generate`
`messaging`	`group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status`
`minimal`	Chỉ `session_status`

tools.profile: "messaging" được cố ý thu hẹp cho các agent tập trung vào kênh. Nó loại bỏ các công cụ lệnh/điều khiển rộng hơn như hệ thống tệp, runtime, trình duyệt, canvas, nodes, cron và điều khiển gateway. Dùng tools.profile: "full" làm nền tảng không hạn chế cho quyền truy cập lệnh/điều khiển rộng hơn, rồi thu gọn quyền truy cập bằng tools.allow / tools.deny khi cần.

coding bao gồm các công cụ web nhẹ (web_search, web_fetch, x_search) nhưng không bao gồm công cụ điều khiển trình duyệt đầy đủ. Tự động hóa trình duyệt có thể điều khiển các phiên thực và hồ sơ đã đăng nhập, vì vậy hãy thêm rõ ràng bằng tools.alsoAllow: ["browser"] hoặc theo từng agent agents.list[].tools.alsoAllow: ["browser"]. Các hồ sơ coding và messaging cũng cho phép các công cụ MCP bundle đã cấu hình dưới khóa Plugin bundle-mcp. Thêm tools.deny: ["bundle-mcp"] khi bạn muốn một hồ sơ giữ nguyên các công cụ tích hợp thông thường nhưng ẩn tất cả công cụ MCP đã cấu hình. Hồ sơ minimal không bao gồm công cụ MCP bundle. Ví dụ (bề mặt công cụ rộng nhất theo mặc định):

{
  tools: {
    profile: "full",
  },
}

Nhóm công cụ

Dùng các lối tắt group:* trong danh sách cho phép/từ chối:

Nhóm	Công cụ
`group:runtime`	exec, process, code_execution (`bash` được chấp nhận làm bí danh cho `exec`)
`group:fs`	read, write, edit, apply_patch
`group:sessions`	sessions_list, sessions_history, sessions_send, sessions_spawn, sessions_yield, subagents, session_status
`group:memory`	memory_search, memory_get
`group:web`	web_search, x_search, web_fetch
`group:ui`	browser, canvas
`group:automation`	cron, gateway
`group:messaging`	message
`group:nodes`	nodes
`group:agents`	agents_list
`group:media`	image, image_generate, music_generate, video_generate, tts
`group:openclaw`	Tất cả công cụ OpenClaw tích hợp sẵn (không bao gồm công cụ Plugin)

sessions_history trả về một chế độ xem truy hồi có giới hạn và đã được lọc an toàn. Nó loại bỏ các thẻ suy nghĩ, khung <relevant-memories>, payload XML lệnh gọi công cụ dạng văn bản thuần (bao gồm <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls>, và các khối lệnh gọi công cụ bị cắt ngắn), khung lệnh gọi công cụ đã hạ cấp, token điều khiển mô hình ASCII/toàn chiều bị rò rỉ, và XML lệnh gọi công cụ MiniMax không đúng định dạng khỏi văn bản của trợ lý, sau đó áp dụng biên tập/cắt ngắn và các phần giữ chỗ có thể có cho hàng quá lớn thay vì hoạt động như một bản kết xuất bản ghi thô.

Các hạn chế dành riêng cho 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ục:

{
  tools: {
    profile: "coding",
    byProvider: {
      "google-antigravity": { profile: "minimal" },
    },
  },
}

Overview

Plugins

Skills

Automation and tasks

Tools

Agent coordination

Công cụ và Plugin

Công cụ, Skills và Plugin

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

Công cụ do Plugin cung cấp

Cấu hình công cụ

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

Hồ sơ công cụ

Nhóm công cụ

Các hạn chế dành riêng cho nhà cung cấp

Overview

Plugins

Skills

Automation and tasks

Tools

Agent coordination

Documentation Index

​Công cụ, Skills và Plugin

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

​Công cụ do Plugin cung cấp

​Cấu hình công cụ

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

​Hồ sơ công cụ

​Nhóm công cụ

​Các hạn chế dành riêng cho nhà cung cấp

Công cụ, Skills và Plugin

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

Công cụ do Plugin cung cấp

Cấu hình công cụ

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

Hồ sơ công cụ

Nhóm công cụ

Các hạn chế dành riêng cho nhà cung cấp