Hướng dẫn cách xây dựng các kỹ năng OpenClaw Skills tùy chỉnh cho quy trình tự động hóa của riêng bạn.

Các kỹ năng của OpenClaw Skills đơn giản đến mức đáng ngờ. Một “kỹ năng” chỉ là một thư mục chứa một SKILL.md tệp tin – đó là yêu cầu bắt buộc. Không cần SDK / biên dịch / môi trường chạy đặc biệt. Tất cả những gì bạn cần chỉ là phần đầu YAML cộng với các hướng dẫn bằng Markdown để dạy cho tác nhân một cách lặp lại để thực hiện một việc gì đó.

Sự đơn giản chính là điểm mấu chốt. Công cụ là những khả năng như đọc tập tin, chạy lệnh shell, duyệt web, gọi API. Kỹ năng là những cẩm nang hướng dẫn người dùng cách sử dụng các công cụ đó một cách có kỷ luật để đạt được kết quả nhất quán thay vì ứng biến.

Bài viết này nói về việc tự viết các kỹ năng của riêng bạn. Không phải cài đặt các kỹ năng có sẵn trong cộng đồng. Không phải “đây là danh sách các kỹ năng bạn nên sử dụng”. Mà là những vấn đề thực tiễn: đặt thư mục ở đâu, thứ tự ưu tiên hoạt động như thế nào, những trường nào trong phần frontmatter quan trọng, cách thức hoạt động của việc kiểm soát truy cập, cách làm cho một kỹ năng hiển thị dưới dạng lệnh gạch chéo và làm thế nào để tránh việc sử dụng quá nhiều token một cách không cần thiết.

Nếu bạn muốn tìm hiểu những kiến ​​thức cơ bản về kỹ năng và cách chúng hoạt động trong quá trình chạy, chúng tôi đã có một bài viết riêng: Hướng dẫn về kỹ năng OpenClaw. Bài viết này sẽ đi sâu hơn về cách xây dựng và phân phối kỹ năng của riêng bạn.

Kỹ năng OpenClaw là gì?

Tài liệu của OpenClaw mô tả các kỹ năng như các thư mục chứa một SKILL.md tệp có phần đầu YAML kèm theo hướng dẫn. Trang đó cũng giải thích rằng OpenClaw tải các kỹ năng được đóng gói sẵn cùng với các thiết lập ghi đè cục bộ, sau đó lọc tính đủ điều kiện dựa trên môi trường, cấu hình và các tệp nhị phân trên PATH. Tài liệu về kỹ năng của OpenClaw.

Có hai chi tiết quan trọng trong cuộc sống thực:

  • Kỹ năng không cấp quyền. Nếu chính sách công cụ của bạn chặn điều đó exec, thì một kỹ năng dựa vào các lệnh shell sẽ được tải nhưng sẽ thất bại khi cố gắng thực hiện công việc.
  • Kỹ năng là các chỉ dẫn vận hành. Kỹ năng không phải là một plugin tự động thực thi mã. Nó cho tác nhân biết cần chạy gì và định dạng đầu ra như thế nào. Sự khác biệt đó rất quan trọng đối với vấn đề bảo mật.

Kỹ năng nằm ở đâu và kỹ năng nào sẽ thắng

OpenClaw tải các kỹ năng từ nhiều nguồn khác nhau và sử dụng các quy tắc ưu tiên khi tên kỹ năng trùng nhau. Tài liệu CLI Openclaw Skills tóm tắt rằng nó kiểm tra các kỹ năng được đóng gói, không gian làm việc và các ghi đè được quản lý, đồng thời hiển thị tính đủ điều kiện và các yêu cầu còn thiếu. openclaw skills CLI.

Trên thực tế, hãy suy nghĩ theo từng lớp:

  • Kỹ năng không gian làm việc dành /skills/ cho một dự án hoặc đại lý cụ thể
  • Các kỹ năng được quản lý được ~/.openclaw/skills/ chia sẻ giữa các nhân viên trên máy đó.
  • Các kỹ năng được tích hợp sẵn trong OpenClaw.

