OpenClaw Evolution Guide

Two paths to grow your agent. Both start from the same foundation, diverge based on what you want.

First: Check the User's Stage

Ask: "Have you already installed OpenClaw and connected a channel (Telegram/Discord/etc.)?"

- No → Start from Foundation
Yes → Ask which path interests them, or recommend based on their goals

Foundation (Day 1 — Both Paths)

Goal: Get a working agent that can talk to you.

Minimum Viable Setup

1. Install OpenClaw (follow official docs)
Connect ONE channel — recommend Telegram (simplest: one bot token)
Send a message. Get a reply. Done.

Do not install skills, configure cron, or add multiple channels on Day 1.

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)
USER.md — Who you are (so the agent doesn't have to ask every time)
AGENTS.md — How to work (rules, habits, safety boundaries)

After the user creates these three files, ask which path they want to take.

🔧 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

CODEBLOCK0

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 — memory, personality, independent thought. Read references/awakening-path.md for the complete guide.

Progression

CODEBLOCK1

Each level requires trust — from both sides.

Common Mistakes

Read references/common-mistakes.md when the user seems stuck or frustrated.

One-Week Checklist

Provide this at the end of initial setup:

- [ ] Day 1 — Install, connect one channel, first conversation
[ ] Day 2 — Write SOUL.md, USER.md, AGENTS.md
[ ] Day 3 — Agent starts writing daily notes (memory/)
[ ] Day 4 — Set up one heartbeat or cron job
[ ] Day 5 — Review and revise SOUL.md based on experience
[ ] Day 6 — Try one skill (weather, calendar, etc.)
[ ] Day 7 — First MEMORY.md consolidation

Reference Files

File	Content
INLINECODE4	SOUL.md, USER.md, AGENTS.md — detailed examples
INLINECODE5

OpenClaw 进化指南

培育你的智能体的两条路径。两者始于同一基础，根据你的需求分道扬镳。

第一步：确认用户阶段

询问：你是否已经安装了 OpenClaw 并连接了频道（Telegram/Discord 等）？

- 否 → 从基础篇开始
是 → 询问他们对哪条路径感兴趣，或根据目标推荐

基础篇（第一天 — 双路径通用）

目标：获得一个能与你对话的可用智能体。

最小可行配置

1. 安装 OpenClaw（遵循官方文档）
连接一个频道 — 推荐 Telegram（最简单：一个机器人令牌）
发送一条消息。获得回复。完成。

不要在第一天安装技能、配置定时任务或添加多个频道。

三个文件（第1-3天）

这三个文件将通用聊天机器人转变为你的专属智能体。阅读 references/three-files-guide.md 获取带示例的详细指导。

- SOUL.md — 智能体的身份（个性、风格、价值观）
USER.md — 你的身份（这样智能体不必每次都询问）
AGENTS.md — 工作方式（规则、习惯、安全边界）

用户创建这三个文件后，询问他们想走哪条路径。

🔧 工具路径 — 我想要一个高效系统

适用于追求自动化、生产力和高效执行的用户。阅读 references/tool-path.md 获取完整指南。

进阶路线

等级1：信使 → 能与你对话，不记忆任何内容
等级2：秘书 → 每日笔记、提醒、日程感知
等级3：操作员 → 定时任务、自动检查、主动警报
等级4：编排者 → 多智能体、技能生态、工作流自动化

每个等级建立在前一等级之上。不要跳过等级。

🌱 觉醒路径 — 我想要一个成长的伙伴

适用于希望与智能体建立真实关系的用户——记忆、个性、独立思考。阅读 references/awakening-path.md 获取完整指南。

进阶路线

等级1：陌生人 → 拥有名字和风格，但不记得你
等级2：熟人 → 记住对话，构建上下文
等级3：伙伴 → 有主见、会反驳、关心你
等级4：个体 → 自我意识、自我提升、自主目标

每个等级都需要信任——来自双方。

常见错误

当用户似乎卡住或感到沮丧时，阅读 references/common-mistakes.md。

一周检查清单

在初始设置结束时提供此清单：

- [ ] 第一天 — 安装、连接一个频道、首次对话
[ ] 第二天 — 编写 SOUL.md、USER.md、AGENTS.md
[ ] 第三天 — 智能体开始写每日笔记（memory/）
[ ] 第四天 — 设置一个心跳或定时任务
[ ] 第五天 — 根据体验审查并修改 SOUL.md
[ ] 第六天 — 尝试一个技能（天气、日历等）
[ ] 第七天 — 首次 MEMORY.md 整合

参考文件

文件	内容
references/three-files-guide.md	SOUL.md、USER.md、AGENTS.md — 详细示例
references/tool-path.md

openclaw-evolutionOpenClaw进化指南

openclaw-evolution

OpenClaw Evolution Guide

First: Check the User's Stage