Xưởng Skills

Skill Workshop là quy trình được quản trị của OpenClaw để tạo và cập nhật các Skills trong không gian làm việc. Agent và người vận hành không bao giờ ghi trực tiếp vào SKILL.md thông qua quy trình này — họ tạo một đề xuất (bản nháp đang chờ xử lý 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), chỉ trở thành Skill đang hoạt động khi được áp dụng.

Skill Workshop chỉ ghi các Skills trong không gian làm việc. Công cụ này không bao giờ tác động đến Skills tích hợp sẵn, Plugin, ClawHub, ngoài thư mục gốc, được quản lý, của agent cá nhân hoặc hệ thống.

Cách hoạt động

• Đề xuất trước: nội dung được tạo được lưu dưới dạng PROPOSAL.md, không phải SKILL.md.
• Áp dụng là thao tác ghi trực tiếp duy nhất: tạo, cập nhật và chỉnh sửa không bao giờ thay đổi các Skills đang hoạt động.
• Giới hạn trong 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ỉ cho phép cập nhật các Skills 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.
• Ràng buộc bằng hàm băm: đề 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 thành stale nếu Skill đang hoạt động thay đổi trước khi áp dụng.
• 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 bề mặt nhất quán: trò chuyện, CLI và Gateway đều gọi cùng một dịch vụ.

Vòng đời

tạo/cập nhật -> đang chờ xử lýchỉnh sửa     -> đang chờ xử lýáp dụng       -> đã áp dụngtừ chối       -> đã từ chốicách ly       -> đã cách lyđích thay đổi -> lỗi thời

Chỉ đề xuất 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 Skills tổng hợp trong cơ sở dữ liệu trạng thái dùng chung. Mỗi ngày một lần, Gateway xem xét các Skills do Skill Workshop tạo và áp dụng. Những Skill không được sử dụng quá 30 ngày sẽ chuyển thành stale; sau 90 ngày, chúng chuyển thành archived và không được đưa vào ảnh chụp Skills của agent mới. Các tệp Skill đã lưu trữ vẫn không thay đổi trên đĩa. Các Skills được soạn thủ công không bao giờ được quản lý; chỉ các Skills đượ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 Skills được ghim bỏ qua các chuyển đổi vòng đời. Một Skill lỗi thời sẽ trở lại active sau khi được sử dụng và lượt rà soát tiếp theo chạy. Các Skills đã 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 ảnh chụp Skills hiện tại.

openclaw skills curator statusopenclaw skills curator pin <skill>openclaw skills curator unpin <skill>openclaw skills curator restore <skill>

Tất cả lệnh quản lý đều chấp nhận --json. Trạng thái cũng báo cáo các ứng viên trùng lặp một cách xác định nhưng chỉ dưới dạng gợi ý; lệnh này không bao giờ hợp nhất Skills hoặc gọi mô hình.

Trò chuyện

Hãy yêu cầu agent tạo Skill bạn muốn; agent sẽ gọi skill_workshop và trả về mã đề xuất.

Học từ công việc gần đây

Sử 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/learn docs/runbook.md and https://example.com/guide; focus on recovery

Khi không có yêu cầu, /learn đề nghị 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 xem các đường dẫn, URL, ghi chú được dán và tham chiếu 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 công cụ hiện có, sau đó gọi skill_workshop với action: "create".

Đề xuất tạo ra vẫn ở trạng thái pending; /learn không bao giờ áp dụng đề xuất đó. Hãy 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:

Tạo một Skill tên là morning-catchup để chạy quy trình hộp thư đến thứ Hai của tôi.

Cập nhật một Skill hiện có trong không gian làm việc:

Cập nhật trip-planning để kiểm tra cả sơ đồ ghế trước khi đặt chỗ.

Lặp lại trên một đề xuất đang chờ xử lý:

Hiển thị cho tôi đề xuất morning-catchup.Chỉnh sửa để đề xuất đó cũng gắn cờ mọi mục được đánh dấu khẩn cấp.Áp dụng đề xuất morning-catchup.

Các thao tác apply, reject và quarantine do agent khởi tạo mặc định sẽ hiển thị lời nhắc phê duyệt. Đặt skills.workshop.approvalPolicy thành "auto" để bỏ qua bước này trong môi trường đáng tin cậy.

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 nội dung. Yêu cầu phê duyệt được giới hạn thời gian để hoàn tất trước trình giám sát công cụ của agent. Nếu không có quyết định trước khi lời nhắc hết hạn, hành động vòng đời sẽ không chạy: đề xuất vẫn đang chờ xử lý 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 một hành động vòng đời đã hết hạn theo vòng lặp.

CLI

