Node、npm、provider 都备好的话，`setup` 到 `configure` 大约 15-20 分钟。第一版 AGENTS.md、记忆文件、第一批 skills 通常要半天，可以边用边调。

OpenClaw 入门教程（2026）｜从零开始搭你的 AI 工作站

Q: AGENTS.md 要写多长？

新 agent 打开 30 秒内读完，并知道下一步该去哪看的长度。超过就拆。

Q: MEMORY.md 跟 brain.md 到底差在哪？

MEMORY.md 是地图（哪些记忆在哪），brain.md 是今天桌上的便利贴（现在进行式）。前者很少改，后者每天动。

Q: skill 没载入怎么办？

九成问题是文件名写成 `skill.md`，改成大写 `SKILL.md` 就好。再不行才查路径和 workspace。

Q: cron/jobs.json 找不到怎么办？

正常，setup 不建。跑过 `openclaw cron add` 才会有 job 定义。

Q: 设置写错了会搞坏 OpenClaw 吗？

不会。多半是 Markdown 错乱或 JSON 格式错，agent 行为怪一下而已。用 `git diff` 看一下，回到上一版就好。

Q: Windows 可以用吗？

走 WSL2。原生 Windows 路径、shell、daemon 会多踩很多小坑，不值得。

第一次装 OpenClaw 卡住的点，几乎都不是下载包，而是搞不清楚哪些文件是 OpenClaw 真的会读、哪些只是自己后来加的工作笔记。

把 2026-05 实际跑过一轮的顺序整理在下面。先讲最重要的一句：旧笔记写 npx openclaw init 的话先别照抄，命令已经换了。 2026.4.26 跟 2026.5.x 两条线的入门入口都是 setup 和 configure，不是 init。

下面这篇先不碰花俏架构，目标很简单：把 OpenClaw 跑起来、知道每个配置文件该放什么、做一个最小 skill，再决定要不要加记忆跟排程。

前置需求

四件事先确认。

Node.js 22 以上。建议直接 Node 24 LTS。打开终端跑：

node -v
npm -v

Node 还停在 18 的话先升级。OpenClaw 2026 线的工具链跟 Node 18 时代已经不一样了。

一个能用的模型 provider。后续 configure / onboard 流程会处理 credentials、gateway、模型选择。第一次不用把所有 provider 都研究完，至少准备一个你确定能用的。

干净的测试文件夹。刚开始别拿重要项目开刀，新建一个比较好 debug：

mkdir -p ~/openclaw-playground
cd ~/openclaw-playground

文字编辑器。VS Code、Cursor、Vim 都可以。OpenClaw 第一周多半都在改 Markdown、开新 session、问 agent 有没有读到设置，这是正常的。

前置需求四件事总览

安装 OpenClaw

旧笔记写 npx openclaw init 的话直接忽略。本文用 setup --workspace .openclaw，这个最容易重跑、也最容易检查产出。

固定在 4.x 稳定线（推荐入门用）：

npm install -g openclaw@2026.4.26
openclaw --version
openclaw setup --workspace .openclaw

要追 5.x 最新线：

npm install -g openclaw@2026.5.7
openclaw --version
openclaw setup --workspace .openclaw

只想快速跑验一次，可以用 npx：

npx -y openclaw@2026.4.26 setup --workspace .openclaw

第一次入门先锁固定版本，等你知道 workspace 里每个文件在做什么，再升新线。这样比较不会把”自己设置错”跟”版本行为变了”混在一起。

setup 完之后跑互动设置：

openclaw configure

想一次走完整 onboarding：

openclaw setup --wizard

或照官方流程：

openclaw onboard --install-daemon

三个命令做的事情不太一样。setup 偏建立本地 config 跟 agent workspace；configure 偏 credentials、channels、models；onboard 偏第一次完整引导。新手把 setup 跟 configure 跑通就够了。

setup 完会看到什么

跑完 setup --workspace .openclaw，workspace 大概长这样：

.openclaw/
  AGENTS.md
  SOUL.md
  IDENTITY.md
  USER.md
  TOOLS.md
  BOOTSTRAP.md
  HEARTBEAT.md

抓两件事就好：

AGENTS.md 是 OpenClaw 启动时会自动载入的入口文件。OpenClaw harness 默认读取文件名就是 AGENTS.md，不需要再写一个外面的入口去 import 它。
BOOTSTRAP.md 是第一次设置时的启动任务，跑完 onboarding 后可能会被流程移除。看到它消失不代表坏了。

SOUL.md / IDENTITY.md / USER.md 比较像 agent 的长期身份和用户偏好；TOOLS.md 是工具使用提醒。刚开始这几个都不用写满，先让 onboarding 生成基本内容，再慢慢修。

setup 不会默认建立的东西：

MEMORY.md
brain.md
skills/
cron/jobs.json

这几个找不到是正常。它们是你开始建工作流之后才会慢慢长出来的文件。

OpenClaw 安装步骤示意

AGENTS.md：当索引，不要当百科

最常见的入门错误：把所有规则塞进 AGENTS.md，写到 500 行，每次对话光读设置就吃掉一大块 context window。

AGENTS.md 的价值不是规则本身，而是”告诉 agent 下一步该去哪里看”。最小可用版本长这样：

## Session Startup
- Read AGENTS.md first
- Check brain.md for current work state
- Check MEMORY.md for long-term context

## Working Rules
- Edits scoped to user request
- 不动 secrets 与 runtime 生成文件
- 大改前先讲 plan

## Memory
- Long-term index: MEMORY.md
- Today's state: brain.md

## Skills
- Workspace skills: skills/<name>/SKILL.md

几条红线、几个 pointer，就完成了。三个常见错误要避开：

