About · 安装使用
AI 灵魂与 Skill 安装使用指引
本页重点说明两件事：常见 AI Agent 一般怎么安装 Skill，以及 AISoulHub 提出的 AI 灵魂应该怎样下载安装到不同工具里使用。
一、先理解下载包
AISoulHub 下载的一般是 zip 包，但不同内容类型和不同 AI Agent 的安装方式并不完全一样。你可以先把它理解成两类：一类是可直接导入或复制使用的 AI 灵魂包，另一类是更适合放进 Skill / 项目知识 / Agent 指令里的 Skill 包。
AI 灵魂包
更偏向一个完整角色或长期陪伴设定。常见做法是直接上传 zip、解压后导入，或者把其中的核心说明复制到目标工具。OpenClaw / XClaw、Claude Code、ChatGPT 客户端、Hermes Agent 等通常都能走这类路径。
Skill 包
更偏向一个能力、流程或人物材料包。适合安装到支持 Skills 的工具中，或者拆开后放进项目知识、系统提示词、工作流说明。人物蒸馏 Skill 和灵魂塑造 Skill 都属于这一类。
常见 AI Agent 安装路径一览
| 工具 | 典型安装方式 | 补充说明 |
|---|---|---|
| Claude Code | Skill 市场 / `npx skills add` / 直接对话安装 AI 灵魂 | 既适合安装 Skill，也适合把 AI 灵魂 zip 直接发进对话使用。 |
| OpenAI GPT（Codex CLI / ChatGPT 客户端） | `npx skills add` / 上传 ZIP / 粘贴说明 / 项目文件 | Codex CLI 更偏 Skill，ChatGPT / 客户端更偏项目与对话，但都属于 OpenAI GPT 侧能力。 |
| OpenClaw / XClaw | 对话内安装 / CLI / 市场安装 / ZIP 导入 / 从文件创建 | 最适合直接安装 AI 灵魂包，也兼容 SkillHub / ClawHub 生态。 |
| Hermes Agent | 对话内安装 / CLI 安装 / 粘贴 `hermes-instructions.md` | 既支持 Skill 路线，也支持 AI 灵魂的 Hermes 定向说明文本。 |
| Cursor / Copilot / Cline / Roo / Trae | 手动复制 / Rules / 项目知识 | 这组工具更适合安装 Skill 或把 AI 灵魂拆成项目规则，不是最适合“直接对话安装 AI 灵魂”的形态。 |
二、安装使用 Skill
人物蒸馏 Skill 和灵魂塑造 Skill 本质上都属于 Skill：前者更偏人物材料与表达风格蒸馏，后者更偏优化或改写 AI 灵魂的工作流。对用户来说，它们的安装方式大同小异，重点看目标 Agent 支持哪种 Skill 路线。
常见 Skill 安装方式
| 方式 | 适用 Agent | 说明 |
|---|---|---|
| Skill 市场 / 对话内安装 | Claude Code / OpenClaw / Hermes Agent | 最适合熟悉 Skill 生态的用户，直接搜索安装即可。 |
| CLI 安装 | Codex CLI / Claude Code / OpenClaw / Hermes Agent | 例如 `npx skills add`、`clawhub install`、`skillhub_install install_skill` 等。 |
| 手动复制到技能目录 | Claude Code / Codex CLI / Cursor / Copilot / Cline / Roo / Trae | 适合通用 Skill 包，或目标工具没有现成市场时使用。 |
| 拆成项目知识 / Rules / 系统提示词 | Cursor / Copilot / Cline / Roo / Trae / ChatGPT clients | 如果工具不支持结构化 Skill，就打开 `SKILL.md` 和相关文件，按步骤、边界、输出格式手动迁移。 |
- 人物蒸馏 Skill：把它当成“人物材料 + 思维方式 + 表达边界”的能力包，而不是让 AI 冒充真实人物本人。
- 灵魂塑造 Skill：更适合用于改写、评估和优化 AI 灵魂源文件，通常不是一个单独聊天角色。
- 如果工具支持 Skill，就优先走 Skill 安装；如果不支持，就把 `SKILL.md` 的触发条件、步骤、输出格式和边界搬过去。
三、安装使用 AI 灵魂
- 在详情页确认当前查看版本，优先下载最新通过审核的版本。
- 按你的使用工具下载对应 zip；如果只是想快速测试，直接下载最顺手的那一种即可。
- 打开 zip 里的 README 或 IMPORT_GUIDE，根据说明复制系统提示词、人格设定、边界和记忆策略。
- 先用详情页试聊或工具里的临时对话验证风格，再放入长期使用环境。
2.1 直接把 zip 发给 Agent 安装
这条路径最省事，尤其适合 OpenClaw / XClaw、Claude、ChatGPT 客户端、Hermes Agent 这类已经支持读包和解释 Markdown 指令的工具。你只需要上传 zip，再给一句类似“安装这个 AI 灵魂并开始使用”的指令。
把下载包直接发给 OpenClaw，并让它安装应用到当前 Agent。
点击 / 双击图片可放大查看
Hermes Agent 可以直接接收 Hermes 目标下载包，先检查其中的说明文件，再进入初始化。
点击 / 双击图片可放大查看
Claude 类客户端适合直接读取压缩包里的设定，再在对话里开始角色使用。
点击 / 双击图片可放大查看
如果客户端支持文件上传，这种方式也很自然；不支持时就改为解压后复制核心 Markdown。
点击 / 双击图片可放大查看
在 QClaw 对话中直接导入 AI 灵魂包，适合习惯用聊天指令完成安装的用户。
点击 / 双击图片可放大查看
WorkBuddy 中的对话式安装示例，展示从安装提示到确认导入的完整路径。
点击 / 双击图片可放大查看
2.2 使用 AI Agent 的内置文件导入或文字描述能力
如果使用一些带有内置导入能力的 AI Agent，如 QClaw 的 OpenClaw 内核版本，可以通过 AI Agent 内置导入能力“新建 Agent → 自定义创建 → 从文件创建 / 导入包”的流程直接导入 AI 灵魂包； 有一些 AI Agent 需要通过描述的方式进行 AI Agent 风格定义，不方便直接装包，这时可以选择平台 “Hermes” 下载 AI 灵魂包，解压后取出 `hermes-instructions.md`，把内容粘贴到对应的初始化说明位置。
先新建 Agent，再选择自定义创建，最后把 AISoulHub 下载的压缩包导入进去。
点击 / 双击图片可放大查看
在支持描述式初始化的宿主里，可以直接把定向说明粘贴进去完成初始化。
点击 / 双击图片可放大查看
2.3 AI 灵魂使用效果图
下面这些图不是安装步骤，而是导入完成后的实际使用效果。它们更适合帮助用户理解：AI 灵魂安装成功后，大概会以什么形态存在于不同 Agent 里。
OpenClaw 侧的实际体验。
点击 / 双击图片可放大查看
Hermes 侧的使用效果，更偏终端式长期交互。
点击 / 双击图片可放大查看
Claude 中的实际使用效果。
点击 / 双击图片可放大查看
如果是客户端型工具，通常会以项目、会话或自定义助手的形式长期保留。
点击 / 双击图片可放大查看
QClaw 中的 AI 灵魂使用效果，展示导入后如何在真实对话中延续人格与任务风格。
点击 / 双击图片可放大查看
WorkBuddy 中的 AI 灵魂使用示例，展示安装完成后作为长期助手参与实际协作。
点击 / 双击图片可放大查看
四、常见问题
- 下载后不知道看哪个文件：先看 README.md，再看 IMPORT_GUIDE.md。
- 导入后风格不像：确认是否完整复制了人格设定、边界、示例和使用场景。
- 工具不支持上传 zip：解压后复制核心 markdown 文件内容。
- 导入后提示冲突：优先保留平台包里的边界、安全约束和使用场景，再按你的工具格式调整文件名。
- 发现内容问题：回到详情页举报，或通过留言反馈告诉我们。
五、官方参考
不同工具的导入方式会随官方产品更新变化。AISoulHub 下载包尽量保留通用 Markdown 源文件，并按目标工具生成额外说明；遇到差异时，以目标工具官方说明为准。