🔥30分钟跑通OpenClaw:新手小白也能一次过的保姆级教程(附避坑清单)🚀

289 阅读2分钟

🔥30分钟跑通OpenClaw:新手小白也能一次过的保姆级教程(附避坑清单)🚀

宝子们!😭是不是看网上的OpenClaw教程看得头都大了? ❌ 教程很多,但版本不一致,越看越乱! ❌ 按步骤做了,还是报错! ❌ 装好了却只能本机访问,其他电脑根本连不上!

我也踩了好多坑!这篇给你一条最短路径:从0到可访问的OpenClaw安装全流程,亲测有效!✨


1️⃣ 前提条件:Node.js 环境 💻

如果你机器上已经有Node.js,可以直接跳到下一步! 没有的话,推荐用 nvm 安装,版本管理不打架!👍

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

# 使 nvm 生效
source ~/.bashrc

# 安装 Node.js
nvm install v24.13.0

2️⃣ 安装OpenClaw 🛠️

简单粗暴,两行代码搞定! 记得加 mirror,速度飞起!🚀

# 下载并安装
npm install -g openclaw@latest --registry=https://registry.npmmirror.com

# 首次启动并安装 daemon
openclaw onboard --install-daemon

👇 安装过程长这样: image.png image.png

🚨 划重点: 🔸 模型可以先选 Qwen 免费模型,后续再替换! 🔸 浏览器按提示完成授权即可! image.png 🔸 向导里暂时不需要的项,直接跳过 or 选 NO


3️⃣ 关键一步:局域网访问🔓

想让同事电脑也能连?这步不仅要看,还要背诵! 📂 编辑配置文件:~/.openclaw/openclaw.json

重点改这俩: ✨ gateway.bind 改为 "lan"controlUi.allowInsecureAuth 改为 true (不然 https 报错烦死你)

参考配置:

{
  "gateway": {
    "bind": "lan",
    "auth": {
      "mode": "token",
      "token": "<检查这里的token>"
    }
  },
  "controlUi": {
    "allowInsecureAuth": true
  }
}

👇 参考配置效果: image.png


4️⃣ 重启并检查状态 🔄

改完配置一定要重启!不然白改了!😭

# 重启网关
openclaw gateway restart

# 查看运行状态
openclaw gateway status

👇 看到 running 就对啦: image.png


⚠️ 高频避坑清单(建议收藏)

  1. openclaw 命令找不到 ❌ 👉 确认 npm -g 安装目录在 PATH 环境变量中!
  2. 改完配置不生效 ❌ 👉 记得执行 openclaw gateway restart
  3. 外部设备打不开 ❌ 👉 确认 bind 已经改成了 "lan",并检查防火墙/端口是否放行!
  4. 访问页面认证失败/401 ❌ 👉 检查配置里的 token 无误!记得要填对!

👀 最终成功页面: image.png


💡 总结 跟着这个流程走,绝对能跑通! 🎉 如果有帮助,记得点个赞哦!❤️

#OpenClaw #AI #程序员 #技术分享 #本地部署 #开源项目 #避坑指南 #AI教程 #OpenClaw安装 #局域网访问