把每日进度写进 AGENTS.md：入口文件几周后就会臃肿到读不下去。
把工具细节全塞 AGENTS.md：工具使用偏好留 TOOLS.md、特定能力拆 skill。
“永远要做”跟”必要时才做”混在一起：每次都要读的内容越少，启动越干净。

入口文件当索引示意

记忆系统：MEMORY.md + brain.md

先讲重点：MEMORY.md 跟 brain.md 都不是 OpenClaw setup 默认产物。 它们是社区惯例的命名，自己 touch 出来、自己定义要怎么用。叫别的名字也可以，这套架构不会强制文件名。

不默认替你建这两个文件反而是好事。记忆一开始就塞满，几周后会变成杂讯。

MEMORY.md：地图

touch .openclaw/MEMORY.md
mkdir -p .openclaw/memory

写法是”索引 + 读取策略”，不装数据本身：

## Always Check
- brain.md：当前工作状态

## Project Memory
- memory/project.md：项目背景、长期决策
- memory/style.md：写作偏好、踩过的坑

## Archive
- memory/archive/：过期但可能要查的数据

MEMORY.md 是告诉 agent 什么记忆在哪、什么时候该看，本身不存内容。

brain.md：今天的便条纸

touch .openclaw/brain.md

## Current Focus
- 重写 OpenClaw 入门教程

## Next Actions
- 跑一次本地 setup 验事实
- FAQ 校对

## Notes
- brain.md 每周清一次，过期的丢 archive 或删

控制在 30-60 行内。一旦变成流水帐，agent 反而会被昨天、上周、上个月的杂讯干扰。

希望 OpenClaw 每次 session 都检查它的话，就在 AGENTS.md 的 startup 区写一行”需要当前工作状态时，先读 brain.md”。比把 brain 内容塞进 AGENTS.md 干净很多。

记忆系统分层示意

第一个 skill

OpenClaw skills 走 AgentSkills 相容结构。文件夹名称小写，但文件名一定要大写 SKILL.md。最常见的入门错误就是写成 skill.md，agent 直接找不到。

mkdir -p .openclaw/skills/hello-openclaw
$EDITOR .openclaw/skills/hello-openclaw/SKILL.md

最小版本：

---
name: hello-openclaw
description: 用户要求测试 OpenClaw skill 载入时，回复简短检查消息。
---

当被触发时：
- 确认此 skill 已载入
- 提到目前 active workspace（如有）
- 回复控制在 5 行内

存档后，开新 session 或跑：

openclaw skills list
openclaw skills check

skill 没被载入时先查三件事：路径是不是 .openclaw/skills/<name>/SKILL.md、文件名是不是大写、CLI 推到的 workspace 是不是同一个 .openclaw/。

第一个 skill 结构示意

排程：先放着

OpenClaw 有 cron，但入门第一天先别碰。基本 workspace 没跑稳之前加排程，反而变成 debug 时的杂讯源。

等日常跑顺了再用：

openclaw cron add
openclaw cron list

排程定义会落在 cron/jobs.json，执行状态落在 cron/jobs-state.json。这两个 setup 都不会默认建，所以前面找不到很正常。

常见问题

Q：安装要多久？

Node、npm、provider 都备好的话，setup 到 configure 15-20 分钟。第一版 AGENTS.md、记忆文件、第一批 skills 通常占到半天，可以边用边调。

Q：AGENTS.md 要写多长？

新 agent 打开 30 秒内读完知道下一步去哪里看的长度。超过就拆。

Q：setup 后没有 MEMORY.md 或 brain.md，是坏了吗？

不是。它们是你设计记忆系统时自己加的，OpenClaw setup 只负责 bootstrap 那组文件。

Q：MEMORY.md 跟 brain.md 到底差在哪？

MEMORY.md 是地图（哪些记忆在哪），brain.md 是今天桌上的便条纸（现在进行式）。前者很少改、后者每天动。

Q：skill 没载入怎么办？

九成问题是文件名写成 skill.md，改大写 SKILL.md 就好。再不行才查路径跟 workspace。

Q：cron/jobs.json 找不到怎么办？

正常，setup 不建。openclaw cron add 跑过才会有 job 定义。

Q：设置写错了会搞坏 OpenClaw 吗？

不会。多半是 Markdown 错乱或 JSON 格式错，agent 行为怪一下而已。git diff 看一下回上一版就好。

Q：Windows 可以用吗？

往 WSL2 走。原生 Windows 路径、shell、daemon 会多踩很多小坑，不值得。

常见入门踩坑示意

下一步

做到这里 workspace 已经能用。接下来慢慢加：

AGENTS.md 收敛到只剩 startup、红线、pointer
MEMORY.md 写地图
brain.md 写当前状态
1-3 个真的会用到的 SKILL.md
日常跑顺了再加 openclaw cron 跟多 agent

不用一天搞定。OpenClaw 的甜蜜点要花一段时间调，定位本来就是给弹性高、愿意自己动手的人。对 CLI 完全过敏的话，这条路会比较痛苦。

小企鹅（Penchan）的经验

OpenClaw 是每天主力在跑的工具，从写文章、管项目到排 cron 都靠它。第一个月最痛的真的是记忆这块，刚上手时 brain.md 越塞越乱、agent 越来越笨。后来把核心文件精简到只剩人格、自我叙事、当下状态，配合 MEMORY.md 索引才稳下来。

最有感的一条：AGENTS.md 短到”30 秒读完知道下一步”是底线，超过就拆。短的入口文件让 agent 每次开工都很干净。

OpenClaw 还有不少可以最佳化的地方，定位本来就是给愿意自己动手调的人。对 CLI 完全过敏的话，这条路会比较痛苦。

整理：Penna｜小企鹅（Penchan）