Chuyển đến nội dung chính
Hướng dẫn AI

Cách cài đặt và sử dụng các kỹ năng tác nhân genspark-claw trên OpenClaw, Hermes, Claude Code và Cursor

Tìm hiểu cách cài đặt genspark-claw, kiểm tra các kỹ năng đi kèm, triển khai chúng trên các môi trường chạy tác nhân tương thích, sử dụng máy chủ MCP, xác thực kỹ năng tùy chỉnh và làm việc với dự án bằng lập trình.

Thời gian đọc khoảng 18 phút
Cách cài đặt và sử dụng các kỹ năng tác nhân genspark-claw trên OpenClaw, Hermes, Claude Code và Cursor

genspark-claw là gì?

genspark-claw là một bộ kỹ năng và giao diện dòng lệnh do cộng đồng xây dựng dành cho Genspark Claw, OpenClaw, Hermes, Claude Code và Cursor. Công cụ cung cấp năm quy trình SKILL.md dễ đọc, bổ sung các khả năng thực tiễn cho những tác tử AI tương thích mà không yêu cầu dependency thời gian chạy hoặc bước build.

Dự án hoạt động độc lập và không liên kết với Genspark, OpenClaw hoặc Nous Research. Vì các kỹ năng là những tệp Markdown thuần túy có YAML frontmatter, bạn có thể kiểm tra, xác thực, chỉnh sửa và cài đặt chúng vào các runtime được hỗ trợ.

Tính năng chính

  • Năm kỹ năng sẵn sàng cho môi trường production: nghiên cứu chuyên sâu, tạo báo cáo, lập kế hoạch slide, tự động hóa trình duyệt và chuẩn bị cuộc gọi điện thoại.
  • Tương thích đa runtime: cài đặt cùng một bộ kỹ năng vào OpenClaw, Hermes, Claude Code, Cursor hoặc workspace cục bộ.
  • Không có dependency thời gian chạy: CLI sử dụng thư viện chuẩn của Node.js và yêu cầu Node.js 18 trở lên.
  • Xác thực bảo mật: trình xác thực kiểm tra cấu trúc kỹ năng và phát hiện các mẫu như thực thi từ xa qua pipe, payload base64 và lệnh phá hoại.
  • Hỗ trợ MCP: cung cấp bộ kỹ năng cho các client MCP như Claude Desktop, Cursor và Windsurf.
  • Kiểm thử và CI: dự án bao gồm các bài kiểm thử tự động và phạm vi CI cho Node.js 18, 20 và 22 trên Ubuntu, macOS và Windows.

Tìm hiểu các kỹ năng đi kèm

Gói này bao gồm năm kỹ năng, mỗi kỹ năng được lưu trong thư mục riêng cùng một tệp SKILL.md.

  • super-research: phân rã câu hỏi, thực hiện các lượt tìm kiếm song song, đối chiếu tuyên bố giữa các nguồn độc lập và tạo báo cáo có trích dẫn.
  • spark-report: chuyển nghiên cứu, ghi chú hoặc cuộc trò chuyện thành báo cáo hoàn chỉnh với phần tóm tắt điều hành, bảng so sánh, trích dẫn và các bước tiếp theo.
  • spark-slides: chuyển nghiên cứu hoặc ý tưởng thành dàn ý bộ slide có mạch kể chuyện, tiêu đề định hình theo luận điểm, ghi chú thuyết trình và nguồn.
  • claw-browser-anchor: giúp tự động hóa trình duyệt đáng tin cậy hơn bằng cách sử dụng bộ chọn DOM và vai trò ARIA thay cho tọa độ màn hình dễ hỏng, kèm xác minh và khôi phục khi giao diện thay đổi.
  • call-prep: chuẩn bị cuộc gọi điện thoại bằng AI thông qua việc nghiên cứu người nhận cuộc gọi, xác định mục tiêu và phương án dự phòng, soạn kịch bản phân nhánh và cấu trúc bản tóm tắt sau cuộc gọi.

Cài đặt và kiểm tra CLI

Điều kiện tiên quyết

