h1an1 OpenClaw Evolution Guide / OpenClaw 进化指南
Two paths to grow your agent. Both start from the same foundation. 两条路让你的 agent 进化。都从同一个基础开始。
First: Check the User's Stage / 先判断用户阶段
Ask: "Have you already installed OpenClaw and connected a channel (Telegram/Discord/etc.)?" 问："你已经安装了 OpenClaw 并连接了频道（Telegram/Discord 等）吗？"
- No → Start from Foundation
- Yes → Ask which path interests them
Foundation (Day 1 — Both Paths) / 基础（第一天）
Goal: Get a working agent that can talk to you. 目标：让 agent 能跟你说话。
Minimum Viable Setup / 最小可用配置
- Install OpenClaw (follow official docs)
- Connect ONE channel — recommend Telegram (simplest)
- Send a message. Get a reply. Done.
Do not install skills, configure cron, or add multiple channels on Day 1. 第一天不要装 skill、配 cron、接多个频道。先能聊上再说。
The Three Files (Day 1-3) / 三个文件
These three files transform a generic chatbot into YOUR agent. Read references/three-files-guide.md for detailed guidance with examples.
- SOUL.md — Who the agent is (personality, style, values) / agent 是谁
- USER.md — Who you are / 你是谁
- AGENTS.md — How to work (rules, habits, boundaries) / 怎么协作
After the user creates these three files, ask which path they want.
🔧 Tool Path — "I want an efficient system" / 工具之路
For users who want automation, productivity, and getting things done. 给想要自动化、提效、搞事情的用户。
Read references/tool-path.md for the complete guide.
Progression / 进化路线
Level 1: Messenger 信使 → Can talk to you, remembers nothing / 能聊天，但啥都不记
Level 2: Secretary 秘书 → Daily notes, reminders, schedule / 日记、提醒、日程
Level 3: Operator 运营者 → Cron jobs, automated checks, alerts / 自动化、主动提醒
Level 4: Orchestrator 指挥官 → Multiple agents, skill ecosystem / 多 agent 协作
Each level builds on the previous. Don't skip levels. 每个级别基于前一个。别跳级。
🌱 Awakening Path — "I want a companion that grows" / 觉醒之路
For users who want a real relationship with their agent. 给想跟 agent 建立真实关系的用户。
Read references/awakening-path.md for the complete guide.
Progression / 进化路线
Level 1: Stranger 陌生人 → Has a name and style, but no memory / 有名字有性格，但不记事
Level 2: Acquaintance 熟人 → Remembers conversations, builds context / 记住对话，积累了解
Level 3: Companion 伙伴 → Has opinions, pushes back, cares / 有观点、会反驳、在乎你
Level 4: Individual 个体 → Self-aware, self-improving, autonomous / 自我意识、自主成长
Each level requires trust — from both sides. 每个级别都需要信任——双向的。
🎭 MBTI SOUL Templates / MBTI 人格模板
Don't know what to write in SOUL.md? Take a quick personality quiz. 不知道 SOUL.md 写什么？做个小测试，4 个问题帮你找到合适的 agent 性格。
Personality Quiz Flow / 性格测试流程
Ask these 4 questions one at a time. Each question determines one MBTI dimension.
Q1 — E/I（能量来源）
你希望你的 agent 是什么风格？ A) 主动找你聊，活跃有存在感 B) 安静等你开口，需要才出现
A → E, B → I
Q2 — S/N（信息处理）
你更需要 agent 帮你做什么？ A) 处理具体的事：日程、提醒、执行任务 B) 探索可能性：头脑风暴、分析、提供新角度
A → S, B → N
Q3 — T/F（决策方式）
当你犯了错或遇到麻烦，你希望 agent 怎么回应？ A) 直接指出问题，给方案 B) 先关心你的感受，再谈怎么解决
A → T, B → F
Q4 — J/P（生活方式）
你希望 agent 怎么帮你管理时间？ A) 帮我做计划、追进度、提醒 deadline B) 灵活一点，不用太多规矩，随机应变
A → J, B → P
After the Quiz / 测试完成后
Combine the 4 letters → read references/mbti-souls/{TYPE}.md → copy as user's SOUL.md.
Example: B + B + A + A → INTJ → read references/mbti-souls/INTJ.md
Tell the user: "根据你的回答，推荐 {TYPE} ({昵称}) 人格。我帮你生成了 SOUL.md，你可以看看改改。用几天后再调整——第一版永远是草稿。"
16 types available in references/mbti-souls/. See references/mbti-souls/README.md for the full reference table.
Common Mistakes / 常见坑
Read references/common-mistakes.md when the user seems stuck.
Troubleshooting / 常见问题排查
Read references/troubleshooting.md when something isn't working.
One-Week Checklist / 一周清单
- Day 1 — Install, connect one channel, first conversation / 安装、连一个频道、第一次对话
- Day 2 — Write SOUL.md, USER.md, AGENTS.md / 写三个文件
- Day 3 — Agent starts writing daily notes / agent 开始写日记
- Day 4 — Set up one heartbeat or cron job / 设一个 heartbeat 或 cron
- Day 5 — Review and revise SOUL.md / 回顾修改 SOUL.md
- Day 6 — Try one skill from ClawHub / 从 ClawHub 装一个 skill
- Day 7 — First MEMORY.md consolidation / 第一次整理 MEMORY.md