
OpenClaw 3.8 保姆级安装教程!小白3分钟养成最新龙虾,官方一键+CLI全平台详解大家好,我是你们的AI效率观察员。前两天刚给你们拆完《OpenClaw 3.8 正式发布!本地备份+ACP溯源+Brave LLM Context全解决》,今天就直接上干货——官方最新 v2026.3.8 安装步骤!不管你是 macOS、Windows(WSL2)、Linux,还是第一次养虾的小白,这篇基于 openclaw.ai 官网 + GitHub 官方 Release + docs.openclaw.ai 的最完整保姆教程,保证你3-5分钟就能把最新版龙虾装好、跑起来。(PS:3.8 刚上线已经自动指向它,升级即安装!)一、前置条件(必看,避坑)
- Node.js ≥22(必须!老版本会直接报错)
- 支持包管理器:npm / pnpm / bun(推荐 npm)
- 内存 ≥8GB(本地跑模型推荐16GB+)
- API Key:准备好 Anthropic / OpenAI / Grok / Claude 等任意一家(3.8 支持更多 failover)
温馨提醒:3.8 新增 openclaw backup create 命令,安装完立刻备份,手滑再也不怕!二、最推荐:官网一键安装(全平台通用,1分钟搞定)官网直接给了傻瓜式脚本,自动装 Node.js + OpenClaw + 守护进程:
curl -fsSL https://openclaw.ai/install.sh |bash
执行完后,终端会自动进入 onboarding 向导,按提示操作即可。Windows 用户:用 PowerShell(管理员)运行相同命令,或下载 install.ps1。优点:自动处理一切,适合小白和懒人。三、手动 CLI 安装(推荐进阶用户,精确可控)
# 1. 全局安装最新版(自动就是 3.8)npminstall -g openclaw@latest# 或者用 pnpm / bun# pnpm add -g openclaw@latest# bun add -g openclaw@latest# 2. 启动 onboarding 向导(超级重要!)openclaw onboard --install-daemon
向导会帮你:
- 创建 ~/.openclaw 状态目录
- 安装 Gateway 守护进程(macOS 用 launchd,Linux 用 systemd --user)
- 配置默认 Agent 和第一个通信渠道(推荐先接 Telegram 或 WhatsApp)
安装守护进程后,龙虾就能后台常驻了!四、macOS 桌面版安装(Menu Bar 神器)
- 去官网 https://openclaw.ai 下载最新 OpenClaw.app(3.8 已复用 beta 资产线)
- 拖入 /Applications 文件夹
- 打开后会自动提示配对远程 Gateway(3.8 新增 remote token 字段,超友好)
额外权限:第一次运行会弹出麦克风、屏幕录制、自动化等权限,全点允许即可(官方 signed build)。五、安装完成后必做 4 步(不然龙虾不干活)
- 启动 Gateway(控制中枢):
openclaw gateway --port 18789 --verbose
- 配对通信渠道(以 Telegram 为例):
- 在向导里输入 Bot Token
- 或后期运行 openclaw channel add telegram
- 配置模型 Key(3.8 支持多模型自动切换):
openclaw config set anthropic.apiKey sk-xxx# 或在 ~/.openclaw/config.yaml 手动编辑
- 验证安装成功:
openclaw --version # 应该显示 2026.3.8 + git commit hashopenclaw doctor # 检查配置健康度
六、特殊场景安装
- Windows WSL2:强烈推荐!在 WSL 里走 CLI 流程即可(浏览器 CDP 更稳)
- Docker:官方有 Docker 支持(docs.openclaw.ai/install/docker)
- 源码开发版:
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm buildpnpm openclaw onboard --install-daemon
- 远程服务器(AWS/Lightsail):用 Tailscale 打通,3.8 macOS app 已支持 remote token
七、常见问题速查
- command not found → 重启终端,或 hash -r重启终端 →找不到命令 ,或 hash -r
- 权限弹窗卡住(macOS)→ 系统设置 → 隐私与安全性 → 允许 OpenClaw
- 国内下载慢 → 换 npm 源或开代理
- 想回滚老版本 → npm install -g openclaw@2026.3.7(不推荐,3.8 安全&功能全面碾压)
安全提醒:安装完立刻跑 openclaw backup create,3.8 新增本地备份功能,放心玩!最后想说OpenClaw 从 1.x 到现在的 3.8,只用了不到两个月,更新速度真的卷疯了。现在装的就是全球最强的本地 AI Agent——能真正“动手”干活的那种!装完的兄弟,评论区报个到:你是用一键脚本还是手动 CLI?遇到了什么坑?装好后别忘了试试 3.8 新功能:openclaw backup create + Brave LLM Context + Talk 静默超时,爽到飞起!点个在看 + 转发,帮还在纠结“怎么养龙虾”的朋友快速上车~下期我们实测 3.8 多 Agent 协同 + ClawHub 技能市场精选,敬请期待!—— 你的AI效率观察员
夜雨聆风