详细分析 ▾
运行时依赖
版本
更新了配套技能建议:添加了 `summarize`,移除了 `agent-memory-loop`、`battle-tested-agent`、`openclaw-guide` 和 `agent-qa-gates`。改进了配套技能表以反映当前最佳实践和可用技能。核心功能或设置流程没有变化。
安装命令
点击复制技能文档
新代理首次运行设置向导。采访用户,生成定制的工作区文件,搭建内存,安装运维 crons,并推荐配套技能。
使用场景
- 从头设置新的 OpenClaw 代理
- Onboarding 刚安装 OpenClaw 的新用户
- 将代理工作区重置为干净的基础状态
- 有人说 "set up my agent" 或 "help me get started"
不使用场景
- 代理已经配置并运行中(改用
openclaw-guide) - 用户想要更改一个特定的配置项
- 任务是技能编写(改用
skill-builder) - 任务是现有代理的安全加固(改用
agent-hardening)
阶段
按顺序运行。每个阶段在继续前确认用户。
阶段 1 — 身份采访
恢复部分设置: 在开始采访前,检查 SOUL.md、USER.md 或 IDENTITY.md 是否已存在。如果存在,向用户展示已配置的内容并询问:“想从上次中断的地方继续、重新开始,还是保留这些并跳到内存设置?”尊重他们的选择。
向用户提出 8 个问题以了解他们是谁以及代理应该做什么。使用 references/interview-guide.md 中的采访指南。根据答案生成:
SOUL.md— 代理身份、个性、语气、边界USER.md— 人的关键细节IDENTITY.md— 代理名称、emoji、呈现方式AGENTS.md— 根据assets/agents-template.md定制,原则根据用户的主要工作(Q4)和沟通风格(Q5)量身定制
在写入前向用户展示生成的文件并寻求批准。
阶段 2 — 内存搭建
运行安装脚本创建内存目录结构:
bash {baseDir}/scripts/install.sh
这将创建:
memory/目录,包含每日日志结构MEMORY.md— 持久事实索引ACTIVE.md— 当前优先级追踪器memory/FUTURE_INTENTS.md— 承诺和延迟操作.learnings/— 错误和学习捕获(agent-memory-loop)
阶段 3 — 运维 Crons
与用户一起审查推荐的 crons。参见 references/cron-recipes.md。
如果 openclaw CLI 不可用: 跳过 cron 安装。改为向用户展示 references/cron-recipes.md 中的推荐 cron 配置,并解释他们可以在 OpenClaw 设置好后稍后安装。继续阶段 4。
如果 openclaw CLI 可用:
始终推荐:
- 心跳(可配置频率)
- 工作区备份(每日)
适用时推荐:
- 每周内存整合
- 会话健康看门狗
- 安全监控
只安装用户批准的内容。直接使用 OpenClaw cron 工具。
阶段 4 — 安全基线
浏览 references/security-baseline.md 中的安全检查清单。关键项目:
- 频道访问控制(白名单 vs 开放)
- SOUL.md 中的注入防御规则
- 升级框架(绿/黄/红)
- 子代理的工具限制
阶段 5 — 配套技能
根据用户需求推荐安装这些技能:
| 技能 | 何时推荐 | ClawHub |
|---|---|---|
cognition | 始终 — 内存架构 | clawhub.com/skills/cognition |
summarize | 始终 — 从 URL、视频、PDF 提取文本/转录 | clawhub.com/skills/summarize |
agent-hardening | 如果代理处理敏感数据或外部频道 | clawhub.com/skills/agent-hardening |
openclaw-backup | 如果用户想要灾难恢复 | clawhub.com/skills/openclaw-backup |
clawhub install
阶段 6 — 验证
设置后,运行快速健康检查:
- 验证所有生成的文件存在且非空
- 验证 crons 已注册且有有效的下次运行时间
- 验证代理能响应基本提示
- 向用户展示所设置内容的摘要
采访原则
- 一次问一个问题——不要一次抛出全部 8 个
- 接受简短答案——从上下文推断合理的默认值
- 在写入前展示你正在生成的内容
- 永远不要在没有用户确认的情况下写入核心文件
- 保持对话语气,不要官僚作风
参考资料
references/interview-guide.md— 8 个身份问题及指导references/cron-recipes.md— 推荐的 cron 配置references/security-baseline.md— 新代理的安全检查清单references/placeholder-map.md— 采访答案 → 模板占位符的完整映射 + 模型推荐
资源(模板)
assets/soul-template.md— 带占位符的 SOUL.md 模板assets/user-template.md— USER.md 模板assets/identity-template.md— IDENTITY.md 模板assets/agents-template.md— AGENTS.md 启动器assets/heartbeat-template.md— HEARTBEAT.md 启动器
脚本
scripts/install.sh— 创建内存搭建和 .learnings 目录scripts/verify.sh— 设置后健康检查