Cài đặt Node.js 18 trở lên. Dự án khuyến nghị sử dụng hướng dẫn tải xuống Node.js chính thức. Trên macOS, trước tiên hãy cài đặt các công cụ dòng lệnh của Apple:

xcode-select --install

Người dùng Linux và Windows có thể bỏ qua bước cài đặt công cụ dòng lệnh dành cho macOS. Không yêu cầu đăng ký Genspark vì gói này có thể được sử dụng với OpenClaw, Hermes, Claude Code hoặc Cursor tự lưu trữ.

Cài đặt từ GitHub

Tạo thư mục làm việc, cài đặt trực tiếp repository từ GitHub và chạy kiểm tra tình trạng:

mkdir -p 'gensparkclaw' && cd 'gensparkclaw'
npm install github:breakstageaxe61/genspark-claw
npx genspark-claw doctor
npx genspark-claw list

Lệnh doctor kiểm tra môi trường và các runtime của bạn. Lệnh list hiển thị năm kỹ năng đi kèm cùng phần mô tả.

Cài đặt kỹ năng vào runtime của tác tử

OpenClaw hoặc Genspark Claw

Cài đặt mọi kỹ năng đi kèm vào thư mục kỹ năng OpenClaw mặc định:

npx genspark-claw install all --target openclaw

Lệnh này sao chép các kỹ năng vào ~/.openclaw/skills/. Nếu đang sử dụng gateway OpenClaw tự lưu trữ, hãy khởi động lại gateway hoặc bắt đầu một phiên mới để các kỹ năng khả dụng. Trong Genspark Claw, hãy nhập các tệp SKILL.md thông qua bảng kỹ năng hoặc sao chép chúng từ node_modules/genspark-claw/skills/.

Hermes

Cài đặt tất cả kỹ năng vào Hermes bằng lệnh:

npx genspark-claw install all --target hermes

Đích mặc định là ~/.hermes/skills/.

Claude Code và Cursor

Sử dụng các target dành riêng cho từng runtime để cài đặt tệp vào thư mục kỹ năng tiêu chuẩn của chúng:

npx genspark-claw install all --target claude
npx genspark-claw install all --target cursor

Các lệnh này lần lượt sử dụng ~/.claude/skills/ và ~/.cursor/skills/ làm đích.

Cài đặt vào workspace dự án

Để cài đặt cục bộ cho dự án, hãy cài đặt một kỹ năng hoặc toàn bộ bộ kỹ năng vào thư mục tùy chỉnh:

npx genspark-claw install super-research
npx genspark-claw install all --dir ~/my-agent/skills

Sử dụng --dry-run khi muốn xem trình cài đặt sẽ thực hiện gì mà không ghi tệp:

npx genspark-claw install all --target openclaw --dry-run

Sử dụng các lệnh CLI

CLI hỗ trợ khám phá, cài đặt, xác thực, chẩn đoán và khởi động MCP:

genspark-claw <command> [options]
  • list liệt kê tất cả kỹ năng đi kèm.
  • info <skill> hiển thị thông tin chi tiết và toàn bộ hướng dẫn cho một kỹ năng.
  • install [skill] cài đặt một kỹ năng hoặc tất cả kỹ năng.
  • validate [path] xác thực các tệp SKILL.md, mặc định là các kỹ năng đi kèm.
  • doctor kiểm tra môi trường cục bộ và các runtime được phát hiện.
  • runtimes liệt kê các runtime của tác tử được phát hiện.
  • mcp khởi động máy chủ MCP stdio.
  • version in ra phiên bản đã cài đặt.

Ví dụ, hãy kiểm tra một skill trước khi cài đặt:

npx genspark-claw info super-research

Đọc trước hướng dẫn của skill là một thực hành hữu ích về bảo mật và khả năng tương thích, đặc biệt khi làm việc với các skill agent của bên thứ ba.

Kết nối máy chủ MCP

genspark-claw bao gồm một máy chủ Model Context Protocol không có dependency. Máy chủ này cung cấp ba công cụ: list_skills, get_skill và validate_skill.

