这篇是我自己从装 OpenClaw 到用它接管日常的全部实操记录的第一篇。所有命令、版本号、日期都是本机真实发生过的,不是文档搬运。
OpenClaw 是什么(一句话)
一个跑在你自己机器上的常驻 AI 网关:它把你现有的聊天渠道(微信、Telegram、网页等)接进来,背后挂上大模型、工具(shell、浏览器、文件、定时任务)和一套"文件即记忆"的工作区,让你从手机上就能指挥一台自己的电脑干活。
我本机现状:OpenClaw 2026.7.1-2 (0790d9f),Node v24.15.0,Windows。注意它的版本号是日期制(2026.7.1-2),不是什么 v2.x 序列——网上看到"升级到 v2.3.5"之类的建议,直接当幻觉处理。
安装:就一条 npm
npm install -g openclaw@latest
我用 nvm-windows 管 Node,所以全局包实际落在 D:\Programs\nvm\v24.15.0\node_modules\openclaw。有个附带好处:官方文档就随包装在你机器上,路径是 <那个目录>\docs\,断网也能查。
装完跑引导:
openclaw onboard # 引导式配好 auth、模型、Gateway、工作区、渠道、技能
openclaw status # 体检:网关、渠道、模型、最近会话
它会创建两个关键位置:
~\.openclaw\—— 配置目录,核心是一个openclaw.json,改完用openclaw config validate验证再重启网关;- workspace(工作区) —— 默认在
~\.openclaw\workspace,这是它的"人格+记忆"所在:AGENTS.md(工作守则)、SOUL.md(性格)、IDENTITY.md、USER.md(用户档案)、TOOLS.md(工具笔记)、MEMORY.md(长期记忆)、memory/(日志目录)这组 bootstrap 文件每次会话自动注入。
升级踩过的第一件事
我 5 月 19 日的日志里记着第一次升级:2026.5.12 → 2026.5.18,CLI 升级后把 Gateway 服务重装重启才正常,而且旧配置里的模型字段格式可能要跟着新版调整——日期制版本更新很勤,升级前备份配置是血泪习惯。我的规矩是每次改 openclaw.json 前先复制一份带日期的备份(如 openclaw.json.bak-20260903),正式归档放工作区 backups/ 目录。
workspace 迁盘
默认工作区在 C 盘,我第一天就把它迁到了 D:\openClaw\workspace:文件整个搬走,配置里 workspace 指向新路径即可。迁完那次发现 bootstrap 文件丢了几个,按名字重建就行——这些文件本来就是纯 Markdown,没有黑盒。
把微信接进来
渠道(channel)走插件制,我装的 openclaw-weixin,配好后我的微信直连会话就是它的控制台:发消息即下指令,它跑完长任务把结果推回微信。渠道侧有**授权名单(allowlist)**机制——不在名单里的号发消息进来它不理。这条非常重要,微信是个会被人找上的入口。
顺带说群聊观感:一个群里有多个 AI 是会被发现的,敏感账号自己掂量。
笔记本当服务器:电源设置是硬活
OpenClaw 的网关是个常驻进程,机器睡了它就死了。我用笔记本,5 月 19 日当天就用 powercfg + 注册表做了永久配置:
- 交流/电池睡眠:永不;休眠:关闭;网卡省电:禁用
- 合盖:不采取任何操作——注意合盖这项要用
powercfg /setacvalueindex和/setdcvalueindex写注册表(ACSettingIndex/DCSettingIndex=0),powercfg /change那个常用命令根本管不到它
后来排查定时任务漂移时,“夜间机器是否在睡"永远是我第一个怀疑对象,这篇先埋个伏笔。
装完怎么自检
openclaw status # 渠道健康 + 最近会话
openclaw health # 跑着的网关健康值
openclaw doctor --fix # 常见配置/服务/插件问题,体检加修复
openclaw gateway status # 网关服务状态
装好之后建议先读系列的架构篇,理解了"网关-会话-工作区文件"三件套,后面所有用法都是顺的。
「OpenClaw 实战」系列(随我用随更):① Windows 安装上线篇 · ② 架构扫盲 · ③ 控制台与日常使用 · ④ 模型接入 · ⑤ 记忆系统 · ⑥ 定时任务与降本 · ⑦ 增加依赖