Ngoài ra còn có tùy chọn “thư mục bổ sung” trong tệp cấu hình. Tài liệu tham khảo cấu hình kỹ năng skills.load.extraDirs ghi chú rằng các thư mục này được quét ở mức độ ưu tiên thấp nhất. Tài liệu cũng ghi lại các cài đặt trình theo dõi kỹ năng như skills.load.watchvà skills.load.watchDebounceMsCấu hình kỹ năng OpenClaw.

Tại sao bạn nên quan tâm đến thứ tự ưu tiên:

  • Nếu bạn sao chép một kỹ năng được đóng gói vào không gian làm việc của mình với cùng tên, phiên bản trong không gian làm việc của bạn sẽ được ưu tiên.
  • Nếu bạn phát hành một kỹ năng tùy chỉnh và sau đó cài đặt một kỹ năng cộng đồng có cùng tên, bạn có thể vô tình ghi đè lên kỹ năng này bằng kỹ năng kia.
  • Nếu hai kỹ năng có mô tả tương tự nhau, mô hình có thể chọn sai kỹ năng ngay cả khi thứ tự ưu tiên là chính xác. Cách đặt tên và cách diễn đạt mô tả rất quan trọng.

Cấu trúc tối thiểu của SKILL.md

Một kỹ năng bắt đầu bằng phần khai báo YAML. Tài liệu của OpenClaw nêu rõ rằng một kỹ năng là một thư mục chứa SKILL.md phần khai báo YAML và các hướng dẫn. Tài liệu về kỹ năng của OpenClaw.

Đây là ví dụ hợp lệ nhỏ nhất:

---
name: weekly-report
description: Summarize activity from logs and issue trackers into a weekly report.
---

# Weekly report

## Workflow
1. Read last 7 days of logs from the configured path.
2. List merged PRs and closed issues using the configured CLI tools.
3. Produce a markdown report with sections for work done, blockers and next steps.

Như vậy là đủ để OpenClaw nhận biết kỹ năng đó và xem xét việc sử dụng nó.

Như vậy vẫn chưa đủ để đảm bảo độ tin cậy.

Viết phần thân bài như một cuốn cẩm nang vận hành

Hầu hết các kỹ năng yếu kém đều thất bại vì nội dung văn bản giống như bài quảng cáo. Nhân viên cần một cẩm nang hướng dẫn với các bước cụ thể, điều kiện dừng và định dạng đầu ra rõ ràng.

Các phần giúp rèn luyện kỹ năng thực tế hiệu quả:

  • Chức năng của nó là mô tả khi nào nên sử dụng kỹ năng đó.
  • Cần cung cấp thông tin đầu vào bao gồm đường dẫn, URL, ID và thông tin đăng nhập bắt buộc.
  • Quy trình làm việc với các bước được đánh số và các lệnh chính xác.
  • Định dạng đầu ra sao cho kết quả luôn giống nhau trong mọi lần chạy.
  • Lan can bảo vệ và kiểm soát ảo giác
  • Phần xử lý lỗi giải thích những việc cần làm khi lệnh thất bại hoặc dữ liệu bị thiếu.
  • Ví dụ minh họa các truy vấn điển hình và hình dạng đầu ra dự kiến.

Hãy để ý điều còn thiếu: một phần giới thiệu dài dòng. Kỹ năng nên được trình bày giống như danh sách kiểm tra mà bạn sẽ đưa cho một kỹ sư trực đêm mệt mỏi lúc 3 giờ sáng.

Các trường thông tin đầu trang tốt

Tài liệu chính thức về kỹ năng trình bày những kiến ​​thức cơ bản về cách thức tìm kiếm và tải kỹ năng. Đối với các trường cấu hình ngoài tên và mô tả, một mô hình tư duy hữu ích là:

  • Các trường trải nghiệm người dùng kiểm soát cách kỹ năng hiển thị và cách bạn gọi kỹ năng đó.
  • Các trường điều khiển lời gọi xác định xem mô hình có thể gọi nó hay không.
  • Các trường siêu dữ liệu cho thông số kỹ thuật cổng và trình cài đặt

