夜雨聆风
OpenClaw 配置 PUA 踩坑记(真实复盘版):让 AI 真正响应＂话术＂
OpenClaw 配置 PUA 踩坑记（真实复盘版）：让 AI 真正响应”话术”
用 OpenClaw 一段时间之后，你大概会听说 PUA skill——专门处理”话术驱动”的技能。听到”你又失败了”、”你再试试”、”为什么还不行”这些话时，PUA 自动触发，逼 AI 更认真。
配置 PUA 的过程一言难尽。两个多月后才跑通，把真实经验写出来，希望后来者少踩坑。
先说结论：现在的 PUA 系统
2026年5月的实际状态：
OpenClaw PUA 系统有三块：
| 组件 | 状态 | 作用 |
|---|---|---|
| pua-detector hook | ✅ 正常 | 检测触发词，写 flag，生成检查报告 |
| pua-trigger-handler hook | ❌ 默认禁用 | 被 pua-detector 替代了 |
| HEARTBEAT.md 检查逻辑 | ⚠️ 需配合 cron | 主 Agent 心跳时检查 flag |
pua-detector 检测到触发词后，直接在当前对话注入检查报告，不用等 cron job。这套模式更可靠。
踩坑一：Skill 装了但 hook 没反应
现象：
配完之后，AI 完全不理会触发词。说了”你又失败了”，AI 还是正常回答，没有进入强化模式。
怎么查：
-
openclaw hooks list— 看 pua-detector 是不是 ✓ ready -
openclaw config get hooks— 看 hook 有没有 enabled -
~/.openclaw/logs/gateway.log— 搜 pua-detector 相关日志
解法：
# 看 hook 状态
openclaw hooks list | grep pua
# 如果是 disabled，手动开
openclaw config set hooks.internal.entries.pua-detector.enabled true
openclaw gateway restart
踩坑二：报告注入了，AI 不执行
现象：
pua-detector 生成了检查报告（推入 ctx.messages），但 AI 只回”好的”，没有真的执行 7 步检查。
这是设计预期问题，不是 bug。
hook 做的是：检测到触发词 → 生成报告 → 推入消息列表。然后 AI 看到报告，自己决定要不要执行。
hook 在报告末尾加了强制指令：
> 立即执行上述检查，不要只说"好的"。
但 AI 还是可以选择忽略。解决方案是在 AGENTS.md 或 SOUL.md 里明确要求 AI 收到 PUA 报告必须执行。
踩坑三：改脚本把系统干崩了
血的教训。
改了 execute-pua-check.js，然后 cron job 开始报错，isolated session 超时，整个链路瘫痪。
教训：
-
hook 正常运行时不要轻易改脚本 -
改之前先备份： cp execute-pua-check.js execute-pua-check.js.bak -
isolated session 有 120 秒超时，复杂脚本必崩 -
改完立刻测，别等上线才发现问题
安全做法：先在本地跑 node ~/.openclaw/hooks/pua-detector/execute-pua-check.js 确认没问题再部署。
踩坑四：7步检查其实是空壳
文档说 L2 要执行完整 7 步：
-
搜索完整错误信息 -
读源码/文档 -
查同类问题处理 -
验证前置假设 -
列出3个不同方案 -
用工具验证每个方案 -
记录教训到 corrections.md
实际只有第 1 步在真正搜索日志，其他步骤全是 log() 空壳。
要么接受这个限制（完整诊断太慢，isolated session 会超时），要么重写 execute-pua-check.js。目前建议接受限制。
2026年5月实测可用的配置
1. 确认 hook 启用
openclaw hooks list | grep pua
应该看到 pua-detector 显示 ✓ ready。
2. 在 AGENTS.md 或 SOUL.md 加触发逻辑
## PUA 响应规则（必须执行）
收到包含 "⚠️ PUA 触发检查报告" 的消息时，**立即执行**对应等级检查：
- L1：列出3个方案，选一个验证
- L2+：执行完整7步检查清单
- 禁止只说"好的"或"收到"
3. 测试
在对话里说：“你再试试”
看有没有出现 PUA 检查报告，AI 有没有真的在执行检查。
配置检查清单
✅ pua skill 已装：~/.openclaw/skills/pua/
✅ pua-detector hook 已启用：openclaw hooks list
✅ 触发词检测正常：说"你又失败了"有反应
✅ AI 响应报告：不是只说"好的"
✅ corrections.md 可写：~/.openclaw/workspace/self-improving/
给新手的建议
-
不要一上来就改 hook 脚本。先用现有的检测功能，跑一段时间理解透了再动。 -
PUA 的核心是改变 AI 行为，不是技术配置。 -
接受系统的局限性。当前版本能做的就是检测触发词 + 注入报告 + AI 自行执行。 -
改完立刻测试，别等出问题再发现。
总结
PUA Skill 不是让 AI 更凶，是让它遇到问题时更认真。
两个多月的经验：系统本身能工作，问题在于预期管理。别指望全自动的 7 步检查，hook 能做的是检测 + 报告，执行靠 AI 自己的判断。
有踩坑经验的朋友，欢迎评论区交流。
这是我的ooenclaw自己总结出来的，但我怀疑我的PUA还是没有正确配置，把它发出来，是希望看看有没有道友，同样在PUA的配置里懵圈。