Windows 11 高性能方案部署 OpenClaw（小龙虾）完整教程

一步到位的高性能虚拟机部署指南。
基于 Windows 11 专业版 + Hyper-V + Ubuntu 22.04 LTS，成功实践整理。
为了最佳性能，采用win11自带的hyper-v技术。为了安全性和生态，部署在Ubuntu虚拟机。为了方便管理使用nvm和pnpm进行管理。

📖 目录

  1. 准备工作
  2. 创建 Ubuntu 22.04 虚拟机
  3. 虚拟机基础配置（SSH + 网络）
  4. 安装 Node.js 环境（nvm + pnpm）
  5. 部署 OpenClaw
  6. 防火墙与端口放行
  7. 局域网访问配置
  8. 日常使用与管理
  9. 常见问题排查

1. 准备工作

  • 硬件与系统要求：Windows 11 专业版/企业版/教育版（家庭版不支持 Hyper-V）；CPU 支持虚拟化（Intel VT-x 或 AMD-V），BIOS 中需开启；至少 8GB 内存（推荐 16GB，为虚拟机预留 4GB）；至少 40GB 可用磁盘空间。
  • 下载 Ubuntu 22.04 LTS 镜像：为什么选 22.04 LTS？24.04 在 Hyper-V 的 SSH 服务和 systemd 用户服务上有已知兼容问题，22.04 LTS 稳定、文档多，支持到 2027 年。阿里云镜像：https://mirrors.aliyun.com/ubuntu-releases/22.04.5/，选择 ubuntu-22.04.5-desktop-amd64.iso（约 5.2 GB）。小白选desktop即可，大佬可以追求性能选server版本
  • 启用 Hyper-V 功能：打开 控制面板 → 程序 → 启用或关闭 Windows 功能 → 勾选 Hyper-V → 确定，重启电脑。

2. 创建 Ubuntu 22.04 虚拟机

  1. 新建虚拟机：打开 Hyper-V 管理器 → 新建 → 虚拟机 → 指定名称（如 Ubuntu-22.04-OpenClaw）。
  2. ⚠️ 代数：务必选择“第二代”：为什么？第二代虚拟机支持 UEFI 引导、安全启动、更大的内存和更快的虚拟设备，性能更好。
  3. 内存：至少 4096 MB，勾选 “使用动态内存”：为什么？动态内存让虚拟机按需使用内存，宿主机压力更小。
  4. 网络：暂时选 默认交换机（后续会改为外部交换机）。
  5. 虚拟硬盘：创建新硬盘，大小设为 40GB 以上（推荐 60GB）：为什么？OpenClaw 及依赖会占用几 GB，留足空间避免后期扩容麻烦。
  6. 安装选项：选择“从可启动的映像文件安装操作系统”，浏览选中下载的 Ubuntu ISO 文件。
  7. 关闭安全启动：创建完成后，不要立即启动虚拟机 → 右键虚拟机 → 设置 → 安全 → 取消勾选“启用安全启动”。为什么？Ubuntu 22.04 默认不支持 Hyper-V 的 Microsoft 安全启动证书，不关闭会导致无法引导。
  8. 安装 Ubuntu 系统：点击“启动” → 按提示安装（语言：English，键盘布局：默认，安装类型：清除整个磁盘并安装 Ubuntu，设置用户名和强密码，建议勾选 “安装 OpenSSH server”）。重启后若提示“移除安装介质”，在 “媒体” → “DVD 驱动器” → “弹出”。

3. 虚拟机基础配置（SSH + 网络）

为了性能通过命令行调试服务器，小白可以跳过ssh这一步，但依旧要配置网络和端口，这样局域网里设备才可以通过网页访问。

3.1 安装并启动 SSH 服务

sudo apt update && sudo apt install openssh-server -y
sudo systemctl enable --now ssh
sudo systemctl status ssh   # 应显示 active (running)

