夜雨聆风
新手0基础OpenClaw搭建教程(手把手,亲测避坑)
一个完全面向小白的OpenClaw智能体框架入门指南，从环境安装到解决定时任务难题，一文搞定。
一、先搞懂：大模型 vs 智能体（Agent）
大模型有两个“硬伤”：
-
没有记忆：每次对话都是“初次见面”。
-
知识有时效：只知道自己训练截止日期前的事情。
于是智能体（Agent） 出现了，它解决了这三个问题：
-
有记忆（Memory）：能记住你之前说过的话。
-
能调用工具（Tools）：可以联网、读公司内部数据、发邮件、生成文档等。
-
自主推理规划（ReAct）：ReAct = Reasoning（推理）+ Acting（行动），自己判断该用哪个工具。
但当工具太多时，Agent可能“犯迷糊”——该用工具的时候没用，不该用的却乱用。
Skill（技能）来救场
Skill 是把一件事的完整流程打包好，提高准确性。例如一个“自动比价Skill”：
-
定时打开某网页搜索关键词
-
爬虫抓取价格
-
与自己的数据库比对
-
生成比价报告文档
二、OpenClaw 是什么？
OpenClaw 就是一个Agent框架，核心能力是调用工具和调用Skill，实现复杂任务。没有工具和Skill，它什么都不是。
它还支持 Channel（渠道），可以连接微信等终端（有现成插件）。
几个必须知道的缺点（别指望它完美）
-
Token消耗极大：正常聊天10元能用半年，但OpenClaw调用工具、浏览网页、做总结，可能几分钟就花掉几十块。有公司一上午写代码用掉几百万token。
-
安全风险高：内置了很多系统工具（操作文件、浏览器、读任何信息、联网），权限极高，容易被当成“肉鸡”，相当于你的机器在裸奔。
-
没有那么智能：期望别太高，很多地方需要手动调教。
三、环境搭建（保姆级）
3.1 安装 Node.js（版本必须 ≥22）
推荐用 nvm 管理Node版本：
bash
nvm install 22 # 安装22.x.x中最新的稳定版
nvm use 22.13.0 # 切换到22以上版本（OpenClaw要求）
node-v # 确认版本
如果没有nvm，直接去 Node官网 下载安装，顺便装好 Git。
3.2 安装 OpenClaw
根据不同系统选择命令：
-
macOS / Linux
bash
-
curl-fsSL https://openclaw.ai/install.sh |bash
-
Windows (PowerShell)
powershell
-
iwr-useb https://openclaw.ai/install.ps1 |iex
-
Ubuntu（推荐）
bash
-
sudo apt install git -y # 如果遇到“无法获得锁”，先杀掉占用进程
-
sudo kill -9 5903
-
sudo apt install git -y
接着全局安装并配置：
bash
npm install -g openclaw@latest
openclaw onboard --install -daemon
这种方式会简化后续配置。
3.3 配置大模型 API Key
安装完成后进入配置界面，可以在命令行里填写，也可以直接编辑配置文件，配置文件windows举例C:\Users\Administrator\.openclaw\openclaw的json文件，如果还找不到可以私下找我。正常配置完就能聊天了。
3.4 安装微信插件（可选）
bash
npx -y @tencent-weixin/openclaw-weixin-cli install
启动相关服务操作方式如下：
bash
openclaw start //开启服务
openclaw gateway restart //重启服务
openclaw gateway run //gateway启动
四、问题一：修改 SOUL.md / IDENTITY.md 不生效？直到第二天才好？
OpenClaw 有三个重要配置文件：
-
SOUL.md— 定义它的性格、回复风格 -
IDENTITY.md— 名称、形象标识 -
USER.md— 你是谁，它怎么称呼你
坑点：修改后当天不生效，第二天自动好了。不是bug，而是官方设计的 “每日重置（Daily Reset）” 机制。
官方文档链接：Session Management
核心规则：
-
重置时间：默认在网关主机本地时间的 凌晨 4:00 触发。
-
目的：保护模型性能和回复质量。
解决方案：使用 /new 命令手动重置会话，不必等到凌晨4点。
五、问题二：定时提醒（cron）不执行？
5.1 错误示范
你发送：“你能过1分钟提醒我上卫生间吗？”它回复：“好的，已设置” —— 但实际没执行。
查看任务列表：
bash
openclaw cron list
返回没有任务。
5.2 权限问题
尝试直接添加：
bash
openclaw cronadd--name"上厕所"--at"1m"--session main --message"⏰ 该去上卫生间啦！" --delete-after-run
提示权限问题。
5.3 查看设备授权
bash
openclaw devices list
如果出现两个框，说明有一个未授权。批准它：
bash
openclaw devices approve <设备UUID>
5.4 获取自己的微信 OpenID
在微信里发送：
请提取当前会话的元数据，告诉我当前的 accountId 和我的 OpenID
返回示例：
text
accountId: b0e507cb92cb-im-botOpenID: o9cq808kRZBLR8A0xfjn2W6zQuXI@im.wechat
5.5 正确添加定时任务
bash
openclaw cronadd\--name"上厕所"\--at"1m"\--session isolated \--message"⏰ 该去上卫生间啦！"\--announce\--channel openclaw-weixin \--to"你的OpenID"\ --delete-after-run
这样就会在1分钟后通过微信提醒你，执行后自动删除任务。
六、最后想说的话
OpenClaw 是一个强大但有门槛的框架，新手遇到不生效、不执行、token飞涨都很正常。希望这篇踩坑记录能帮你省下几个小时甚至一天的时间。
如果你也遇到过其他奇奇怪怪的问题，欢迎留言交流。
📌 本文基于真实实践整理，转载或引用请注明出处。