跳到主要内容
AI教程

如何在 OpenClaw、Hermes、Claude Code 和 Cursor 中安装并使用 genspark-claw Agent Skills

了解如何安装 genspark-claw、检查其捆绑的技能，将这些技能部署到兼容的 Agent 运行时，使用 MCP 服务器，验证自定义技能，并以编程方式操作项目。

AI我搜编辑部阅读约 10 分钟
如何在 OpenClaw、Hermes、Claude Code 和 Cursor 中安装并使用 genspark-claw Agent Skills

什么是 genspark-claw？

genspark-claw 是一个由社区构建的技能包和命令行界面，适用于 Genspark Claw、OpenClaw、Hermes、Claude Code 和 Cursor。它提供五个易于阅读的 SKILL.md 工作流，为兼容的 AI 代理增加实用功能，且不需要运行时依赖或构建步骤。

该项目独立开发，与 Genspark、OpenClaw 或 Nous Research 没有关联。由于这些技能是带有 YAML frontmatter 的纯 Markdown 文件，因此你可以检查、验证、修改它们，并将其安装到受支持的运行时中。

主要功能

  • 五项可用于生产环境的技能：深度研究、报告生成、幻灯片规划、浏览器自动化和电话准备。
  • 跨运行时兼容：可将相同的技能安装到 OpenClaw、Hermes、Claude Code、Cursor 或本地工作区中。
  • 零运行时依赖：CLI 使用 Node.js 标准库，并要求 Node.js 18 或更高版本。
  • 安全验证：验证器会检查技能结构，并标记管道式远程执行、Base64 负载和破坏性命令等模式。
  • 支持 MCP：可将技能包提供给 Claude Desktop、Cursor 和 Windsurf 等 MCP 客户端。
  • 测试与 CI：项目包含自动化测试，并在 Ubuntu、macOS 和 Windows 上为 Node.js 18、20 和 22 提供 CI 覆盖。

了解内置技能

该软件包包含五项技能，每项技能都存储在自己的目录中，并包含一个 SKILL.md 文件。

  • super-research：分解问题，执行并行搜索，跨独立来源交叉验证主张，并生成带引用的报告。
  • spark-report：将研究资料、笔记或对话整理为精美报告，包含执行摘要、对比表、引用和后续步骤。
  • spark-slides：将研究资料或想法转换为叙事式幻灯片大纲，包含以主张为核心的标题、演讲者备注和来源。
  • claw-browser-anchor：使用 DOM 选择器和 ARIA 角色，而不是脆弱的屏幕坐标，让浏览器自动化更加可靠，并支持验证和漂移恢复。
  • call-prep：准备 AI 电话，包括调查接听者、定义目标和备选方案、起草分支式脚本，以及构建通话后摘要。

安装并检查 CLI

前置条件

安装 Node.js 18 或更高版本。项目建议使用官方的 Node.js 下载说明。在 macOS 上，请先安装 Apple 的命令行工具：

xcode-select --install

Linux 和 Windows 用户可以跳过 macOS 命令行工具步骤。不需要 Genspark 订阅，因为该软件包可与自托管的 OpenClaw、Hermes、Claude Code 或 Cursor 配合使用。

从 GitHub 安装

创建工作目录，直接从 GitHub 安装仓库，然后运行健康检查：

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

doctor 命令会检查你的环境和运行时。list 命令会显示五项内置技能及其说明。

将技能安装到代理运行时

OpenClaw 或 Genspark Claw

将所有内置技能安装到默认的 OpenClaw 技能目录：

npx genspark-claw install all --target openclaw

这会将技能复制到 ~/.openclaw/skills/。如果你使用的是自托管的 OpenClaw 网关，请重启网关或开始新会话，使技能变为可用。在 Genspark Claw 中，可通过技能面板导入 SKILL.md 文件，或从 node_modules/genspark-claw/skills/ 复制这些文件。

Hermes

使用以下命令将所有技能安装到 Hermes：

npx genspark-claw install all --target hermes

默认目标目录为 ~/.hermes/skills/。

Claude Code 和 Cursor

使用特定于运行时的目标，将文件安装到其标准技能目录：

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

这些命令分别针对 ~/.claude/skills/ 和 ~/.cursor/skills/。

安装到项目工作区

如需安装到项目本地，可将单项技能或完整技能包安装到自定义目录：

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

如果你想查看安装程序将执行的操作而不写入文件，请使用 --dry-run：

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

使用 CLI 命令

CLI 支持发现、安装、验证、诊断和启动 MCP：

genspark-claw <command> [options]
  • list 列出所有内置技能。
  • info <skill> 显示技能详情和完整说明。
  • install [skill] 安装单项技能或全部技能。
  • validate [path] 验证 SKILL.md 文件，默认为内置技能。
  • doctor 检查本地环境和检测到的运行时。
  • runtimes 列出检测到的代理运行时。
  • mcp 启动 MCP stdio 服务器。
  • version 输出已安装的版本。

例如，在安装技能之前先进行检查：

npx genspark-claw info super-research

先阅读技能说明是一项有用的安全与兼容性实践，尤其是在使用第三方代理技能时。

连接 MCP 服务器

genspark-claw 内置了一个零依赖的模型上下文协议服务器。它提供三个工具：list_skills、get_skill 和 validate_skill。

使用已安装服务器的绝对路径，将服务器添加到 Claude Desktop 的 MCP 配置中：

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

运行内置自测，以验证初始化、工具发现和工具执行：

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

MCP 自测通过：initialize、tools/list、tools/call 全部正常。

安全验证技能

使用捆绑文件前，先对其运行验证：

npx genspark-claw validate

你也可以验证自定义目录：

npx genspark-claw validate ./my-skills

验证器会检查预期的技能架构并执行安全审计。它会标记包括 curl | bash、Base64 载荷和破坏性命令在内的模式。验证可以降低风险，但你仍应完整阅读 SKILL.md，并使用代理自身的审计或诊断工具。

创建并贡献自定义技能

自定义技能是一个包含 SKILL.md 文件的目录。前置元数据应定义 name、description、version、triggers、compatibility 等字段，以及单行元数据 JSON。文档正文应包含编号说明、规则、错误处理和输出格式。

  1. 创建目录和文件。
  2. 遵循仓库贡献指南中介绍的技能结构。
  3. 运行 npm run validate，检查架构和安全规则。
  4. 运行 npm test，执行自动化测试套件。
  5. 如果想分享技能，请创建一个拉取请求。

该仓库还支持使用 clawhub publish 将兼容技能发布到 ClawHub。同一种纯文件格式也适用于 Hermes 和兼容 agentskills.io 的工具。

使用编程 API

如果要将 genspark-claw 集成到其他 Node.js 应用程序中，请引入该软件包并调用其公共 API：

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

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

这些方法会返回技能记录、验证结果或环境检查数据，你可以在自己的工具中使用这些数据。

本地开发

要参与项目本身的开发，请克隆仓库并运行其测试与验证命令：

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

开发时无需运行 npm install，因为该项目有意保持零依赖。重要目录包括 bin/ 中的 CLI 入口点、src/index.js 中的公共 API、skills/ 中的技能、mcp/ 中的 MCP 服务器，以及 test/ 中的测试。

结语

genspark-claw 提供了一种直接的方式，可将可复用、可检查的工作流添加到多个 AI 代理环境中。从 GitHub 安装后，使用 doctor 和 list 验证设置，通过运行时目标部署技能，并在引入自定义或第三方说明前使用 validate。对于集成场景，内置 MCP 服务器和 Node.js API 可以让同一技能包通过工具和应用程序使用。