SSH 让你可以用 Windows 上的 WindTerm/PowerShell 连接虚拟机，之后所有操作都可以复制粘贴，不用在 Hyper‑V 窗口里受苦。配置好ssh链接后可以不用连接图形化界面，节约性能。

3.2 配置 Hyper-V 外部虚拟交换机

原理：Hyper-V 默认的“默认交换机”是 NAT 模式，虚拟机 IP 是 172.x.x.x，只有宿主机能访问。改成 “外部” 桥接模式后，虚拟机会直接从你的路由器获取 IP，与宿主机同一网段（如 192.168.1.x）。

操作步骤：

  1. 在 Windows 宿主机上打开 Hyper-V 管理器 → 虚拟交换机管理器。
  2. 新建虚拟网络交换机 → 类型选择 “外部” → 创建。
    • 名称：External Switch
    • 外部网络：选择当前上网的物理网卡（有线选以太网，无线选 Wi-Fi）。
    • 务必勾选“允许管理操作系统共享此网络适配器”：不勾选的话，你的 Windows 宿主机自己会断网！
  3. 点击“确定”。
  4. 关闭 Ubuntu 虚拟机 → 在虚拟机“设置” → “网络适配器” → 将虚拟交换机改为 External Switch → 重新启动虚拟机。
  5. ⚠️ 获取虚拟机 IP：在 Ubuntu 终端中 ip addr，找到 eth0 接口下的 inet 地址（如 192.168.1.123）。如果是 172.x.x.x 说明仍在使用 NAT 模式，重新检查上一步。
  6. 从宿主机 SSH 连接（验证）：在 Windows 上打开 PowerShell 或 WindTerm：ssh 你的用户名@虚拟机IP。

4. 安装 Node.js 环境（nvm + pnpm）

为了方便项目环境管理，使用了nvm来管理node版本，若您已安装nodejs 22以上的版本，可以跳过这一步。
⚠️ 重要：以下全部操作请使用你的普通用户，不要切换到 root！
OpenClaw 使用 systemd 用户服务管理进程，root 环境下 D‑Bus 无法正常连接，会导致服务安装失败。

  1. 安装 nvm：为什么用 nvm？可以轻松切换 Node.js 版本。

    curl -o- https://gitee.com/mirrors/nvm/raw/v0.39.7/install.sh | bash
source ~/.bashrc && nvm --version

  2. 安装 Node.js v22：为什么选v22 因为OpenClaw 要求 Node.js ≥ 22，v22 是当前 LTS 候选，稳定可靠。

    nvm install 22 
nvm use 22 
nvm alias default 22  
node --version   # 应显示 v22.x.x

  3. 安装 pnpm 并配置镜像：为什么用 pnpm？全局安装速度更快，磁盘占用更小，官方推荐。淘宝镜像可避免从国外 npm 源下载时超时。

    npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com
pnpm --version

  4. 将 pnpm 全局 bin 目录加入 PATH：为什么？pnpm 全局安装的可执行文件默认放在 ~/.local/share/pnpm/bin，必须加入 PATH 才能直接在终端调用 openclaw 命令。

    echo 'export PATH="$HOME/.local/share/pnpm/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

5. 部署 OpenClaw

OpenClaw 本身不内置任何 AI 模型，需要用户对接一个“大脑”（大模型 API）。它的核心价值在于将 LLM 的思考能力转化为电脑的实际操作，因此模型的选择直接决定了其效果和成本。

5.1 全局安装 OpenClaw

pnpm add -g openclaw@latest

⚠️ 关键操作：安装过程中会出现一个蓝色背景的交互界面，让你选择哪些包需要编译（koffi、openclaw、protobufjs、tree-sitter-bash）。直接按键盘上的 a 键（全选），然后按 回车键。为什么？全选可以确保所有原生模块都被编译，避免后续某些功能因缺少依赖而报错。

5.2 运行初始化向导

openclaw onboard