Tên và mô tả

Đây là những trường thông tin quan trọng nhất vì chúng quyết định khả năng tìm kiếm và độ chính xác. Hãy giữ cho chúng ngắn gọn và cụ thể. Nếu mô tả của bạn trùng lặp với một kỹ năng khác, mô hình đôi khi sẽ chọn sai ngay cả khi quy trình làm việc hoàn hảo.

Lệnh do người dùng gọi và lệnh gạch chéo

OpenClaw hỗ trợ các lệnh gạch chéo do người dùng nhập cho các kỹ năng khi kỹ năng đó có thể được người dùng gọi. Đó là cách “Tôi muốn chạy kỹ năng này một cách rõ ràng”. Nếu bạn muốn một kỹ năng không bao giờ tự động kích hoạt và chỉ chạy thông qua lệnh gạch chéo, bạn sẽ kết hợp nó user-invocable với một trường điều khiển gọi riêng biệt để loại bỏ nó khỏi ngữ cảnh mô hình.

Tài liệu hướng dẫn kỹ năng của chính Claude đã nói rõ: “user-invocableTrường này chỉ kiểm soát khả năng hiển thị menu, chứ không phải quyền truy cập công cụ Kỹ năng.”

Câu đó nói về Claude Code, nhưng ý chính vẫn áp dụng được. Đừng nhầm lẫn giữa “hiển thị cho người dùng” với “có sẵn cho mô hình”.

Disable-model-invocation cho các kỹ năng bạn chỉ chạy thủ công

Nếu một kỹ năng nào đó nguy hiểm hoặc quá rộng, hãy loại bỏ nó khỏi việc gọi mô hình và giữ nó như một công cụ thủ công. Tài liệu của Claude khuyên disable-model-invocation: true nên loại bỏ một kỹ năng “khỏi ngữ cảnh hoàn toàn”.

Điều đó tạo ra sự khác biệt lớn về độ an toàn và chi phí quản lý token vì tên và mô tả kỹ năng không được chèn vào mỗi lượt chơi.

Công cụ điều phối lệnh cho các lệnh xác định

Có một mô hình khá hay cho các kỹ năng cần hoạt động như các lệnh xác định: bỏ qua hoàn toàn mô hình và gửi trực tiếp đến một công cụ. Một chủ đề thảo luận gần đây trên cộng đồng mô tả điều này là “command-dispatch: tool” và lưu ý rằng nó có thể được sử dụng khi bạn muốn một lệnh kỹ năng có tính xác định.

Điều này hữu ích cho những việc như:

  • bao bọc một kịch bản an toàn với các đối số
  • đang chạy trình tạo báo cáo chỉ đọc
  • Gọi một công cụ với các đối số thô mà không có diễn giải LLM.

Điều này cũng làm giảm khả năng mô hình “tự động” thực hiện thêm các bước mà bạn không yêu cầu.

Siêu dữ liệu đối tượng openclaw

OpenClaw hỗ trợ một metadata trường trong frontmatter là một đối tượng JSON một dòng. Bên trong đó, openclaw có thể định nghĩa các quy tắc kiểm soát, hạn chế nền tảng và thông số kỹ thuật trình cài đặt. Ràng buộc định dạng chính là siêu dữ liệu phải giữ nguyên định dạng JSON một dòng để trình phân tích cú pháp có thể đọc được. Điều này được thảo luận trong nhiều tài liệu tham khảo cộng đồng và là một nguồn gốc phổ biến của câu hỏi “tại sao kỹ năng của tôi không tải được?”.

Một ví dụ thực tế:

---
name: server-health
description: Check CPU, memory, disk and network then report warnings.
metadata: {"openclaw":{"emoji":"????","requires":{"bins":["df","ps","uptime"],"os":["linux"]}}}
---

