OpenClaw（小龙虾）本地部署通用教程（Windows / macOS / Linux）

用户688104449086
0 阅读5分钟

OpenClaw 是一个开源的AI自动化代理，可本地部署以执行文件操作、浏览器自动化等任务。以下是 Windows / macOS / Linux 的本地部署指南。

📋 部署前准备

  • 操作系统：Windows 10/11、macOS 12+、Ubuntu 20.04+ 等主流64位系统
  • 硬件建议：内存 ≥ 4GB（推荐 8GB），磁盘空间 ≥ 20GB
  • 核心依赖：
    • Node.js：版本 ≥ 22（推荐 22.x 或 24.x LTS）
    • 包管理器：npm（随 Node.js 安装）或 pnpm（推荐，可避免部分构建错误）
    • Git：用于拉取插件（可选）
    • Docker：用于容器化部署（可选）
  • 模型 API Key：用于智能问答和任务规划。可选用阿里云百炼、硅基流动、OpenAI 等。新手可先跳过，后续在 WebUI 中配置。

如果你对这些都不甚了解，只想快速的安装部署好龙虾，也可以用【Claw大龙虾本地部署大师】来进行快速安装部署好龙虾，然后再结合下面关于配置大模型API的教程就可以。 具体可以看我这篇文章《OpenClaw本地部署：不用写一行代码，把这只“大龙虾”跑起来》

💻 Windows 部署（PowerShell）

1. 以管理员身份打开 PowerShell

在开始菜单搜索“PowerShell”，右键选择“以管理员身份运行”。

2. 安装 Node.js 和 Git

使用 winget 一键安装：

winget install OpenJS.NodeJS.LTS -y
winget install Git.Git -y

安装后执行以下命令检查版本：

node -v
npm -v
git --version

3. 配置 npm 国内镜像（推荐）

加速依赖下载：

npm config set registry https://registry.npmmirror.com

4. 安装 OpenClaw

执行全局安装：

npm install -g openclaw@latest

安装完成后检查版本：

openclaw --version

5. 运行初始化向导

openclaw onboard

根据提示操作：

  • 风险提示：输入 Yes 确认 AI 将拥有本地文件操作权限。
  • 模式选择：新手推荐 QuickStart（快速启动）。
  • 模型/渠道/技能：均可选择 Skip for now（稍后配置）。
  • 交互方式：选择 Open the Web UI，向导将自动启动服务并在浏览器中打开 http://localhost:18789。

6. 手动启动与管理（可选）

若向导未自动启动，可执行以下命令：

# 启动服务
openclaw gateway start
# 查看状态
openclaw status
# 重启服务
openclaw gateway restart

7. 健康检查（重要）

安装完成后，务必运行诊断命令，确保环境正确：

openclaw doctor

如果所有检查项均为绿色，说明部署成功。

8. 获取 WebUI 访问令牌（如需）

首次登录 WebUI 可能需要令牌，可通过以下命令生成：

openclaw token generate

9. 配置文件位置

Windows 配置文件通常位于：

C:\Users\你的用户名\.openclaw\openclaw.json

🍎 Mac OS 部署（终端）

1. 安装 Homebrew

若未安装，在终端执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 Node.js 和 Git

brew install node@22 git
echo 'export PATH="$(brew --prefix node@22)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

检查版本：

node -v
npm -v
git --version

3. 配置 npm 国内镜像（推荐）

npm config set registry https://registry.npmmirror.com

4. 安装 OpenClaw

npm install -g openclaw@latest

检查版本：

openclaw --version

5. 运行初始化向导

openclaw onboard

配置步骤与 Windows 基本一致，最后选择打开 WebUI 即可在 http://localhost:18789 访问。

6. 手动启动与管理（可选）

# 启动服务
openclaw gateway start
# 查看状态
openclaw status
# 重启服务
openclaw gateway restart

7. 健康检查（重要）

openclaw doctor

8. 获取 WebUI 访问令牌（如需）

openclaw token generate

9. 配置文件位置

macOS 配置文件通常位于：

~/.openclaw/openclaw.json

🐧 Linux 部署（Ubuntu/Debian）

1. 更新系统并安装依赖

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git

2. 安装 Node.js

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

检查版本：

node -v
npm -v

3. 配置 npm 国内镜像（推荐）

npm config set registry https://registry.npmmirror.com

4. 安装 OpenClaw

sudo npm install -g openclaw@latest

检查版本：

openclaw --version

5. 运行初始化向导

openclaw onboard

配置步骤与前述系统一致。

6. 手动启动与管理（可选）

# 启动服务
openclaw gateway start
# 查看状态
openclaw status
# 重启服务
openclaw gateway restart

7. 设置开机自启（可选）

运行初始化向导时选择安装守护进程，或执行：

openclaw gateway enable

8. 健康检查（重要）

openclaw doctor

9. 获取 WebUI 访问令牌（如需）

openclaw token generate

10. 配置文件位置

Linux 配置文件通常位于：

~/.openclaw/openclaw.json

🤖 配置大模型API（以阿里云百炼为例）

1. 获取API Key

登录阿里云百炼控制台，在“密钥管理”页面创建并复制你的API Key。

2. 使用命令行配置（推荐）

避免手动编辑配置文件，使用 openclaw config 命令进行配置：

# 设置默认模型的提供商为百炼
openclaw config set agents.defaults.model.provider "bailian"
# 设置模型名称（可根据实际替换）
openclaw config set agents.defaults.model.model_id "qwen-max"
# 设置 API Key
openclaw config set models.providers.bailian.api_key "你的API Key"
# 设置 API 基础地址（兼容 OpenAI 格式）
openclaw config set models.providers.bailian.base_url "https://dashscope.aliyuncs.com/compatible-mode/v1"

3. 重启服务

openclaw gateway restart

重启后，即可在 WebUI 中体验完整的 AI 自动化功能。

💡 常见问题与提示

  • 权限错误：在 Linux/macOS 上，若全局安装失败，可尝试在命令前加 sudo。
  • 安装缓慢或失败：确保已配置 npm 国内镜像源；若仍失败，可改用 pnpm 安装： 
    npm install -g pnpm
pnpm install -g openclaw@latest
  • 端口占用：默认端口为 18789。若被占用，可在配置文件 openclaw.json 中修改 port 字段。
  • 安全警告：OpenClaw 需要文件读写权限。请勿在存有敏感信息的生产环境根目录下运行，建议指定专用工作区。
  • 配置未生效：修改配置文件后，必须执行 openclaw gateway restart 重启服务。
  • WebUI 无法访问：确认服务已启动（openclaw status），并检查防火墙设置。若提示需要令牌，使用 openclaw token generate 生成。

✅ 验证部署

完成上述步骤后，可以通过以下方式确认部署成功：

  1. 浏览器访问 http://localhost:18789，进入 WebUI。
  2. 在 WebUI 中尝试执行一个简单任务（如“列出当前目录文件”）。
  3. 运行 openclaw doctor 确保所有检查项通过。
avatar
文章
阅读
粉丝