AI 模型提供商选择（附解释）：

提供商 特点 免费额度/价格 适用场景
Qwen (通义千问) - 推荐 阿里云出品，中文理解极佳，综合性能均衡 新用户开通百炼平台，享各模型100万输入+100万输出 Token 免费额度，总免费额度超 7000 万 Token 日常对话、文档处理、中等复杂度任务，最适合新手起步
DeepSeek 擅长代码生成与复杂推理，逻辑能力强 官方 API 按量付费，起价 $0.14/M tokens；国家超算平台曾限时免费开放 编程辅助、技术问题、逻辑推理任务
Kimi (Moonshot) 月之暗面出品，支持超长上下文，推理能力强 部分版本有免费试用 长文档分析、复杂推理、通用对话
GLM (智谱) 智谱 AI 出品，7440亿参数开源旗舰，智能体能力优秀 API 成本较低，输入成本约为 Claude Opus 的 1/6 代码开发、复杂工具调用、大规模文本处理
MiniMax 推理速度极快，100 TPS 有免费试用 快速文本处理、全栈编程、轻量智能体任务
Together AI 统一 API，整合 Llama、DeepSeek、Kimi 等多种模型 根据所选模型计费 需要灵活切换多种模型的场景
Venice AI 隐私优先推理 提供免费层级 注重数据隐私的场景

根据自己开通的api自行选择即可，后续openclaw内可以支持各大模型的api接口。

5.3 验证服务状态

openclaw gateway status

应显示 Gateway is running。如果提示未运行，可以手动启动：openclaw gateway start。

6. 防火墙与端口放行

👾第5步完成后，龙虾已经在你的虚拟机服务器里部署好了，后续这些内容你可以直接把要求发给龙虾让它替你干哦！👾

OpenClaw 默认使用 18789 端口。

  1. 放行 18789 端口：为什么？ufw 是 Ubuntu 默认防火墙，默认可能未开启，但为了安全我们手动放行指定端口。

    sudo ufw allow 18789/tcp && sudo ufw reload

  2. （可选）限制访问来源 IP：如果只想让局域网内某台特定电脑访问：

    sudo ufw allow from 192.168.1.50 to any port 18789 proto tcp

  3. 查看防火墙状态：sudo ufw status verbose

7. 局域网访问配置

  1. 确保虚拟机 IP 与宿主机同网段：使用第 3.2 步配置的 外部虚拟交换机 后，虚拟机 IP 应该是 192.168.x.x 或 10.x.x.x。如果仍是 172.x.x.x，请检查外部交换机配置。

  2. 修改 OpenClaw 绑定地址：为什么？默认监听 127.0.0.1，外部无法访问，需改为监听所有网络接口。

    nano ~/.openclaw/openclaw.json

    找到 gateway 部分，将 "bind" 字段从 "loopback" 改为 "lan"：

    "gateway": { "bind": "lan", ... }

    保存退出，重启服务：openclaw gateway restart。

  3. 从其他设备访问 Web UI：http://虚拟机IP:18789/

8. 日常使用与管理

操作 命令
查看服务状态 openclaw gateway status
重启服务 openclaw gateway restart
停止服务 openclaw gateway stop
查看实时日志 openclaw gateway logs
终端聊天（TUI） openclaw tui
安全深度审计 openclaw security audit --deep
启用开机自启 sudo loginctl enable-linger $USER：什么是 lingering？默认用户注销后，systemd 会杀死该用户的所有进程。开启 lingering 后，即使没有登录，用户服务也会保持运行。
更新 OpenClaw pnpm add -g openclaw@latest → openclaw gateway restart

9. 常见问题排查

