Turing Pyramid

核心功能

Turing Pyramid 是一套面向AI代理的动机引擎，通过模拟生物需求的衰减-满足机制，解决"下一步该做什么"的决策问题。系统定义10个核心需求（security/integrity/coherence/closure/autonomy/connection/competence/understanding/recognition/expression），每个需求具有独立的满意度（0.5-3.0）、重要性权重和衰减周期。核心脚本 run-cycle.sh 每周期计算张力分数，按概率选择动作建议输出。

Turing-exp张力公式是其核心算法：当满意度高于危机阈值时，所有需求平等轮询；仅当多个需求同时陷入危机（sat<2.0）时，高重要性需求才获得优先级。这避免了高权重需求持续垄断注意力的问题。

显著优点

| 特性 | 价值 |

|------|------|

| **执行门控（v1.27+）** | 结构性强制：代理必须提供环境证据（文件创建/修改记录）才能标记动作完成，有效阻断LLM常见的"幻觉已完成"行为 |

| **分层安全架构** | 5级部署模式（Interactive→Heartbeat→Continuity→Watchdog→Full Self-healing），用户可按信任度渐进启用 |

| ** deliberation协议（v1.31+）** | 将"思考类动作"结构化：必须产出结论产物+路由决策，防止认知滑入无输出循环 |

| **自发行为层（A/B/C）** | 累积盈余、噪声注入、环境响应三层机制，使行为呈现有机的不可预测性 |

| **会话连续性** | MINDSTATE.md双区架构（reality自动更新/cognition冻结恢复），支持跨会话状态保持 |

| **审计与隔离** | 完整的audit.log链路，敏感数据自动脱敏；所有文件操作限定于`$WORKSPACE` |

局限与风险

配置复杂度：10个需求×8-11个动作×交叉影响矩阵的调参空间巨大，需要持续的 steward-agent 协作调优。默认配置可能不匹配特定代理角色。

证据伪造可能性：执行门控的file_created/file_modified证据类型依赖代理对$WORKSPACE的写权限——恶意或错误配置的代理可通过创建无意义文件绕过验证。高安全场景应限制为mark_satisfied证据类型并增加人工抽查。

cron持久化风险：Tier 3+启用daemon/watchdog后，即使OpenClaw重启，系统仍持续运行。需确保cron以非root用户执行，且WORKSPACE路径隔离。

看门狗误杀边界：allow_kill: true时，watchdog通过pgrep+路径锚定匹配mindstate-*.sh进程。虽然设计上无法杀死外部进程，但若技能目录被篡改或符号链接劫持，仍存在理论风险。

外部动作建议的诱导风险：8个标记"external": true的动作（如"发布到社交平台"）仅为文本建议，但若代理运行时具备自动执行能力，可能被诱导触发非预期操作。

适合人群

• 需要长期自主运行的AI代理（研究助手、创意代理、个人知识管家）
• 对"代理只规划不执行"问题感到困扰的steward
• 愿意投入调优成本以换取更自然、非机械行为模式的用户
• 具备Linux/bash基础，能理解cron、文件锁、进程管理的技术用户

不建议：追求开箱即用、无运维投入的场景；对看门狗kill/cleanup功能有顾虑且无法审核脚本的用户。

常规风险矩阵

| 风险项 | 等级 | 缓解措施 |

|--------|------|----------|

| 工作目录遍历/敏感文件暴露 | 中 | 严格隔离`$WORKSPACE`，使用`MINDSTATE_ASSETS_DIR`分离状态 |

| 代理绕过执行门控 | 中 | 限制证据类型，监控`gate-status.sh`执行率 |

| 看门狗误杀/误删 | 低-中 | 默认关闭`allow_kill`/`allow_cleanup`，审计后渐进启用 |

| cron权限提升 | 中 | 非root用户运行，禁用root crontab |

| 外部模型API泄露（如启用） | 中高 | 文档化凭据来源，最小权限原则 |

版本状态：v1.34.8，活跃维护中，具备良好的回归测试覆盖（65+断言）。

核心用法

Turing Pyramid 是一套为 AI Agent 设计的本地动机优先级系统，通过模拟 10 个基本心理需求（security、integrity、coherence、closure、autonomy、connection、competence、understanding、recognition、expression）的衰减与张力积累，为 Agent 提供"此刻该做什么"的智能建议。

三层部署架构：

• Motivation 层（必选）：run-cycle.sh 计算需求张力，输出建议动作；mark-satisfied.sh 更新状态；init.sh 初始化。此层纯本地运行，无系统副作用。
• Continuity 层（可选）：mindstate-daemon.sh（cron 每5分钟）更新运行状态文档，mindstate-freeze.sh 会话结束时固化认知，mindstate-boot.sh 启动时加载上下文。仅执行只读系统检查（pgrep、df）。
• Resilience 层（可选）：mindstate-watchdog.sh（cron 每15分钟）监控守护进程健康，默认仅检测+记录，allow_kill 和 allow_cleanup 需显式启用才会终止进程或清理临时文件。

