一、部署前须知：你的终端龙虾助手是什么
OpenClaw 是一款可完全本地化部署的终端智能助手（CLI 多 Agent 平台），你可以把它理解成住在你命令行里的智能管家 —— 能帮你写命令、调代码、管文件、对接本地大模型，所有数据都跑在本地，无需云端订阅。
本教程覆盖 Windows /macOS/ Linux（含 WSL） 全平台，全程免费，官方安装脚本会自动处理绝大多数环境依赖，新手也能直接跟着走。
最低环境要求
- 系统：Windows 10+ /macOS 11+ / 主流 Linux 发行版（Ubuntu/Debian/Arch/CentOS/Alpine 等）
- 核心依赖：Node.js v22.19.0 及以上版本（安装脚本会自动帮你装）
- 可选依赖：Git（源码安装模式必需，npm 模式脚本会自动补全）
- 磁盘：预留至少 1GB 空间（依赖 + 本体，后续接入本地大模型需额外空间）
二、一键极速部署（新手首选）
这是最省心的安装方式，官方脚本会自动检测系统、补全依赖、配置环境变量，全程不用手动折腾 Node、Git 这些工具。
1. macOS 平台
- 打开「终端」（Launchpad → 其他 → 终端）
- 复制下面的命令，粘贴到终端里，按回车执行：
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash- 过程中如果提示需要输入密码，输入你的电脑开机密码即可（输入时终端不会显示字符，输完直接回车），这是给环境配置权限用的，放心输入。
- 等待脚本跑完，看到
🦞 OpenClaw installed successfully!就代表安装成功了。
2. Linux / WSL 平台
- 打开你的终端 / WSL 命令行窗口
- 复制执行一键安装命令：
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash- 脚本会自动识别你的发行版（Debian/Ubuntu 用 apt、Arch 用 pacman、Alpine 用 apk），自动安装 Node.js、构建工具等依赖；如果提示 sudo 密码，输入当前用户的密码即可。
- 终端出现成功提示，即代表安装完成。
3. Windows 平台
- 按下
Win + S搜索「PowerShell」，右键选择「以管理员身份运行」 - 在弹出的蓝色窗口里，复制下面的命令粘贴进去，按回车执行：
powershell
powershell -c "irm https://openclaw.ai/install.ps1 | iex"- 脚本会优先用 winget 装 Node.js，没有 winget 会自动下载便携版 Node 放到用户目录，全程不用手动点安装包。
- 等待进度走完，出现绿色的成功提示，就代表安装完成了。
💡 小提示：Windows 安装完成后建议关闭当前 PowerShell，重新开一个新的窗口再使用，避免 PATH 不生效。
三、进阶部署：源码模式安装（开发者可选）
如果你想二次开发、修改源码、跟进最新开发版，可以用 Git 源码模式安装，脚本同样会自动处理 pnpm、构建等流程。
macOS / Linux 源码安装
在终端执行带参数的安装命令即可：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git- 默认会把源码克隆到
~/openclaw目录，想指定目录可以加参数：--git-dir /你的/自定义/路径 - 不想自动拉取最新代码可以加：
--no-git-update
Windows 源码安装
在 PowerShell 里执行：
powershell
& ([scriptblock]::Create((irm https://openclaw.ai/install.ps1))) -InstallMethod git- 自定义源码目录加参数：
-GitDir "D:\你的\自定义路径" - 跳过代码更新加参数：
-NoGitUpdate
四、安装验证：唤醒你的龙虾助手
安装完成后，先验证本体是否正常工作，这一步是确认部署成功的核心。
1. 基础验证：查看版本
新开一个终端窗口，输入下面的命令，按回车：
openclaw --version如果终端输出版本号（比如 v0.x.x），说明安装成功、命令已正常加入 PATH。
2. 环境体检：一键排查问题
执行官方自带的体检命令，自动检查配置、修复迁移问题：
openclaw doctor --non-interactive看到所有检查项都通过，就代表环境完全健康。
3. 首次启动：进入交互模式
直接在终端输入：
openclaw如果成功进入 OpenClaw 的交互界面，出现龙虾提示符和输入框，恭喜你 —— 你的终端龙虾助手已经正式唤醒，部署全程完成！
五、首次配置：完成新手引导
第一次启动后，脚本会自动进入 onboarding 引导流程，跟着提示走就能完成基础配置：
- 选择你的使用场景（日常办公 / 开发 / 自定义等）
- 配置默认的大模型接口（支持本地 Ollama 模型、在线 API 等，纯本地使用推荐先接入本地大模型）
- 设置工作区目录，也就是助手能操作的文件范围
- 完成后即可开始正常对话使用
如果想跳过引导后续再配置，可以在安装时加参数：
- macOS/Linux：命令末尾加
--no-onboard- Windows：参数加
-NoOnboard之后想配置时随时执行openclaw onboard即可重新进入引导。
六、常见踩坑急救包
1. 提示 command not found: openclaw
- Windows：关闭当前 PowerShell 重新打开；如果还不行，检查用户 PATH 里是否有 npm 全局目录，手动加一下即可。
- macOS/Linux：执行
source ~/.zshrc（zsh）或source ~/.bashrc（bash）刷新环境变量；如果是 Linux 用户目录安装，确认~/.local/bin在 PATH 里。
2. npm 安装报错权限不足
Linux 系统下脚本会自动把 npm 全局目录切到用户目录，一般不会出现权限问题；如果还是报错，不要用 sudo 强行安装，执行 npm config set prefix ~/.npm-global 后重新运行安装脚本即可。
3. Node.js 版本过低提示
脚本会自动安装符合要求的 Node 版本，如果系统里有旧版本 Node 优先级更高：
- macOS：用 Homebrew 装
node@24并配置 PATH - Windows：脚本会自动装便携版 Node，重启终端即可生效
- Linux：nvm 用户执行
nvm install 24 && nvm use 24后重新安装
4. 源码模式构建失败
确保你的设备有正常的网络，pnpm 拉取依赖需要联网；如果 UI 构建失败不影响 CLI 核心功能，可以正常使用命令行模式。
七、部署完成后可以做什么
- 终端问答：直接在交互模式里提问，比如 “帮我写一个批量重命名文件的命令”
- 本地大模型接入：搭配 Ollama 部署本地大模型，实现完全离线使用
- 自定义 Agent：创建专属的智能员工，比如文员、程序员、运维助手
- 网关服务：开启后台网关，对接微信、飞书等聊天工具
- 插件扩展：安装官方插件，拓展文件处理、代码调试等能力
如果想后续更新版本，直接执行 openclaw update 即可一键升级，不用重新跑安装脚本。