# Tạoopenclaw skills workshop propose-create \  --name morning-catchup \  --description "Bắt kịp hộp thư đến hằng ngày: phân loại, lưu trữ, làm nổi bật, soạn thảo, lập kế hoạch" \  --proposal ./PROPOSAL.md # Cập nhật một Skill hiện có trong không gian làm việcopenclaw skills workshop propose-update trip-planning --proposal ./PROPOSAL.md # Liệt kê và kiểm traopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id> # Chỉnh sửa trước khi phê duyệtopenclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.md # Kết thúcopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Trùng lặp"openclaw skills workshop quarantine <proposal-id> --reason "Cần xem xét bảo mật"

Mọi lệnh con đều nhận --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ờ xử lý, đề xuất được lưu dưới dạng PROPOSAL.md với frontmatter chỉ dành cho đề xuất:

---name: "morning-catchup"description: "Bắt kịp hộp thư đến hằng ngày: phân loại, lưu trữ, làm nổi bật, soạn thảo, lập kế hoạch"status: proposalversion: "v1"date: "2026-05-30T00:00:00.000Z"---

Khi áp dụng, Skill Workshop ghi 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ợ

Sử dụng --proposal-dir khi Skill được đề xuất cần các tệp bên cạnh PROPOSAL.md:

openclaw skills workshop propose-create \  --name weekly-update \  --description "Tổng kết thứ Sáu: số liệu thống kê, điểm nổi bật, ba ưu tiên hàng đầu của tuần tới" \  --proposal-dir ./weekly-update-proposal

Thư mục phải chứa PROPOSAL.md. Các tệp hỗ trợ phải nằm trong assets/, examples/, references/, scripts/ hoặc templates/. Skill Workshop quét, 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ụng skill_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 hành động:

Agent phải sử dụng skill_workshop cho công việc tạo Skill. Agent không được tạo hoặc thay đổi 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.

Skills được đề xuất

OpenClaw phát hiện các chỉ dẫn lâu dài như “lần tới”, “hãy nhớ” và các chỉnh sửa 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. Ở lượt tiếp theo, agent đề nghị lưu quy trình được phát hiện gần nhất thông qua skill_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. Hãy bật skills.workshop.autonomous.enabled để trực tiếp tạo các đề xuất đang chờ xử lý.

Phê duyệt và tự chủ

{  skills: {    workshop: {      autonomous: {        enabled: false,      },      allowSymlinkTargetWrites: false,      approvalPolicy: "pending",      maxPending: 50,      maxSkillBytes: 40000,    },  },}

Tính năng thu thập tự động nhận diện các quy tắc hướng đến tương lai (ví dụ: “từ bây giờ”) và các chỉnh sửa mang tính phản hồi (ví dụ: “đó không phải điều tôi yêu cầu”). Tính năng này nhóm các chỉ dẫn mới theo chủ đề thành tối đa ba đề xuất mỗi lượt, định tuyến các từ vựng trùng khớp đến các Skills hiện có có thể ghi trong không gian làm việc và chỉnh sửa đề 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 một Skill.

Phần mô tả đề xuất luôn bị giới hạn ở 160 byte, không phụ thuộc vào maxSkillBytes.

Phương thức Gateway

requestRevision chỉ có trên Gateway (không có chức năng tương đương trong CLI hoặc công cụ của tác tử): phương thức này chuyển tiếp hướng dẫn chỉnh sửa dạng văn bản tự do đến phiên trò chuyện của tác tử sở hữu thay vì trực tiếp thay thế PROPOSAL.md, dành cho các giao diện người dùng yêu cầu tác tử chỉnh sửa thay vì gửi nội dung mới theo nghĩa đen.

Lưu trữ

&lt;OPENCLAW_STATE_DIR&gt;/skill-workshop/  proposals.json  proposals/<proposal-id>/    proposal.json    PROPOSAL.md    rollback.json    assets/    examples/    references/    scripts/    templates/

Thư mục trạng thái mặc định: ~/.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 kỹ năng đang chờ xử lý.
• rollback.json: siêu dữ liệu khôi phục được ghi trước khi áp dụng thay đổi vào 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 phép 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 với allow hoặc alsoAllow. Các tài liệu vận hành cũ vẫn có thể 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à in cùng gợi ý chính sách khi thích hợp.

Liên quan

• Skills để tìm hiểu thứ tự tải, độ ưu tiên và khả năng hiển thị
• Tạo kỹ năng để tìm hiểu kiến thức cơ bản về cách viết thủ công SKILL.md
• Cấu hình Skills để xem lược đồ skills.workshop đầy đủ
• CLI Skills để tìm hiểu các lệnh openclaw skills