乐于分享
好东西不私藏

OpenClaw龙虾安装教程:Windows/Mac/Linux本地部署步骤详解

OpenClaw龙虾安装教程:Windows/Mac/Linux本地部署步骤详解

Windows如何安装OpenClaw?mac怎么安装龙虾?提供四种主流部署方式的详细步骤,覆盖 Windows、macOS 和 Linux 系统,无论是一键安装,还是隔离环境安装,这里都进行一一解答。

详细部署步骤

方法1:一键脚本安装

Windows(管理员 PowerShell)

powershell# 一键安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex# 初始化配置openclaw onboard --install-daemon# 启动服务openclaw start

访问:http://localhost:18789

macOS/Linux(终端)

bash# 一键安装脚本curl -fsSL https://openclaw.ai/install.sh | bash# 初始化配置openclaw onboard --install-daemon# 启动服务openclaw start

访问:http://localhost:18789

方法2:Docker 部署(隔离环境)

安装 Docker Engine 20 + 或 Docker Desktop

启动 Docker 服务

执行部署命令:

bash# 基础部署docker run -d -p 18789:18789 --name openclaw openclaw/openclaw:latest# 持久化存储(推荐)docker run -d -p 18789:18789 \  -v ~/.openclaw:/root/.openclaw \  --name openclaw openclaw/openclaw:latest

查看日志:docker logs -f openclaw

访问:http://localhost:18789

方法3:源码编译(开发 / 定制化)

1、安装前置依赖

Node.js 22.x+(推荐 24),安装时勾选 "Add to PATH"

Git:sudo apt install git(Linux)/ brew install git(macOS)/ 官网下载(Windows)

pnpm:npm install -g pnpm

2、克隆源码并构建

bash# 克隆仓库(国内推荐Gitee镜像)git clone https://gitee.com/openclaw/openclaw.git# 或GitHub原仓库git clone https://github.com/openclaw/openclaw.gitcd openclaw# 安装依赖pnpm install# 构建前端UIpnpm ui:build# 编译核心程序pnpm build# 全局链接(可选)pnpm link --global

3. 初始化与启动

bash# 初始化配置向导openclaw onboard --install-daemon# 启动服务openclaw start# 开发模式(自动重载)pnpm dev

访问:http://localhost:18789 

方法4:Windows 原生部署(不推荐,兼容性差)

安装 Node.js 22+(64 位 msi),勾选 "Add to PATH"

安装 Git for Windows

以管理员身份运行 PowerShell:

powershell# 安装pnpmnpm install -g pnpm# 克隆源码git clone https://gitee.com/openclaw/openclaw.gitcd openclaw# 安装依赖并构建pnpm installpnpm ui:buildpnpm build# 初始化与启动pnpm openclaw onboard --install-daemonpnpm openclaw start

访问:http://localhost:18789

关键配置步骤

API 密钥配置:选择接入 OpenAI/Anthropic/ 本地模型(如 Ollama)

通道设置:配置 WhatsApp/Telegram/Discord 等消息渠道

技能商店:选择安装需要的 AI 技能(可选)

服务配置:设置端口、日志级别等(默认 18789 端口)

守护进程:安装系统服务,实现开机自启

常见问题解决

端口冲突:修改配置文件~/.openclaw/config.yaml中的port值,或启动时指定:openclaw start --port 8080

依赖安装失败:

Windows:确保 PowerShell 以管理员身份运行,网络正常

macOS/Linux:使用sudo权限,或切换国内镜像:npm config set registry https://registry.npmmirror.com

Docker 容器启动失败:

bash# 查看日志docker logs -f openclaw# 重新创建容器docker rm -f openclawdocker run -d -p 18789:18789 --name openclaw openclaw/openclaw:latest

macOS "Unverified Developer" 警告:系统设置 → 隐私与安全 → 点击 "Open Anyway"

验证部署成功

访问:http://localhost:18789,看到 OpenClaw 登录界面

使用初始化向导设置的账号密码登录

测试基础聊天功能

检查系统状态:openclaw status

更新与卸载

更新

bash运行# 一键脚本安装openclaw update# 源码安装git pullpnpm installpnpm buildopenclaw restart

卸载

bash运行# 一键脚本安装openclaw uninstall# Docker安装docker rm -f openclawdocker rmi openclaw/openclaw:latest# 源码安装rm -rf ~/.openclawpnpm unlink --global openclaw