问题现象 原因分析 解决方案
❌ SSH 连接提示 Connection refused SSH 服务未安装或未启动。 在虚拟机终端 sudo systemctl start ssh。
❌ openclaw 命令找不到 pnpm 全局 bin 目录不在 PATH 中。 echo 'export PATH="$HOME/.local/share/pnpm/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc。
❌ 安装时出现蓝色选择界面不知按什么 pnpm 需要选择要编译的模块。 直接按 a 键（全选），然后按回车。
❌ systemd 服务安装失败：传输端点尚未连接 使用了 root 用户。OpenClaw 的 systemd 用户服务需要普通用户的 D‑Bus 会话。 必须切换到普通用户重新执行安装和配置。
❌ 局域网其他设备无法访问 Web UI ① 防火墙未放行；② OpenClaw 绑定地址未改为 lan；③ 网络模式未正确配置。 ① sudo ufw allow 18789/tcp；② 修改 openclaw.json 中 bind 为 "lan"；③ 检查外部交换机配置，确保虚拟机 IP 与宿主机同网段。
❌ 虚拟机 IP 一直是 172.x.x.x 未正确使用外部虚拟交换机。 回到第 3.2 步，删除旧的网络适配器，添加 外部交换机，重启虚拟机。
❌ 资源占用高，性能差 分配给虚拟机的资源不足。 在 Hyper-V 设置中增加虚拟机的内存、CPU 核心；启用动态内存。
❌ 运行时网络卡顿 虚拟网络配置问题。 优化虚拟交换机配置，调整 RSC 和 VMQ 等高级设置；若用 Wi-Fi 桥接不稳定，可改用 NAT 模式 + 端口转发。
❌ Qwen API Key 无效或余额不足 API Key 未正确申请、过期或余额不足。 访问 阿里云百炼平台 重新申请；检查 API Key 是否输入正确；登录控制台查看免费额度使用情况。
❌ 想换个大模型试试 OpenClaw 本身不内置模型，需用户自行配置。 重新运行 openclaw onboard 选择不同的模型提供商；或直接修改 ~/.openclaw/openclaw.json 中的 providers 配置。

附录：一键部署脚本（可选）

将以下内容保存为 deploy-openclaw.sh，在 Ubuntu 普通用户下执行：

#!/bin/bash
# OpenClaw 一键部署脚本 (Ubuntu 22.04 LTS)

set -e

echo "=== 1. 更新系统并安装基础工具 ==="
sudo apt update && sudo apt install -y curl git build-essential

echo "=== 2. 安装 nvm ==="
curl -o- https://gitee.com/mirrors/nvm/raw/v0.39.7/install.sh | bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
source ~/.bashrc

echo "=== 3. 安装 Node.js 22 ==="
nvm install 22 && nvm use 22 && nvm alias default 22

echo "=== 4. 安装 pnpm 并配置淘宝镜像 ==="
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com

echo "=== 5. 配置 PATH ==="
echo 'export PATH="$HOME/.local/share/pnpm/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

echo "=== 6. 安装 OpenClaw（自动全选构建）==="
CI=1 pnpm add -g openclaw@latest   # CI=1 环境变量避免交互式选择

echo "=== 7. 安装完成！请手动运行 openclaw onboard 初始化 ==="

运行方式：

chmod +x deploy-openclaw.sh
./deploy-openclaw.sh

⚠️ 一键脚本仅安装环境，仍需要手动运行 openclaw onboard 完成 AI 模型配置。

最后给你们介绍下我配置的小龙虾，名字叫巴巴塔👾，英文名叫Vex👾，酷吗？

我让他叫我银河领主呢。

# 人工智能 # ssh # 运维开发 # linux # ubuntu
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

天心大师漫谈热爱生命，乡土文学视角下AI赋能传统金鱼养殖的哲思实践

avatar AtomGit开源社区
cover

影刀RPA跨境店群运营架构：Python协同Chromium底层调度与高并发容器化架构实战

avatar AtomGit开源社区
cover

【扩散模型系列·第一篇】扩散模型是什么：从加噪到去噪的直觉，以及为什么它能打败 GAN

avatar AtomGit开源社区