📦 AI Persona Engine — AI人格引擎

技能名称： ai-persona-engine

版本： 2.0

作者： SPFAdvisors

在5分钟内创建完全实现的AI人格——声音、头像、个性、记忆。

快速开始

# 从ClawHub安装
clawhub install ai-persona-engine
# 创建你的第一个人格
openclaw persona create
# 就这样。向导会处理一切。

命令

persona create

交互式向导，逐步引导人格创建。

openclaw persona create
# 带参数
openclaw persona create --dry-run  # 显示将要生成的内容
openclaw persona create --workspace=~/.openclaw/workspace-new

向导涵盖7个步骤：

• 名称与身份 — 名称、emoji、描述、昵称
• 个性 — 原型选择、混合、沟通风格、关系边界
• 声音 — 提供商选择（ElevenLabs、Grok TTS、内置）、声音测试
• 视觉身份 — 外貌描述、参考图像生成
• 你的上下文 — 包含你的姓名、时区、偏好的USER.md
• 记忆 — 每日笔记、长期 curation、心跳维护
• 平台 — 渠道选择和每个渠道的行为

输出：SOUL.md、USER.md、IDENTITY.md、MEMORY.md、AGENTS.md、HEARTBEAT.md，以及更新的openclaw.json。

persona update

修改特定人格字段，无需重新运行完整向导。包含带自动备份和diff预览的安全更新流程。

# 更新声音提供商
openclaw persona update --voice-provider elevenlabs --voice-id abc123
# 添加或删除个性特征
openclaw persona update --add-trait "sarcastic" --remove-trait "formal"
# 更新外貌并重新生成参考图像
openclaw persona update --appearance "new description..." --regen-image
# 从当前配置重新生成SOUL.md（带备份+diff）
openclaw persona update --regen-soul
# 强制重新生成（跳过diff审查）
openclaw persona update --regen-soul --force
# 交互模式（逐步进行，选择要更改的内容）
openclaw persona update -i

安全更新流程： 在任何--regen操作之前，工具会：

• 创建.persona-backup/包含当前文件
• 重新生成目标文件
• 显示更改的diff
• 请求确认（或使用--force跳过）

persona export

将人格打包成可移植的.persona包。

# 基本导出（无记忆，无API密钥）
openclaw persona export
# 包含记忆文件
openclaw persona export --name pepper-backup --include-memory
# 包含声音配置（仍排除API密钥）
openclaw persona export --include-voice-config
# 从特定工作区导出
openclaw persona export --workspace ~/.openclaw/workspace-ultron

persona import

将.persona包导入工作区。

# 交互式导入（确认每个文件）
openclaw persona import pepper.persona
# 导入到特定工作区
openclaw persona import pepper.persona --workspace ~/.openclaw/workspace-new
# 覆盖现有文件而不提示
openclaw persona import pepper.persona --force

persona preview

生成展示人格如何回复的示例对话。基于模板，无需LLM调用。

# 从配置预览
python3 scripts/persona-preview.py --archetype companion --name "Pepper" --emoji "🌶️"
# 从工作区预览
python3 scripts/persona-preview.py --workspace ~/.openclaw/workspace
# 从配置文件JSON预览
python3 scripts/persona-preview.py --input persona-config.json

显示4个场景：问候、请求帮助、用户错误、情感时刻。

persona migrate

从现有工作区文件反向工程人格配置。

# 将工作区迁移到配置JSON
python3 scripts/persona-migrate.py --workspace ~/.openclaw/workspace
# 输出到文件
python3 scripts/persona-migrate.py --workspace ~/.openclaw/workspace --output persona-config.json

详细迁移说明请参阅references/migration-guide.md。

persona validate

检查工作区中缺失或格式错误的人格文件。

python3 scripts/persona-validate.py --workspace ~/.openclaw/workspace
# 带配置验证
python3 scripts/persona-validate.py --workspace ~/.openclaw/workspace --config ~/.openclaw/openclaw.json
# 用于脚本化的JSON输出
python3 scripts/persona-validate.py --workspace ~/.openclaw/workspace --json

persona diff

将当前工作区文件与生成器将产生的内容进行比较。

python3 scripts/persona-diff.py --workspace ~/.openclaw/workspace --config ~/.openclaw/openclaw.json

persona list

列出所有工作区中的人格。

python3 scripts/persona-list.py
# JSON输出
python3 scripts/persona-list.py --json

