龙虾OpenClaw（🦞）超全下载安装教程

前置要求

• 系统：macOS/Linux/Windows（Windows优先用WSL2，原生需管理员权限）
• 核心依赖：Node.js ≥22.0.0（一键脚本会自动安装，无需手动配置）
• 必备用具：提前获取大模型API Key（如DeepSeek、阿里云百炼、Claude）
• 

一、本地一键安装（首选，全平台通用）

1. Windows系统（PowerShell）

1. 以管理员身份打开PowerShell（右键开始菜单选择）；
2. 解锁执行权限： Set-ExecutionPolicy Bypass -Scope Process -Force ；
3. 官方一键安装： iwr -useb https://openclaw.ai/install.ps1 | iex ；
4. 国内镜像（下载慢用）： iwr -useb https://clawd.org.cn/install.ps1 | iex 。

2. macOS/Linux/Windows WSL2

1. 打开终端/Terminal；
2. 官方一键安装： curl -fsSL https://openclaw.ai/install.sh | bash ；
3. 国内镜像（下载慢用）： curl -sSL https://clawd.org.cn/install.sh | bash 。

3. 验证安装

二、手动npm安装（已有Node环境适用）

1. 原版全局安装： npm install -g openclaw@latest ；
2. 中文社区版（适配国内）： npm install -g openclaw-cn@latest ；
3. 解决sharp模块报错（macOS/Linux）： SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest 。

三、云服务器部署（推荐生产环境，0成本领腾讯云）

1. 领免费腾讯云服务器

1. 打开CodeBuddy，完成下载安装注册；
2. 点击「立即领奖」，微信扫码登录腾讯云（未实名先完成实名认证）；
3. 0元下单1个月轻量应用服务器，确认即领取成功。

2. 云端一键部署OpenClaw

1. 登录腾讯云控制台，找到「轻量应用服务器」；
2. 选中服务器，点击「重装系统」→ 选择「应用模板」→ 找到OpenClaw；
3. 设置SSH密码，等待1分钟，系统重装完成即部署成功。

四、安装后必做：初始化配置

1. 终端/PowerShell执行： openclaw onboard --install-daemon （中文社区版： openclaw-cn onboard --install-daemon ）；
2. 跟随向导操作（新手全程选默认）：

• 输入 yes 确认风险告知，启动模式选 quickstart ；
• 选择模型服务商，输入提前准备的API Key，完成模型连接测试；
• 输入 yes 安装daemon服务，实现开机自启、后台常驻；
• 聊天平台/技能可先选 skip ，后续在控制台配置。

五、启动与访问控制台

• openclaw doctor （基础检查）
• openclaw health （网关健康）

• 本地部署： http://127.0.0.1:18789
• 云服务器： http://你的服务器公网IP:18789 ；

六、避坑关键提醒

1. Windows原生环境易出问题，优先用WSL2，全程必须管理员权限；
2. 国内网络/npm下载慢，先配置国内镜像： npm config set registry https://registry.npmmirror.com ；
3. OpenClaw可访问文件系统/执行代码，不要在存重要资料的电脑上部署，推荐虚拟机/云服务器；
4. 云服务器需放行18789端口（控制台端口）、18790端口（网关端口）。

七、常用运维命令（排查/管理必备）

• 查看服务状态： openclaw gateway status
• 启动/重启服务： openclaw gateway start / openclaw gateway restart
• 实时查看日志（排错首选）： openclaw logs follow
• 重新打开控制台： openclaw dashboard

官方资源

• 官网：https://openclaw.ai/
• 官方文档：https://docs.openclaw.ai/zh-CN
• 源码仓库：https://github.com/openclaw-foundation/openclaw
• 国内Gitee镜像：https://gitee.com/zxs731/open-cut-raspberry-pi