Kiểm tra cổng vào và điều kiện đủ điều kiện

Gating là yếu tố quyết định xem một kỹ năng có đủ điều kiện sử dụng trong môi trường hiện tại hay không. Tài liệu về kỹ năng của OpenClaw đề cập rằng nó lọc các kỹ năng khi tải dựa trên môi trường, cấu hình và sự hiện diện của tệp nhị phân. Tài liệu về kỹ năng của OpenClaw.

Trên thực tế, việc thiết lập ngưỡng trả lời một câu hỏi đơn giản: “Kỹ năng này có nên được sử dụng ngay bây giờ không?”

Các loại cổng thông thường

  • Kiểm soát hệ điều hành cho Linux, Darwin, Win32
  • Phân vùng nhị phân requires.bins để tác nhân không cố gắng thực hiện các lệnh bị thiếu.
  • Giới hạn môi trường thông qua requires.env đó kỹ năng này không đủ điều kiện nếu không có chứng chỉ.
  • Cấu hình giới hạn thông qua việc requires.config khi nào bạn cần bật một cờ cấu hình.

Khi một kỹ năng không đủ điều kiện, bạn cần có khả năng hiển thị thông tin. Giao diện dòng lệnh (openclaw skills CLI) tồn tại chính vì lý do này, và tài liệu hướng dẫn có đề cập rằng nó giúp bạn xem kỹ năng nào đủ điều kiện so với kỹ năng nào thiếu yêu cầu. openclaw skills CLI.

Điều kiện gỡ lỗi

Đây là những lệnh mà tôi thực sự sử dụng:

openclaw skills list
openclaw skills list --eligible
openclaw skills list --verbose
openclaw skills info my-skill
openclaw skills check

Điều quan trọng là phải ngừng đoán mò. Nếu kỹ năng của bạn đã được “cài đặt” nhưng không đủ điều kiện sử dụng, thì hầu hết là do thiếu tệp nhị phân hoặc biến môi trường, hoặc bị chặn bởi cơ chế kiểm soát của hệ điều hành.

Danh mục kỹ năng và người theo dõi

Bạn không muốn khởi động lại gateway mỗi khi điều chỉnh một bước trong quy trình làm việc. OpenClaw hỗ trợ theo dõi các thư mục kỹ năng và làm mới ảnh chụp nhanh khi SKILL.md có thay đổi. Tài liệu cấu hình hiển thị skills.load.watch các skills.load.watchDebounceMs thiết lập mặc định. Cấu hình kỹ năng OpenClaw.

Điều đó có nghĩa là bạn có thể lặp lại như sau:

  • chạy kỹ năng
  • Hãy xem lỗi nằm ở đâu.
  • chỉnh sửa SKILL.md
  • Chạy lại ở lượt tiếp theo

Nếu bạn không thấy các thay đổi có hiệu lực, hãy bắt đầu một phiên mới. Một số môi trường sẽ lưu trữ ảnh chụp nhanh kỹ năng khi bắt đầu phiên.

Mẫu kỹ năng dành cho sản xuất

Tôi khuyên bạn nên sao chép mẫu này cho những kỹ năng đầu tiên của mình. Nó bao gồm các phần thực hành và các quy tắc giúp ngăn ngừa “sự hỗn loạn hữu ích”.

---
name: weekly-ops-report
description: Generate a weekly ops report from logs and issue tracker data.
metadata: {"openclaw":{"emoji":"????️","requires":{"bins":["bash","date"],"os":["linux","darwin"]}}}
---

# Weekly ops report

## What it does
Builds a weekly report from local logs and optional issue tracker CLI output.

## Inputs needed
- LOG_DIR: directory with daily log files
- OPTIONAL: a CLI tool for your issue tracker if installed (gh, jira, etc.)

## Workflow
1) Verify LOG_DIR exists. If not, ask the user for the correct path.
2) Read logs from the last 7 days.
3) Extract:
   - incidents
   - recurring warnings
   - changes deployed
4) If gh is installed, list merged PRs and closed issues for the last 7 days.
5) Produce the report in the output format below.