persona fleet

显示所有机器上所有智能体的舰队视图。

python3 scripts/persona-fleet.py
# JSON输出
python3 scripts/persona-fleet.py --json

voice audition

为提供商试听多个声音。

# 列出ElevenLabs声音
python3 scripts/voice-setup.py --audition --provider elevenlabs
# 按性别筛选
python3 scripts/voice-setup.py --audition --provider elevenlabs --gender female
# 列出内置声音
python3 scripts/voice-setup.py --audition --provider builtin

个性混合

通过加权百分比混合多个原型来创建混合人格。

# 在向导期间：选择"与第二个原型混合"选项
openclaw persona create
# 程序化方式：
cat > blend-profile.json << 'EOF'
{
  "name": "Muse",
  "emoji": "🎨",
  "archetypes": [
    {"name": "companion", "weight": 0.7},
    {"name": "creative", "weight": 0.3}
  ]
}
EOF
python3 scripts/generate-soul.py --input blend-profile.json --output SOUL.md

混合合并：

• 特征：从两个配置合并，按存在加权
• 简洁度：加权平均值（例如0.7×3 + 0.3×4 = 3.3 → 3）
• 情感深度：加权平均值映射到级别
• 氛围摘要：从两个配置连接
• 平台笔记：合并，去重

社区模板

assets/community-templates/中针对常见用例的预建人格配置：

python3 scripts/generate-soul.py --archetype therapist --name "Sage" --emoji "🧘"

文件结构

ai-persona-engine/
├── SKILL.md # 本文件
├── DESIGN.md # 完整设计文档
├── scripts/
│   ├── persona-create.sh # 设置向导（v2: 混合, --dry-run, --workspace）
│   ├── persona-update.sh # 字段更新器（v2: 安全更新流程）
│   ├── persona-export.sh # 包导出器（v2: 跨工作区）
│   ├── persona-import.sh # 包导入器（v2: 跨工作区）
│   ├── persona-preview.py # [新] 示例对话生成器
│   ├── persona-migrate.py # [新] 从工作区反向工程配置
│   ├── persona-validate.py # [新] 工作区验证
│   ├── persona-diff.py # [新] 工作区与生成内容的diff
│   ├── persona-list.py # [新] 列出所有工作区的人格
│   ├── persona-fleet.py # [新] 所有智能体的舰队视图
│   ├── generate-soul.py # SOUL.md生成器（v2: 混合支持）
│   ├── generate-user.py # USER.md生成器
│   ├── generate-identity.py # IDENTITY.md生成器
│   ├── generate-memory.py # MEMORY.md + memory/ 脚手架
│   ├── voice-setup.py # 声音提供商配置（v2: --audition）
│   ├── image-setup.py # 图像提供商配置 + 参考图像
│   └── lib/
│       ├── providers.py # 提供商抽象层
│       ├── templates.py # 模板引擎 + 个性混合
│       ├── config.py # openclaw.json帮助器
│       └── prompts.py # 向导提示定义
├── references/
│   ├── voice-providers.md # 声音提供商设置指南
│   ├── image-providers.md # 图像提供商设置指南
│   ├── personality-archetypes.md # 原型参考
│   ├── soul-writing-guide.md # SOUL.md写作技巧
│   ├── config-schema.md # openclaw.json模式参考
│   └── migration-guide.md # [新] 现有用户迁移指南
├── assets/
│   ├── personality-profiles/ # 每个原型的JSON预设（5个内置）
│   ├── community-templates/ # [新] 8个社区人格配置
│   └── templates # 生成文件的Handlebars模板
└── tests/
    ├── test-generators.py # 77个单元测试（v2: 混合、迁移等）
    ├── test-wizard.sh
    └── test-export-import.sh

配置

人格引擎向openclaw.json添加一个persona部分。关键字段：

依赖

必需：

• OpenClaw（任何支持技能的版本）
• Python 3.9+
• Node.js 22+

可选（基于选择的提供商）：

• ElevenLabs API密钥（声音）
• Gemini API密钥（图像生成）
• xAI API密钥（Grok TTS / Grok Imagine）
• ffmpeg（WhatsApp语音消息的音频格式转换）

进一步阅读

• 声音提供商指南
• 图像提供商指南
• 人格原型
• SOUL.md写作指南
• 配置模式参考
• 迁移指南
• 设计文档