OpenClaw 入门到实战：安装、配置、使用、升级与卸载（Windows/macOS/Linux）

本文面向第一次接触 OpenClaw 的开发者，目标是让你在 15~30 分钟内完成：安装、首次配置、基础使用、常见问题排查和干净卸载。文末附完整命令清单，方便收藏后直接执行。

1. OpenClaw 是什么？适合谁用？

OpenClaw 可以理解为"在你本地开发环境里工作的 AI 编程代理"。它不是单纯聊天工具，而是能配合终端/编辑器执行工程任务的助手，比如：创建代码、修改代码、运行命令、诊断问题、整理变更说明等。

适合人群：后端/前端开发、测试工程师、运维、独立开发者，以及希望把重复性工作自动化的人。

2. 安装前准备

开始前先确认以下条件：

已安装 Node.js（推荐 Node.js 24；兼容 22.16+）
网络可以访问 OpenClaw 相关服务
终端具备基础执行权限

检查 Node.js 版本：

复制代码

node -v
npm -v

3. OpenClaw 安装（3 种方式）

3.1 macOS / Linux（官方脚本，推荐）

复制代码

curl -LsSf https://app.openclaw.ai/install.sh | sh

3.2 Windows（PowerShell）

复制代码

powershell -ExecutionPolicy Bypass -c "irm https://app.openclaw.ai/install.ps1 | iex"

3.3 npm 全局安装

复制代码

npm install -g @openclaw/agent@latest

4. 首次启动与初始化配置

安装后先启动：

复制代码

openclaw

首次通常会引导你完成账号认证、模型供应商配置和基础参数设置。

如果你希望一次完成引导并安装后台守护进程，可使用：

复制代码

openclaw onboard --install-daemon

5. 日常使用：常见命令与工作流

日常建议先做健康检查，再开始项目协作：

复制代码

openclaw doctor
openclaw status --all
openclaw gateway status

查看实时日志：

复制代码

openclaw logs --follow

推荐工作流：

进入项目目录后启动 OpenClaw
先让它读取当前仓库上下文（技术栈、目录结构、关键模块）
再下达明确任务（例如"修复某报错并补测试"）
最后人工复核改动并跑测试

6. 常见问题排查

6.1 命令找不到（command not found）

通常是 PATH 未生效。重新打开终端，或把 npm 全局 bin 目录加入 PATH。

6.2 安装报权限错误（EACCES）

复制代码

npm install -g @openclaw/agent@latest --prefix "$HOME/.local"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

6.3 启动后无法连通服务

先执行 openclaw doctor，再结合 openclaw logs --follow 查看具体报错。重点排查：网络代理、防火墙、证书与本地端口占用。

7. 升级 OpenClaw

如果通过 npm 安装，直接执行：

复制代码

npm install -g @openclaw/agent@latest

升级后建议再执行一次健康检查：

复制代码

openclaw doctor

8. 卸载 OpenClaw（标准与彻底）

8.1 标准卸载

复制代码

openclaw uninstall

8.2 彻底卸载（清理更多状态）

复制代码

openclaw uninstall --all --yes --non-interactive

8.3 多 profile / dev 环境场景

复制代码

openclaw uninstall --dev --profile foo

9. 一份可收藏的命令速查清单

复制代码

# 启动
openclaw

# 首次引导 + 安装守护进程
openclaw onboard --install-daemon

# 健康检查
openclaw doctor
openclaw status --all
openclaw gateway status
openclaw logs --follow

# 升级（npm 安装方式）
npm install -g @openclaw/agent@latest

# 卸载
openclaw uninstall
openclaw uninstall --all --yes --non-interactive

10. 总结

如果你是第一次上手，建议路径是：官方安装脚本 → 首次引导 → doctor 检查 → 小任务试跑。等你熟悉后，再把 OpenClaw 接入自己的日常开发流程，效果会非常明显。

OpenClaw 入门到实战：安装、配置、使用、升级与卸载（Windows/macOS/Linux）