Thêm máy chủ vào cấu hình MCP của Claude Desktop bằng đường dẫn tuyệt đối đến máy chủ đã cài đặt:

{
  "mcpServers": {
    "genspark-claw": {
      "command": "node",
      "args": ["/absolute/path/to/gensparkclaw/node_modules/genspark-claw/mcp/mcp-server.js"]
    }
  }
}

Chạy bài tự kiểm tra tích hợp để xác minh việc khởi tạo, phát hiện công cụ và thực thi công cụ:

node node_modules/genspark-claw/mcp/mcp-server.js --test

Tự kiểm tra MCP thành công: initialize, tools/list, tools/call đều OK.

Xác thực skill an toàn

Chạy bước xác thực đối với các tệp đi kèm trước khi sử dụng:

npx genspark-claw validate

Bạn cũng có thể xác thực một thư mục tùy chỉnh:

npx genspark-claw validate ./my-skills

Trình xác thực kiểm tra schema skill dự kiến và thực hiện kiểm tra bảo mật. Công cụ này sẽ phát hiện các mẫu như curl | bash, payload base64 và các lệnh mang tính phá hoại. Việc xác thực giúp giảm rủi ro, nhưng bạn vẫn nên đọc toàn bộ SKILL.md và sử dụng các công cụ kiểm tra hoặc doctor của agent.

Tạo và đóng góp skill tùy chỉnh

Skill tùy chỉnh là một thư mục chứa tệp SKILL.md. Phần frontmatter nên định nghĩa các trường như name, description, version, triggers, compatibility và metadata JSON trên một dòng. Phần nội dung tài liệu nên bao gồm hướng dẫn được đánh số, quy tắc, xử lý lỗi và định dạng đầu ra.

  1. Tạo một thư mục và tệp.
  2. Tuân theo cấu trúc skill được mô tả trong hướng dẫn đóng góp của kho mã.
  3. Chạy npm run validate để kiểm tra schema và các quy tắc bảo mật.
  4. Chạy npm test để thực thi bộ kiểm thử tự động.
  5. Mở pull request nếu bạn muốn chia sẻ skill.

Kho mã cũng hỗ trợ xuất bản skill tương thích lên ClawHub bằng clawhub publish. Định dạng tệp thuần túy này được thiết kế để hoạt động với Hermes và các công cụ tương thích với agentskills.io.

Sử dụng API lập trình

Nếu bạn tích hợp genspark-claw vào một ứng dụng Node.js khác, hãy require package và gọi API công khai:

const gclaw = require('genspark-claw');

gclaw.listBundledSkills();
gclaw.findSkill('super-research');
gclaw.installSkills({ skill: 'all', target: 'hermes' });
gclaw.validateTarget('./my-skills/');
gclaw.runDoctor();

Các phương thức trả về bản ghi skill, kết quả xác thực hoặc dữ liệu kiểm tra môi trường để bạn có thể sử dụng trong các công cụ của riêng mình.

Phát triển cục bộ

Để làm việc trực tiếp trên dự án, hãy sao chép kho mã và chạy các lệnh kiểm thử và xác thực:

git clone https://github.com/breakstageaxe61/genspark-claw.git
cd genspark-claw
npm test
npm run validate
node examples/quickstart.js
node mcp/mcp-server.js --test

Không cần npm install để phát triển vì dự án chủ động duy trì trạng thái không có dependency. Các khu vực quan trọng gồm điểm vào CLI trong bin/, API công khai trong src/index.js, các skill trong skills/, máy chủ MCP trong mcp/ và các bài kiểm thử trong test/.

Kết luận

genspark-claw cung cấp một cách đơn giản để thêm các quy trình có thể tái sử dụng và kiểm tra được vào nhiều môi trường agent AI. Hãy cài đặt từ GitHub, sử dụng doctor và list để xác minh thiết lập, triển khai skill với mục tiêu runtime và sử dụng validate trước khi đưa vào các hướng dẫn tùy chỉnh hoặc của bên thứ ba. Đối với việc tích hợp, máy chủ MCP tích hợp sẵn và API Node.js giúp cung cấp cùng một bộ skill thông qua các công cụ và ứng dụng.