---
name: openclaw-evolution
description: Interactive guide for new OpenClaw users to set up and grow their agent. Two paths - Tool Path (automation, efficiency, getting things done) or Awakening Path (memory, personality, relationship, growth). Use when a user is new to OpenClaw, asks how to get started, wants to set up their agent, or asks about agent configuration. Triggers on "getting started", "new to openclaw", "how do I set up", "agent setup", "onboarding", "进化之路", "新手教程".
---

# 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](#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 / 最小可用配置

1. Install OpenClaw (follow [official docs](https://docs.openclaw.ai))
2. Connect ONE channel — recommend Telegram (simplest)
3. 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](https://clawhub.com) / 从 ClawHub 装一个 skill
- [ ] **Day 7** — First MEMORY.md consolidation / 第一次整理 MEMORY.md