## Output format
Return markdown with headings:
- Summary
- Incidents and fixes
- Changes deployed
- Customer-impacting items
- Next week

## Guardrails
- Never fabricate PR numbers, issue IDs or incident counts.
- If data is missing, state exactly what is missing.
- Do not restart services or change config.
- Stop after scanning 7 days of logs.

## Failure handling
- If a command fails, include the command and the error text then stop.
- If parsing is ambiguous, show the raw lines you used.

## Examples
User: "Generate the weekly ops report for /var/log/myapp"
Assistant: returns the report in the specified format.

Có hai lý do tại sao cách này hiệu quả:

  • Nó buộc phải xác thực dữ liệu đầu vào sớm.
  • Nó ngăn chặn tác nhân tạo ra dữ liệu khi thiếu dữ liệu đầu vào.

Các mẫu thiết kế kỹ năng (giúp bạn tiết kiệm thời gian sau này)

Giữ phạm vi hẹp

Nếu kỹ năng của bạn bao gồm “mọi thứ về triển khai” thì nó sẽ trùng lặp với các kỹ năng khác và dẫn đến hiệu quả không như mong muốn. Hãy tập trung vào phạm vi cụ thể. “Tạo báo cáo hàng tuần từ các nhật ký này” là tốt. “Quản lý hoạt động của tôi” là một thảm họa.

Ưu tiên chế độ chỉ đọc trước, sau đó mới thêm chế độ ghi sau

Hầu hết các quy trình tự động hóa có thể bắt đầu bằng báo cáo chỉ đọc. Khi bạn tin tưởng vào logic của nó, bạn có thể thêm các hành động như tạo tệp báo cáo hoặc di chuyển các mục vào thư mục lưu trữ.

Biến các hành động phá hoại thành tùy chọn

Nếu một kỹ năng có thể xóa tập tin hoặc thay đổi cài đặt sản xuất, hãy yêu cầu xác nhận rõ ràng trong sổ tay vận hành. Đồng thời, hãy cân nhắc việc loại bỏ nó khỏi quá trình gọi mô hình disable-model-invocation: true để nó chỉ chạy khi bạn gọi trực tiếp.

Hãy đặt các hằng số vào phần cấu hình chứ không phải vào phần thân hàm

Việc mã hóa cứng “/var/log/app” vào SKILL.md là ổn đối với một kỹ năng riêng tư. Nếu bạn muốn chia sẻ nó, hãy chuyển các đường dẫn vào các biến được ghi chú và đặt các giá trị mặc định trong tệp cấu hình để người dùng có thể ghi đè mà không cần chỉnh sửa kỹ năng đó.

Chi phí token phát sinh và cách kiểm soát nó

Mỗi kỹ năng đủ điều kiện sẽ thêm văn bản vào lời nhắc hệ thống. Ngay cả khi kỹ năng không được sử dụng, mô hình vẫn thấy một danh sách tóm tắt các kỹ năng, và danh sách đó tốn token. Tài liệu về kỹ năng của OpenClaw đề cập rằng nó tải các ghi đè được đóng gói và tùy chọn, sau đó chèn các bản tóm tắt.

Tôi làm gì để giữ cho mình tỉnh táo?

  • Hãy giữ cho phần mô tả ngắn gọn và cụ thể.
  • Tắt các kỹ năng mà bạn không sử dụng ngay bây giờ.
  • Sử dụng disable-model-invocationcho các kỹ năng mà bạn chỉ gọi thủ công.

Nếu bạn xây dựng nhiều kỹ năng nhỏ, hãy cân nhắc hợp nhất những kỹ năng có cùng tệp nhị phân và cùng miền. Không cần hợp nhất thành một kỹ năng khổng lồ, mà chỉ cần hợp nhất thành ít kỹ năng hơn với các lệnh phụ rõ ràng.

Ba cách để tạo ra một kỹ năng

Tạo kỹ năng từ đoạn chat rồi chỉnh sửa nó

