ARTICLE · 1091576
OpenClaw装到会聊天:小白保姆级全流程
OpenClaw装到会聊天:小白保姆级全流程
一个不会写代码的店主 × 一个AI|数字员工进家实录
姐妹们,这篇记录我把 OpenClaw(一个能装在自己电脑上的 AI 助手)从零装到会聊天的全过程。把它想象成请了个数字员工住进电脑:它要水电(Node.js)、要饭卡(API Key)、要有灶台(后台发动机),然后你才能跟它说话。


一、开工前备齐三样
1. 水电:Node.js,命令 npx 能用就说明有了;
2. 饭卡:DeepSeek 的 API Key,去 platform.deepseek.com 申请,sk- 开头那一串;
3. 两个黑窗口的概念:一个当"发动机"(灶台),一个当"聊天框"——这个想明白了,后面全通了。
二、七步装到会聊天
第 1 步:办入住。PowerShell 敲 npx openclaw onboard,它会建好档案柜(.openclaw 文件夹)。第一铁律:别手改配置文件!改坏了就重跑一次 onboard 覆盖修复,别自己瞎猜。
第 2 步:交饭卡。敲 npx openclaw creds 把 key 粘进去,再用 npx openclaw models status 验证——模型显示 ready 才算饭卡有效。饭卡就是 AI 的命:卡不对,它一步都不走。
第 3 步:选住哪种房子。敲 npx openclaw config set gateway.mode local,再用 gateway status 确认。
第 4 步:体检。敲 npx openclaw doctor,它会一项项检查。有些警告是可选功能没配,不影响使用,可以忽略。
第 5 步:点灶开火。第一次启动聊天可能报"旧认证要升级"(Legacy device auth)——别慌,不是你弄错了。三步:停掉发动机窗口(Ctrl+C)→ 敲 npx openclaw doctor --fix 自动修 → 重新敲 npx openclaw gateway。看到 gateway-ready 就是火点着了。
第 6 步:开聊。发动机窗口别关,新开一个窗口敲 npx openclaw,出现 gateway connected 就大功告成。注意:它官网那个宣传网页不是聊天界面,点不动是正常的,真正说话的地方是黑窗口。
第 7 步:做一键按钮。桌面新建文本文档,写入启动命令存成 OpenClaw.bat(保存类型选"所有文件"),以后双击等 10 秒,两个窗口自动弹出来:一个发动机(只看别关),一个聊天框(在这里打字)。
三、报错别慌:报错变了=修对了
1. 配置写坏了(configuration looks malformed)→ 重跑 onboard;
2. 提示缺 key(missing key)→ 重填饭卡(npx openclaw creds);
3. 连接被拒(ECONNREFUSED)→ 灶台没点火,先跑 gateway;
4. 旧认证报错 → 停火 → doctor --fix → 重新点火;
5. 聊天窗说没连上 → 你先开了聊天窗,灶还没点着——先发动机后聊天,顺序不能反。
日常口诀:双击按钮 → 等 10 秒 → 挑能打字的窗口 → 开聊。用完聊天窗口点叉,发动机 Ctrl+C 再关。
我一个大字代码都不会写,照样装起来了。你也想给家里电脑请个数字员工的,把这篇丢给你的 AI 照着弄。卡住了评论区喊我,姐妹互相搭把手。