SKILL.md thông qua quy trình này — họ tạo một đề xuất (bản nháp đang chờ với nội dung, liên kết đích, trạng thái trình quét, hàm băm và siêu dữ liệu hoàn tác), và đề xuất chỉ trở thành skill đang hoạt động khi được áp dụng.
Skill Workshop chỉ ghi các skill trong không gian làm việc. Công cụ này không bao giờ tác động đến các skill được đóng gói sẵn, thuộc plugin, ClawHub, gốc bổ sung, được quản lý, của agent cá nhân hoặc của hệ thống.
Cách hoạt động
- Đề xuất trước: nội dung được tạo sẽ được lưu dưới dạng
PROPOSAL.md, không phảiSKILL.md. - Áp dụng là thao tác ghi trực tiếp duy nhất: thao tác tạo, cập nhật và chỉnh sửa không bao giờ thay đổi các skill đang hoạt động.
- Phạm vi không gian làm việc: thao tác tạo nhắm đến thư mục gốc
skills/của không gian làm việc; chỉ được phép cập nhật các skill có thể ghi trong không gian làm việc. - Không ghi đè: thao tác tạo thất bại nếu skill đích đã tồn tại.
- Liên kết bằng hàm băm: các đề xuất cập nhật được liên kết với hàm băm hiện tại của đích và chuyển sang
stalenếu skill đang hoạt động thay đổi trước khi áp dụng. - Được kiểm soát bằng trình quét: thao tác áp dụng chạy lại trình quét bảo mật trước khi ghi.
- Có thể khôi phục: thao tác áp dụng ghi siêu dữ liệu hoàn tác trước khi tác động đến các tệp đang hoạt động.
- Các giao diện nhất quán: trò chuyện, CLI và Gateway đều gọi cùng một dịch vụ.
Vòng đời
pending mới có thể được chỉnh sửa, áp dụng, từ chối hoặc cách ly.
Quản lý vòng đời
Gateway theo dõi mức sử dụng tổng hợp của skill trong cơ sở dữ liệu trạng thái dùng chung. Mỗi ngày một lần, hệ thống xem xét các skill được Skill Workshop tạo và áp dụng. Các skill không được sử dụng trong hơn 30 ngày sẽ trở thànhstale; sau 90 ngày, chúng trở thành archived và
không được đưa vào các bản chụp nhanh skill mới của agent. Các tệp skill đã lưu trữ không thay đổi trên
đĩa. Các skill được tạo thủ công không bao giờ được quản lý; chỉ các skill được tạo từ đề xuất của Skill
Workshop mới tham gia quy trình quản lý vòng đời.
Các skill được ghim bỏ qua các chuyển đổi vòng đời. Một skill lỗi thời trở lại active
sau khi được sử dụng và lần quét tiếp theo chạy. Các skill đã lưu trữ chỉ trở lại thông qua thao tác
khôi phục rõ ràng:
Các chuyển đổi vòng đời và thao tác khôi phục áp dụng cho phiên mới; các phiên đang chạy giữ nguyên
bản chụp nhanh skill hiện tại.
--json. Trạng thái cũng báo cáo các ứng viên trùng lặp có tính xác định
chỉ dưới dạng đề xuất; thao tác này không bao giờ hợp nhất các skill hoặc gọi mô hình.
Trò chuyện
Yêu cầu agent tạo skill mong muốn; agent sẽ gọiskill_workshop và trả về
mã đề xuất.
Học từ công việc gần đây
Dùng/learn để chuyển cuộc trò chuyện hiện tại hoặc các nguồn được chỉ định thành một
đề xuất skill tuân theo tiêu chuẩn:
/learn yêu cầu agent chắt lọc quy trình có thể tái sử dụng từ
cuộc trò chuyện hiện tại. Khi có yêu cầu, agent coi các đường dẫn, URL, ghi chú được dán
và tham chiếu đến cuộc trò chuyện là nguồn, đồng thời tuân thủ các yêu cầu về trọng tâm, phạm vi và
đặt tên. Agent thu thập các nguồn bằng những công cụ hiện có, sau đó gọi
skill_workshop với action: "create".
Đề xuất thu được vẫn ở trạng thái pending; /learn không bao giờ áp dụng đề xuất đó. Xem xét và
áp dụng đề xuất thông qua quy trình phê duyệt thông thường hoặc bằng openclaw skills workshop.
Tạo:
apply, reject và quarantine do agent khởi tạo sẽ chạy mà không cần thêm
lời nhắc phê duyệt theo mặc định. Đặt skills.workshop.approvalPolicy thành "pending"
để yêu cầu người vận hành phê duyệt trước các thao tác đó.
Khi cần phê duyệt, lời nhắc xác định mã đề xuất và skill
đích, đồng thời hiển thị phần mô tả đề xuất, số lượng tệp hỗ trợ và kích thước phần nội dung.
Yêu cầu phê duyệt được giới hạn để hoàn tất trước bộ giám sát công cụ của agent. Nếu không
nhận được quyết định trước khi lời nhắc hết hạn, thao tác vòng đời sẽ không chạy:
đề xuất vẫn đang chờ và không thay đổi. Hãy quyết định sau trong giao diện Skill Workshop hoặc chạy
openclaw skills workshop apply|reject|quarantine <proposal-id>. Agent không nên
thử lại thao tác vòng đời đã hết hạn theo vòng lặp.
CLI
--agent <id> (không gian làm việc đích; mặc định được suy ra từ
thư mục làm việc hiện tại, sau đó là agent mặc định) và --json (đầu ra có cấu trúc).
propose-create, propose-update và revise cũng nhận --goal <text> và
--evidence <text> để ghi lại ngữ cảnh đề xuất cùng với --proposal.
Nội dung đề xuất
Trong khi đang chờ, đề xuất được lưu dưới dạngPROPOSAL.md với phần thông tin đầu tệp
chỉ dành cho đề xuất:
SKILL.md đang hoạt động và xóa các
trường chỉ dành cho đề xuất: status, version của đề xuất và date của đề xuất.
Tệp hỗ trợ
Dùng--proposal-dir khi skill được đề xuất cần các tệp bên cạnh
PROPOSAL.md:
PROPOSAL.md. Các tệp hỗ trợ phải nằm trong
assets/, examples/, references/, scripts/ hoặc templates/. Skill
Workshop quét, tính hàm băm và lưu chúng cùng đề xuất, sau đó chỉ ghi chúng
bên cạnh SKILL.md đang hoạt động khi áp dụng.
Các đường dẫn tệp hỗ trợ bị từ chối: đường dẫn tuyệt đối, phân đoạn đường dẫn ẩn, duyệt ngược
đường dẫn, đường dẫn chồng lấn, tệp thực thi, văn bản không phải UTF-8, byte null
và đường dẫn nằm ngoài các thư mục hỗ trợ tiêu chuẩn.
Công cụ agent
Mô hình sử dụngskill_workshop với một action bắt buộc:
create | update | revise | list | inspect | apply | reject | quarantine.
Các tham số khác được áp dụng tùy theo thao tác:
Agent phải dùng
skill_workshop cho công việc tạo skill. Agent không được
tạo hoặc thay đổi các tệp đề xuất thông qua write, edit, exec, lệnh
shell hoặc thao tác trực tiếp trên hệ thống tệp.
skill_workshop là công cụ agent tích hợp sẵn và được bao gồm trong
tools.profile: "coding". Nếu một chính sách nghiêm ngặt hơn ẩn công cụ này, hãy thêm
skill_workshop vào danh sách tools.allow đang hoạt động hoặc dùng
tools.alsoAllow: ["skill_workshop"] khi phạm vi sử dụng hồ sơ không có
tools.allow rõ ràng. Các lượt chạy trong sandbox không khởi tạo công cụ
Skill Workshop phía máy chủ, vì vậy hãy thực hiện các thao tác xem xét đề xuất từ một phiên agent phía máy chủ thông thường
hoặc CLI.Skill được đề xuất
OpenClaw phát hiện các chỉ dẫn lâu dài như “lần sau”, “hãy nhớ” và những điều chỉnh mang tính phản hồi khi một lượt tương tác kết thúc, kể cả các lượt thất bại. Trong lượt tiếp theo, agent đề nghị lưu quy trình được phát hiện gần nhất thông quaskill_workshop; người dùng quyết định có tạo
đề xuất hay không. Tính năng đề xuất tích hợp sẵn này không tự tạo hoặc thay đổi skill. Bật
skills.workshop.autonomous.enabled để trực tiếp tạo các đề xuất đang chờ. Trong giao diện Control
UI, thẻ Workshop cung cấp cùng tùy chọn dưới dạng nút bật/tắt Tự học trong tiêu đề trang và
dưới dạng nút bật trên bảng đề xuất trống.
Quét các phiên trước đây
Control UI có thể xem xét công việc cũ hơn mà không cần bật chế độ tự học tự động. Mở Plugins → Workshop và chọn Tìm ý tưởng skill. Quá trình quét bắt đầu với các phiên đủ điều kiện mới nhất và xem xét một khoảng giới hạn gồm các công việc đáng kể. Quá trình này bỏ qua các phiên cron, heartbeat, hook, agent con, ACP, do plugin sở hữu và xem xét nội bộ, cũng như các cuộc trò chuyện có ít hơn sáu lượt mô hình. Trình xem xét sử dụng mô hình được cấu hình của agent đã chọn và nhận một gói bản chép lời đã che thông tin bí mật và giới hạn kích thước. Trình này áp dụng cùng một tiêu chuẩn thận trọng như khi xem xét trải nghiệm: một mẫu khôi phục cụ thể hoặc một quy trình ổn định có thể loại bỏ ít nhất hai lệnh gọi mô hình hoặc công cụ trong tương lai. Công việc thường lệ và các thông tin chỉ dùng một lần không nên tạo ra đề xuất. Một lần quét có thể tạo hoặc chỉnh sửa tối đa ba đề xuất đang chờ. Quá trình này không thể áp dụng, từ chối, cách ly hoặc chỉnh sửa skill đang hoạt động. Workshop hiển thị phạm vi tích lũy, ví dụ Đã xem xét 20 phiên · 18 tháng 6–hôm nay · Tìm thấy 2 ý tưởng. Chọn Quét công việc trước đó để tiếp tục từ con trỏ phiên cũ nhất đã được lưu. Sau khi toàn bộ lịch sử khả dụng đã được xử lý, thao tác sẽ trở thành Quét công việc mới. Việc xem lại lịch sử được thực hiện thủ công ngay cả khiskills.workshop.autonomous.enabled là false. Mỗi lần nhấp sẽ bắt đầu một lượt chạy mô hình,
vì vậy các điều khoản về giá và xử lý dữ liệu của nhà cung cấp sẽ được áp dụng. Con trỏ và số lượng phạm vi
được lưu trong cơ sở dữ liệu trạng thái OpenClaw dùng chung; nội dung bản ghi hội thoại không được sao chép
vào trạng thái quét.
Khi bật tính năng thu thập tự động, OpenClaw cũng có thể thực hiện một lượt xem xét thận trọng sau khi hoàn thành
công việc đáng kể, thành công và sau khi toàn bộ hệ thống tác tử chuyển sang trạng thái nhàn rỗi. Lượt xem xét độc lập đó có thể tạo hoặc
sửa đổi tối đa một đề xuất đang chờ xử lý. Lượt này không thể cập nhật một skill đang hoạt động hoặc áp dụng, từ chối hay cách ly một
đề xuất, ngay cả khi approvalPolicy là "auto".
Xem Tự học để biết chi tiết về cách bật, điều kiện đủ, quyền riêng tư và chi phí,
ngưỡng đề xuất và cách khắc phục sự cố.
Phê duyệt và quyền tự chủ
Tính năng thu thập tự động nhận diện các quy tắc cho tương lai (ví dụ: “từ giờ trở đi”) và các
chỉnh sửa mang tính phản hồi (ví dụ: “đó không phải là điều tôi yêu cầu”). Tính năng này nhóm các hướng dẫn mới theo chủ đề thành tối đa
ba đề xuất mỗi lượt, định tuyến các kết quả khớp từ vựng đến các skill hiện có có thể ghi trong không gian làm việc và
sửa đổi đề xuất đang chờ xử lý của chính nó khi một chỉnh sửa khác nhắm đến cùng skill.
Đối với công việc đáng kể được hoàn thành thành công mà không có chỉnh sửa rõ ràng, một lượt chạy độc lập của
mô hình đã chọn sẽ quyết định liệu tiến trình đã hoàn thành có vượt qua ngưỡng đề xuất thận trọng hay không. Mô hình
tiền cảnh không được nhắc học trước khi phản hồi. Trình xem xét nền giữ nguyên lượt chạy
tiền cảnh làm nguồn gốc của đề xuất, không thể truy cập các công cụ tác tử chung và không thể đưa ra quyết định
về vòng đời. Việc xem xét chỉ bắt đầu khi môi trường chạy tiền cảnh báo cáo cả mô hình đã phân giải chính xác
và rằng
skill_workshop thực sự khả dụng. Do đó, chính sách công cụ hạn chế hoặc không xác định sẽ
từ chối theo mặc định và không tạo đề xuất nào.
Xem Tự học để biết đầy đủ hành vi xem xét tự động và mô hình
an toàn.
Phần mô tả đề xuất luôn bị giới hạn ở 160 byte, độc lập với
maxSkillBytes.
Các phương thức Gateway
requestRevision chỉ dành cho Gateway (không có phương thức tương đương trong CLI hoặc công cụ tác tử): phương thức này
chuyển tiếp các hướng dẫn sửa đổi dạng văn bản tự do đến phiên trò chuyện của tác tử sở hữu
thay vì thay thế trực tiếp PROPOSAL.md, dành cho các giao diện người dùng yêu cầu tác tử
sửa đổi thay vì gửi nội dung mới theo nghĩa đen.
historyStatus và historyScan là các phương thức hỗ trợ Giao diện điều khiển. historyScan
chấp nhận direction: "older" | "newer"; phương thức này luôn để kết quả ở trạng thái đề xuất
đang chờ xử lý.
Lưu trữ
~/.openclaw.
proposal.json: bản ghi đề xuất chuẩn.proposals.json: chỉ mục liệt kê nhanh, có thể xây dựng lại từ các thư mục đề xuất.PROPOSAL.md: đề xuất skill đang chờ xử lý.rollback.json: siêu dữ liệu khôi phục được ghi trước khi thao tác áp dụng thay đổi các tệp đang hoạt động.
Giới hạn
Khắc phục sự cố
Chẩn đoán chính sách công cụ
Khi tính năng thu thập tự động được bật,openclaw doctor chạy bước kiểm tra
core/doctor/skill-workshop-tool-policy cho tác tử mặc định. Nếu chính sách
ẩn skill_workshop, cảnh báo sẽ nêu tên lớp cấu hình loại trừ đầu tiên và
thay đổi chính xác cần thực hiện đối với allow hoặc alsoAllow. Các sổ tay vận hành cũ hơn vẫn có thể sử dụng
openclaw plugins inspect skill-workshop; lệnh đó hiện giải thích rằng Skill
Workshop được tích hợp sẵn và hiển thị cùng gợi ý chính sách khi áp dụng.
Liên quan
- Skills để biết thứ tự tải, mức ưu tiên và khả năng hiển thị
- Tự học để biết các đề xuất skill thận trọng sau lượt chạy
- Tạo skill để biết những kiến thức cơ bản về
SKILL.mdđược viết thủ công - Cấu hình Skills để biết toàn bộ lược đồ
skills.workshop - CLI Skills để biết các lệnh
openclaw skills