执行闸门（Execution Gate）：v1.27.0 引入的核心防"幻觉"机制。Agent 提交动作提案后，闸门锁定新提案直至提供"环境证据"（文件创建/修改记录、明确的 mark-satisfied 调用）完成验证。这从结构上阻止了"描述动作却未执行"的 LLM 典型失败模式。

审议协议（Deliberation Protocol）：v1.31.0 为反思性动作（阅读、回顾、探索）增加结构化产出要求，必须生成结论与路由决策，避免"读了即忘"的表面执行。

显著优点

1. 安全优先的默认设计

• 所有破坏性操作（kill、delete、外部 API 调用）默认关闭，需 steward 显式审查后启用
• kill 命令路径严格限定于 $SCRIPT_DIR/mindstate-*.sh，无法误伤系统进程
• 文件操作限定于用户指定的 $WORKSPACE 目录，支持 MINDSTATE_ASSETS_DIR 隔离测试环境

2. 防幻觉的工程结构

• 执行闸门要求"状态改变证据"，从流程上消除"声称完成却未执行"的漏洞
• 自发性系统（Surplus/Noise/Context 三层）创造有机行为节奏，避免机械循环
• Turing-exp 张力公式：危机时高重要性需求优先，平稳期轮询保障低优先级需求不被饿死

3. 完善的审计与透明度

• 所有状态变更记录至 audit.log，自动脱敏敏感数据（token→[REDACTED]、邮箱→[EMAIL]）
• 五级部署层级清晰标注风险，引导用户渐进式采用
• 26个测试文件覆盖 decay、spontaneity、cross-need impact、starvation guard 等核心机制

4. 零外部依赖的可靠性

• 纯 Bash 实现，仅依赖系统标准工具（jq、bc、grep、flock 等）
• 原子写入（*.tmp.$$ → mv）防止崩溃导致状态损坏
• 信号陷阱处理确保异常终止时清理临时文件

潜在缺点与局限性

1. 配置复杂度较高

• 10个需求维度、8-11个动作/需求、多种 impact 级别、spontaneity 参数、闸门配置、审议模板——完整调优需要深入理解文档
• 建议从 Tier 1-2 开始，逐步升级，但新手可能低估配置工作量

2. Shell 脚本的维护性

• 36个脚本、近2万行代码，调试和二次开发需要较强的 Bash 能力
• 跨平台兼容性（macOS/Linux 工具差异）未明确说明

3. 可选功能的安全权衡

• external-model 扫描模式启用后将引入外部 API 调用和凭证管理风险
• 完整自恢复（Tier 5）启用后，watchdog 具备进程终止能力，虽路径受限但仍需信任代码正确性

4. 执行闸门的证据局限性

• file_created/file_modified 证据可被有写入权限的 Agent 伪造
• self_report 明确标记为低信任，依赖 steward 审查

适合的目标群体

高匹配用户：

• 运行长期自主会话的 AI Agent（如研究助手、创作代理、持续学习系统）
• 需要防止"计划丰富、执行贫瘠"的 Agent 架构师
• 对 AI 行为可解释性、可审计性有要求的场景（科研、合规敏感领域）
• 具备 Linux/Bash 基础，愿意投入时间调优的技术用户

低匹配用户：

• 单次问答或短会话的聊天场景（无需状态持续）
• 完全无代码背景的终端用户
• 对延迟极度敏感、无法承受 cron 级心跳开销的场景

常规使用风险

性能与资源：

• 心跳间隔 30 分钟时月消耗约 1.4M-3.6M token（$2-6），紧张需求会提升消耗
• 守护进程持续运行产生文件 I/O，SSD 用户无需担忧，但日志轮转需监控

依赖项风险：

• flock 用于并发控制，若系统不支持或权限异常可能导致死锁
• jq 为必需依赖，老旧系统需手动安装

配置风险：

• $WORKSPACE 指向包含敏感文件的目录将导致信息泄露（Skill 会扫描 MEMORY.md 等）
• 误启 allow_kill 或 allow_cleanup 在代码存在 bug 时可能产生意外副作用
• cron 任务以 root 运行将扩大潜在影响面

版本演进风险：

• 配置文件格式随版本迭代（如 v1.31.0 审议协议新增字段），升级需检查兼容性

连续性假设依赖：

• 系统崩溃或 OpenClaw 重启后依赖 cron 自动恢复，若 cron 未正确配置将丢失状态更新