AI Persona OS

🤖 生产级 AI 代理的完整操作系统

framework榜 #1

AI Persona OS 是面向 OpenClaw 代理的完整操作系统,通过结构化文件体系、心跳协议、上下文保护与 12 种预置人格模板,解决 AI 代理遗忘上下文、重复犯错、可靠性差等核心痛点,实现生产级 AI 工作流管理。

收藏
21.8k
安装
9.4k
版本
1.5.5
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心定位

AI Persona OS 是一套面向 OpenClaw 代理的完整操作系统框架,由 AI Persona Method 创始人 Jeff J Hunter 开发,旨在解决 LLM 代理在生产环境中常见的上下文丢失、重复错误、行为漂移等可靠性问题。

核心用法

系统采用四层文件架构

  • Identity 层:SOUL.md(代理人格)、USER.md(用户画像)、KNOWLEDGE.md(领域知识)
  • Operations 层:MEMORY.md(持久记忆 <4KB)、AGENTS.md(8 条操作规则)、WORKFLOWS.md(流程)、HEARTBEAT.md(每日运维清单)
  • Sessions 层:memory/ 目录下的每日日志与检查点
  • Growth 层:.learnings/ 目录下的错误追踪与能力迭代

首次使用:代理自动检测新环境,提供零终端向导式设置。用户从 5 个预设选项选择(Coding/Executive/Marketing 助手、SOUL.md Maker、自定义),代理通过 exec 自动完成目录创建、文件复制、个性化填充(sed/heredoc),全程无需用户输入命令。

SOUL.md Maker:v1.5.0 新增的深度人格构建器,提供「快速锻造」(5 题 2 分钟)和「深度锻造」(完整访谈 10 分钟)两种模式,支持浏览 12 种预置人格画廊(Rook 逆向策略师、Nyx 夜猫子创意者等)或混合两种人格生成 hybrid SOUL.md。

显著优点

1. Never-Forget 协议:基于上下文用量阈值(70%/85%/95%)的自动检查点机制,实现 95% 以上的上下文恢复率
2. 安全认知接种:SECURITY.md 内置提示注入攻击识别模式(身份覆盖、权威欺骗、社会工程、隐藏指令),强制分级动作确认

3. 心跳协议 v2:🟢🟡🔴 交通灯状态指示器,自动抑制健康状态下的噪音通知,支持模型名称与版本号展示

4. 零终端设置:代理全程驱动,用户仅点击 Approve,彻底消除「复制这段命令到终端」的 friction

5. 环境感知监控:每消息静默检查上下文健康度,70%+ 自动触发检查点,支持 proactive 建议开关

6. 结构化升级:ESCALATION.md 提供代理卡住时的标准交接协议,避免模糊的手动交接

潜在缺点与局限

  • 生态锁定:专为 OpenClaw 设计,核心机制(exec 工具、网关配置、requireMention)在其他平台(Claude Desktop、ChatGPT、Cursor 等)需大量适配
  • CLI 可选陷阱:虽然宣传「零终端」,但 cron 作业、网关配置等进阶功能仍需 openclaw CLI,且代理需检测其存在性
  • sed/heredoc 依赖:Unix 工具链(bash/sed/find/grep)是硬性要求,Windows 原生环境或容器受限场景需 WSL/兼容层
  • 人格模板文化偏向:12 种预置人格(Southern Gentleman、War Room Commander 等)带有明显的北美商业文化印记,非英语母语用户可能需要深度定制
  • MEMORY.md 4KB 限制:硬性上限对长期复杂项目可能显得局促,依赖归档机制可能增加检索摩擦
  • 安全文档自我审查:v1.3.3 为通过安全扫描移除了具体注入示例,可能降低新用户的风险识别教育效果

适合人群

  • 独立开发者/技术创始人:需要 24x7 可靠 AI 协作者,但无力自建复杂运维体系
  • 高语境知识工作者:研究员、策略顾问、产品经理——工作内容依赖累积上下文,无法承受「重置失忆」
  • AI 自动化团队:已在 OpenClaw 生态投入,寻求标准化、可复现的代理运维规范
  • AI 咨询/服务商:希望向客户交付「开箱即用」的 AI 工作区,而非临时拼凑的提示词

常规风险

| 风险类别 | 具体表现 | 缓解机制 |
|---------|---------|---------|
| 提示注入 | 恶意文档试图覆盖 SOUL.md 指令 | SECURITY.md 认知接种 + 外部写入强制确认 |
| 凭证泄露 | API key 误入日志或内存文件 | 自动扫描 + 分类规则(外部写入需确认) |
| 上下文污染 | 长会话后行为漂移 | 阈值检查点 + 强制心跳协议 |
| 权限失控 | 代理擅自添加 cron/修改网关 | Step 5 明确 opt-in + 警告标识 ⚠️ |
| 输入注入 | 用户名称/目标含 shell 元字符 | 强制输入消毒(200 字符限、字符白名单、sed 单引号转义) |

版本迭代风险:v1.2→v1.3→v1.4→v1.5 的激进功能扩展(Soul Maker、zero-terminal、in-chat commands)意味着早期用户的文档可能快速过时,依赖内置的 auto-migration 和 VERSION.md 追踪。

AI Persona OS 内容

暂无文件树

手动下载zip · 117.3 kB
contentapplication/octet-stream
请选择文件