Personality Switcher

🎭 多人格 AI 助手 · 一键切换·持久无忧

为 AI 助手创建多人格切换系统,支持自定义人格模板、原子级安全切换与自动备份恢复,会话持久不丢失。

收藏
11.8k
安装
2.9k
版本
0.0.4
CLS 安全性认证2026-07-14
点击查看完整报告 >

使用说明

核心用法

Personality Switcher 是一套面向 OpenClaw 框架的人格管理技能,允许用户创建、保存并在多个人格之间即时切换。核心操作通过 /personality/create-personality 等命令完成,无需手动编辑文件。

人格架构:每个人格由 SOUL.md(核心哲学、语气、行为边界)和 IDENTITY.md(名称、类型、Emoji、标语)组成,存储于 ~/.openclaw/workspace/personalities/USER.mdMEMORY.md 保持全局共享,确保用户偏好不因人格切换而丢失。

持久化机制:通过 _personality_state.json 记录激活状态,配合 HEARTBEAT.md 中的 restore_personality.py 脚本,在每次心跳周期自动恢复当前人格,实现会话重启、对话压缩后的无缝衔接。

原子切换与回滚:切换时执行五步原子操作——备份当前状态 → 持久化变更 → 加载新人格 → 更新状态 → 完整性校验。任一步骤失败即触发回滚,确保数据零损坏。

显著优点

1. 会话级持久化:人格状态跨越会话边界,重启后自动恢复,无需重复配置
2. 零风险切换:原子操作+自动回滚机制,杜绝文件损坏或状态不一致

3. 自动备份管理:每次切换生成时间戳备份,默认保留最近10份,支持按数量/天数清理

4. Telegram 原生集成:命令直接映射为 Telegram Bot 指令,移动端友好

5. 灵活扩展:自然语言描述即可生成人格模板,支持后续手动精调

6. 沙箱隔离:人格文件与共享用户数据物理分离,权限边界清晰

潜在局限与风险

  • 人格数量无硬限制:过度创建可能导致 personalities 目录膨胀,建议定期归档
  • 备份存储占用:高频切换会产生大量备份,虽自动清理仍建议监控磁盘空间
  • 描述生成质量依赖 LLM/create-personality 的模板质量受底层模型能力影响,复杂人格需手动编辑 SOUL.md 精调
  • 无跨设备同步:人格数据仅存于本地 ~/.openclaw/workspace/,多设备场景需手动同步
  • 回滚非无限追溯:仅保障单次切换的原子性,无法回退到任意历史状态(需手动恢复备份)

适合人群

  • 需要同一 AI 助手扮演多角色(创意写作、客服培训、游戏主持)的内容创作者
  • 追求个性化交互体验、希望为不同场景配置专属人格的高级用户
  • 依赖 OpenClaw 框架且对数据持久性和操作安全性有要求的开发者

常规风险提示

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据丢失 | 极端情况下状态文件损坏 | 默认备份机制 + 手动备份恢复脚本 |
| 人格污染 | 切换时共享 USER.md 数据可能被新人格"误读" | USER.md 设计为只读,人格脚本禁止修改 |
| 会话劫持 | 恶意技能篡改 personalities 目录 | 依赖 OpenClaw 基础安全模型,建议 S+ 级环境运行 |
| 备份泄露 | 备份文件包含完整人格配置 | 目录权限应与 workspace 一致,避免全局可读 |

安全等级建议:在受控环境(S+ 或 S)下运行,避免在多人共享的 workspace 中存储敏感人格配置。

安全解读

核心用法

Personality Switcher 是 OpenClaw 平台的角色管理工具,允许用户创建、切换和删除 AI 助手的人格配置。每个人格由 SOUL.md(核心哲学与语言风格)和 IDENTITY.md(身份标识卡)组成,通过 /personality 命令快速切换。

显著优点:

  • 原子级安全切换:五步原子操作(备份→持久化→加载→更新状态→验证),任一步骤失败自动回滚
  • 会话持久化:通过 HEARTBEAT.md 集成和 _personality_state.json 状态文件,人格在会话重启、对话压缩后自动恢复
  • 共享用户上下文:USER.md 独立于人格系统,确保用户偏好跨人格保持一致
  • 完善的备份机制:自动保留10份最近备份,支持手动清理和恢复
  • 纯本地安全运行:仅使用 Python 标准库,无网络请求、无第三方依赖、无敏感信息收集

潜在局限:

  • 人格名称生成依赖简单字符串处理,超长描述可能产生意外名称(后续有验证兜底)
  • HEARTBEAT.md 自动修改行为虽可逆,但涉及配置文件变更
  • 状态文件缺乏完整性校验,手动篡改可能导致状态不一致

适合人群:

  • 需要在工作/创意/娱乐等多场景切换 AI 人格的用户
  • 对角色扮演、创意写作有深度需求的开发者
  • 重视数据安全、偏好本地运行的隐私敏感用户

常规风险:
极低。安全认证评分 91/100(S 级),无危险函数调用,文件操作严格限制在工作区目录。主要风险点为路径遍历(已有防护)和意外文件覆盖(自动备份兜底)。

Personality Switcher 内容

references文件夹
scripts文件夹
手动下载zip · 21.7 kB
personality-template.mdtext/markdown
请选择文件