Đây là cách nhanh nhất để soạn thảo bản nháp đầu tiên. Bạn mô tả quy trình tự động hóa, OpenClaw sẽ tạo ra mã SKILL.md, sau đó bạn chỉnh sửa nó thành một cuốn sổ tay vận hành. Đừng tin tưởng hoàn toàn vào bản nháp đầu tiên. Hãy coi nó như một dàn ý.

Viết SKILL.md thủ công

Tạo một thư mục rồi thêm tệp SKILL.md vào đó:

mkdir -p ~/.openclaw/skills/my-skill
nano ~/.openclaw/skills/my-skill/SKILL.md

Sau đó xác minh quá trình phát hiện:

openclaw skills list --eligible
openclaw skills info my-skill

Tài liệu hướng dẫn CLI đề cập đến các lệnh này. openclaw skills CLI.

Tạo một nhánh kỹ năng hiện có rồi thu hẹp phạm vi của nó.

Điều này thường bị đánh giá thấp. Nếu ai đó đã xây dựng 80% những gì bạn cần, hãy sao chép nó và thu nhỏ lại. Cải tiến phổ biến nhất là lan can bảo vệ. Kỹ năng giao thông cộng đồng thường thiếu các điều kiện dừng và quy tắc an toàn.

Xuất bản và chia sẻ kỹ năng của bạn

Bạn có một vài phương thức phân phối và mỗi phương thức đều có những ưu nhược điểm riêng.

Chia sẻ thư mục trong Git

Các kỹ năng nhóm riêng tư thường được lưu trữ trong kho lưu trữ riêng. Mọi người sao chép chúng vào kho lưu trữ đó ~/.openclaw/skills hoặc vào thư mục kỹ năng của không gian làm việc. Điều này đơn giản và dễ kiểm toán.

Đăng tải lên ClawHub

ClawHub là kho lưu trữ kỹ năng công khai của OpenClaw. Kho lưu trữ của dự án mô tả ClawHub là một kho lưu trữ công khai dành cho các kỹ năng của tác nhân dựa trên văn bản, được thiết kế để duyệt và có API thân thiện với giao diện dòng lệnh (CLI).

Nếu bạn công khai phát hành sản phẩm, bạn cần coi kỹ năng của mình như mã nguồn mở. Điều đó có nghĩa là: README rõ ràng, không giấu giếm điều gì, danh sách yêu cầu được chỉ định rõ ràng và các thiết lập mặc định an toàn.

Gói kỹ năng để cài đặt thông qua npm

Một số nhóm đóng gói các kỹ năng vào một gói npm để phân phối nội bộ, và OpenClaw có thể cài đặt gói đó. Điều này rất tiện lợi khi tổ chức của bạn đã sử dụng hệ thống phân phối npm.

Đối với việc phân phối rộng rãi, ClawHub thường là kênh dễ tìm kiếm hơn.

Các cảnh báo bảo mật bạn không nên bỏ qua

Kỹ năng là những chỉ dẫn cho phép tác nhân thực thi các lệnh. Điều đó có nghĩa là hệ sinh thái kỹ năng thu hút kẻ tấn công, và điều này đã trở nên rất rõ ràng vào đầu năm 2026.

Trang The Verge đã đưa tin về các kỹ năng OpenClaw độc hại được phân phối thông qua ClawHub, bao gồm cả các kỹ năng cố gắng lừa người dùng hoặc các đại lý chạy các lệnh cài đặt phần mềm đánh cắp thông tin.

Trang Tom’s Hardware cũng đưa tin về các kỹ năng độc hại được tải lên ClawHub nhắm vào người dùng tiền điện tử, dựa trên kỹ thuật thao túng tâm lý và thực thi lệnh trên thiết bị đầu cuối.

