我是一个对清单有执念的人。任何事情没有清单，我就觉得不踏实。安装OpenClaw这件事，我整整列了28个检查项，逐一打勾完成之后才正式开工。今天把这份清单分享出来，保证你照着做，一次到位。
Checklist Part 1：硬件环境检查（编号 #001 - #006）
- #001 确认设备操作系统版本（macOS 13+/Windows 10+/Ubuntu 22.04+/Android 10+/iOS 16+）
- #002 检查可用磁盘空间 >= 2GB
- #003 检查可用内存 >= 4GB（推荐8GB以上）
- #004 确认网络连接稳定（ping github.com延迟 < 200ms）
- #005 如果用旧手机部署，确认电池健康度 >= 70%
- #006 准备稳定电源或充电线（7x24运行场景必备）
Checklist Part 2：软件依赖检查（编号 #007 - #012）
- #007 安装Node.js >= 20.0.0（执行
node -v确认） - #008 安装pnpm包管理器（执行
pnpm -v确认） - #009 安装Git（执行
git --version确认） - #010 如果用Docker部署，确认Docker Engine已安装并运行
- #011 终端工具就位（Mac用iTerm2/Terminal，Windows用PowerShell/WSL2）
- #012 代码编辑器就位（VSCode推荐，用于编辑配置文件）
Checklist Part 3：账号与密钥准备（编号 #013 - #018）
- #013 注册GitHub账号（用于下载和跟踪更新）
- #014 准备至少一个AI模型的API Key（Claude/DeepSeek/Qwen任选其一）
- #015 记录API Key到安全的密码管理器中（不要明文存在txt里！）
- #016 准备至少一个聊天平台账号（微信/飞书/Telegram/Discord）
- #017 如果用飞书，提前创建飞书机器人并获取凭证
- #018 如果用QQ，完成QQ机器人实名认证
Checklist Part 4：下载与安装（编号 #019 - #022）
- #019 从GitHub官方仓库clone代码（认准openclaw组织，星标28万+那个）
- #020 执行
pnpm install安装依赖（全绿无报错） - #021 复制
.env.example为.env并填入API Key - #022 执行首次启动命令，确认Gateway正常监听18789端口
Checklist Part 5：核心配置文件初始化（编号 #023 - #026）
- #023 编写SOUL.md——定义你的AI助手人格（名字、性格、说话风格）
- #024 编写USER.md——写清你的职业、偏好、禁忌、输出格式要求
- #025 编写AGENTS.md——设定行为准则、安全底线、高危操作审批流程
- #026 编写MEMORY.md——初始化长期记忆，写入你的项目背景和关键信息
Checklist Part 6：验证与收尾（编号 #027 - #028）
- #027 发送第一条测试指令（“你好，请告诉我你是谁”），确认回复正常
- #028 执行一个简单任务（如"帮我创建一个test.txt文件"），确认工具调用正常
为什么要搞这么多检查项？
我知道你可能觉得我有病——装个软件至于列28项吗？
至于。
因为我踩过的坑全在这个清单里：
坑#1：Node.js版本太低。我第一次装的时候用的是Node 16，启动直接报语法错误，查了半小时才发现是版本问题。所以清单#007排在前面。
坑#2：API Key写错一个字符。复制粘贴的时候多了个空格，OpenClaw连模型都调不通。我在#015特意标注了用密码管理器，就是防止手动输入出错。
坑#3：没写SOUL.md就开始用。结果AI回复又长又啰嗦，完全不是我想要的风格。后来补上SOUL.md重启，瞬间判若两人。所以#023-#026是重中之重。
坑#4：磁盘空间不足。npm依赖加上模型缓存，轻轻松松吃掉1个多G。我一台旧笔记本硬盘只剩500MB，安装到一半报错。#002就是这么来的。
我的清单使用方法
我把这28项打印出来贴在显示器旁边。每完成一项，用红色马克笔打个勾。全部打完勾的那一刻，有一种仪式感上的满足——类似于拼完一整盒乐高的感觉。
如果你跟我一样是个清单控，建议你也打印出来。不是清单控的话…建议你也打印出来。因为这28项里，漏掉任何一项都可能让你在安装过程中卡住，然后花更多时间去排查。
进阶清单：每周维护检查（编号 #W01 - #W05）
装好之后不是万事大吉。我还有一份每周维护清单：
- #W01 检查OpenClaw是否有新版本（
git pull或查看GitHub Release） - #W02 检查MEMORY.md文件大小（超过50KB建议精简）
- #W03 检查API用量和余额（避免余额不足导致罢工）
- #W04 备份workspace目录（我用rsync每周自动备份到NAS）
- #W05 检查Skills更新（社区每周都有新技能包发布）
总结
| 清单类别 | 项数 | 预计耗时 |
|---|---|---|
| 硬件环境 | 6项 | 5分钟 |
| 软件依赖 | 6项 | 15分钟 |
| 账号密钥 | 6项 | 20分钟 |
| 下载安装 | 4项 | 10分钟 |
| 核心配置 | 4项 | 30分钟 |
| 验证收尾 | 2项 | 5分钟 |
| 合计 | 28项 | 约85分钟 |
85分钟，换来的是一个配置正确、一次到位、后续零折腾的OpenClaw环境。
清单即正义。编号即秩序。打勾即安心。
如果你也有自己的安装清单补充项，评论区告诉我编号几——我会加进下一版清单里。