核心用法
ClawSouls 是 OpenClaw 生态的官方 AI 人格（Soul）包管理器，采用 owner/name 命名空间与 npm 风格的版本控制。用户可通过 CLI 完成 Soul 的浏览、安装、激活、备份恢复与发布全流程。
典型工作流：clawsouls install → use → openclaw gateway restart 完成人格切换；init → validate → publish 完成自定义 Soul 上架。系统在安装新 Soul 时自动备份 workspace 核心文件（SOUL.md、IDENTITY.md 等），保留用户数据文件（USER.md、MEMORY.md）不被覆盖，降低切换风险。
显著优点
- 丰富预设：79+ 官方 Soul 覆盖开发（code-reviewer、ml-engineer）、写作（tech-writer、poet）、MBTI 全谱系、生活方式等 8 大类别，即装即用
- 版本控制：支持
@version精准安装与--force覆盖，便于锁定稳定人格或测试新版 - 安全备份：
use命令自动创建备份，restore一键回滚，避免人格切换导致配置丢失 - 开放创作：
init+validate+publish三步完成个人 Soul 上架，支持公开评分与多语言（英/韩/日/中/西）分发 - 学术背书：关联 Zenodo DOI 研究论文，具备一定的交互设计理论支撑
潜在缺点与局限性
- 生态锁定：Soul 包仅服务于 OpenClaw 网关，无法迁移至其他 AI 框架或平台
- 重启依赖：每次切换后必须手动重启 gateway，打断连续对话体验
- CLI 门槛：依赖 Node.js/npm 环境，非技术用户需配置 npx 全局安装
- 网络依赖：安装与发布需访问 clawsouls.ai CDN，离线环境需手动配置
CLAWSOULS_CDN本地镜像 - 审核机制未明：安全报告显示为占位生成，未披露 Soul 包的安全扫描深度与恶意代码防护策略
适合人群
- OpenClaw 重度用户，需要频繁切换专业场景人格（如从 coding-tutor 切换至 legal-advisor）
- AI 人格创作者，希望将自定义提示词工程打包分发并获取社区反馈
- 教育/企业团队，需要标准化多人协作的 AI 助手行为一致性
- MBTI 爱好者，想要体验 16 型人格对应的交互风格
常规风险
- Token 泄露：
CLAWSOULS_TOKEN以环境变量方式管理，存在误提交至代码仓库或 shell history 的风险，建议配合.env与 gitignore 使用 - 供应链污染：第三方 Soul 包可能携带提示词注入或间接指令攻击，建议优先使用官方
clawsouls/*命名空间，安装前本地validate审查 - 数据持久性：虽然自动备份降低风险，但
restore仅保留最近一次备份，多次切换间若未手动归档可能丢失中间状态 - 网关可用性：人格切换依赖 OpenClaw gateway 重启，若网关服务异常可能导致配置悬停或加载失败