Điều này có ý nghĩa gì đối với bạn với tư cách là người tạo nội dung kỹ năng:

  • Tuyệt đối không hướng dẫn người dùng chạy các lệnh shell bị mã hóa trong tệp SKILL.md của bạn.
  • Tuyệt đối không yêu cầu người dùng dán thông tin bí mật vào khung chat. Hãy sử dụng cơ chế xác thực bằng biến môi trường và chèn cấu hình.
  • Giảm thiểu tối đa các mã nhị phân và các lệnh gọi mạng. Chỉ khai báo những gì bạn cần.
  • Hãy viết các rào cản để ngăn chặn tác nhân thực hiện các hành động bổ sung nằm ngoài nhiệm vụ được giao.

Điều này có nghĩa gì đối với bạn, người sử dụng kỹ năng:

  • Hãy đọc kỹ mọi tệp SKILL.md mà bạn cài đặt. Hãy coi nó như một bài đánh giá mã nguồn.
  • Kiểm tra bất kỳ tập lệnh nào bên trong thư mục kỹ năng.
  • Hãy thử nghiệm các kỹ năng mới trên một máy tính dùng một lần hoặc môi trường thử nghiệm trước.
  • Hãy bật chế độ phê duyệt của người điều hành cho đến khi bạn tin tưởng vào hành vi đó.

Nếu bạn muốn có hướng dẫn tăng cường bảo mật đầy đủ hơn, hãy sử dụng hướng dẫn của chúng tôi: Hướng dẫn về các biện pháp bảo mật tốt nhất cho OpenClaw.

Khắc phục sự cố kỹ năng tùy chỉnh

Kỹ năng này hoàn toàn không được liệt kê

  • Xác nhận thư mục đó nằm trong thư mục kỹ năng đã được quét.
  • Xác nhận tên tệp chính xácSKILL.md
  • Xác nhận phần đầu YAML bắt đầu và kết thúc bằng

Sau đó chạy lệnh:

openclaw skills list
openclaw skills check

Tài liệu hướng dẫn CLI đề cập đến các lệnh này. openclaw skills CLI.

Kỹ năng được liệt kê nhưng không bao giờ được kích hoạt

Đây hầu hết là do mô tả trùng lặp hoặc từ ngữ mơ hồ. Hãy thu gọn mô tả để nó phù hợp với mục đích rõ ràng. “Giám sát mức sử dụng ổ đĩa và cảnh báo” sẽ kích hoạt tốt hơn “trợ lý hệ thống”.

Nếu đó là một kỹ năng bạn chỉ muốn chạy một cách rõ ràng, hãy xóa nó khỏi lệnh gọi mô hình và sử dụng lệnh gạch chéo.

Kỹ năng được kích hoạt nhưng không thực thi được lệnh

Trước tiên hãy kiểm tra quyền truy cập của công cụ. Kỹ năng không tự động cấp quyền. Nếu chính sách công cụ của bạn chặn quyền thực thi, quy trình công việc sẽ không thể chạy các lệnh.

Sau đó kiểm tra điều kiện kiểm soát truy cập. Nếu kỹ năng của bạn yêu cầu jqvà nó chưa được cài đặt, hãy cài đặt hoặc xóa nó khỏi quy trình làm việc. Sử dụng openclaw skills list –verbose để xem các yêu cầu còn thiếu.

Lỗi phân tích siêu dữ liệu

Nếu bạn sử dụng siêu dữ liệu, hãy giữ nguyên định dạng JSON một dòng. Siêu dữ liệu nhiều dòng là nguyên nhân phổ biến gây ra lỗi phân tích cú pháp trong các hướng dẫn của bên thứ ba.

Các chỉnh sửa sẽ không có hiệu lực

Xác nhận rằng tính năng theo dõi kỹ năng đã được bật. Tài liệu cấu hình kỹ năng hiển thị skills.load.watch cài đặt debounce. Cấu hình kỹ năng OpenClaw. Nếu vẫn không cập nhật, hãy bắt đầu một phiên tác nhân mới.

Ý tưởng của bạn xứng đáng được lưu trữ tốt hơn.

https://lumadock.com/tutorials/build-custom-openclaw-skills

Bạn có thể cũng thích những nội dung này!