大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



文档更新：2026-03-07

---

• 一、OpenClaw 简介
  • 1.1 项目概述
  • 1.2 核心特点
  • 1.3 主要功能
  • 1.4 技术架构
  • 1.5 发展简史
• 二、部署方式与运行环境
  • 2.1 本地部署
  • 2.2 云端部署
  • 2.3 小结
• 三、所需凭证与依赖
  • 3.1 必需：大模型 API Key
  • 3.2 可选：聊天平台 Token
  • 3.3 运行环境
• 四、推荐方案：Ubuntu 虚拟机
  • 4.1 为何首选 Ubuntu
  • 4.2 系统方案对比
  • 4.3 虚拟机推荐配置
  • 4.4 核心前提与安全建议
• 五、WSL2 图形界面（可选）
  • 5.1 方案一：WSLg（Windows 11）
  • 5.2 方案二：Xrdp 远程桌面
  • 5.3 方案三：X11 转发
  • 5.4 与 OpenClaw 的搭配建议
• 六、Ubuntu/Linux 本机直接部署（脚本与实战）
  • 6.1 适用场景与脚本说明
  • 6.2 一键脚本部署
  • 6.3 配置向导步骤说明（实战）
  • 6.4 启动 Gateway 与访问控制台
  • 6.5 root 下 systemd 不可用：改为系统服务
• 七、VirtualBox + Windows 从零部署
  • 7.1 准备工作
  • 7.2 创建 Ubuntu 虚拟机
  • 7.3 配置 Ubuntu 基础环境
  • 7.4 安装 OpenClaw
  • 7.5 初始化配置
  • 7.6 访问 Web 控制台
  • 7.7 从 Windows 主机访问虚拟机内的 OpenClaw（NAT + 端口转发）
• 八、常见问题与后续配置
  • 8.1 常见问题排查
  • 8.2 后续步骤
• 九、安全提醒
• 十、补充说明与参考
  • 9.1 官方资源与参考链接
  • 9.2 其他安装方式
  • 9.3 配置与数据目录
  • 9.4 Linux 常驻运行（systemd）
  • 9.5 常用命令速查
  • 9.6 网络与代理（国内用户）
  • 9.7 安装脚本安全提示
  • 9.8 文档内附脚本说明

---

1.1 项目概述

OpenClaw（曾用名 Clawdbot、Moltbot）是一个开源的、可自托管的 AI 智能体/数字员工平台。它如同一个「有手脚的 AI 管家」，能理解自然语言，并直接在您的电脑或服务器上执行真实任务，如读写文件、运行脚本、收发邮件、操作浏览器等。

1.2 核心特点

• 开源与本地优先：项目采用 MIT 协议，代码开放。支持在个人电脑或私有服务器上部署，数据和配置由用户掌控，保障隐私安全。
• 多模型兼容：可接入 Claude、GPT、通义千问、DeepSeek 等多种大语言模型，也支持本地模型。
• 多渠道接入：能通过 WhatsApp、Telegram、Slack、Discord 及企业微信、钉钉等聊天工具接收指令，无需安装独立 App。
• 技能插件化 (Skills)：通过「技能」扩展功能，官方和社区已提供数千个插件，覆盖办公、开发、运维、生活服务等领域，并支持用户自定义开发。

1.3 主要功能

• 办公自动化：自动整理邮件、生成周报、汇总文档、安排日程、跨应用同步数据。
• 开发与运维：编写/修改代码、执行脚本、自动化部署、监控系统状态、分析日志。
• 生活与内容：比价购物、自动订票、整理个人知识库、生成文章草稿、翻译内容。
• 团队协作：可作为「7×24 小时在线员工」，负责跨系统数据同步、工单处理、定时报表分发等。

1.4 技术架构

OpenClaw 的架构主要分为四层：

1.5 发展简史

• 2025 年底：项目以 Clawdbot 之名问世。
• 2026 年 1 月：因商标问题，先后更名为 Moltbot 和 OpenClaw。
• 2026 年 2 月：创始人 Peter Steinberger 加入 OpenAI，项目转为开源基金会形式运作。
• 2026 年 3 月：在国内引发「云上养虾」热潮，多家云厂商相继提供一键部署方案。

---

OpenClaw 并非完全在云端、通过网页直接操作的 SaaS 服务，其核心程序需要部署在您的电脑或服务器上运行。您可以选择以下任一方式。

2.1 本地部署

将 OpenClaw 直接安装在个人电脑（支持 Windows、macOS、Linux）上。程序需要在此设备上运行，才能执行读写文件、执行命令等操作。

2.2 云端部署

将 OpenClaw 安装在云服务器（如阿里云、腾讯云 ECS）上。云服务器在物理上仍是「一台电脑」，只是不在您身边；部分云厂商也提供了 OpenClaw 的一键部署方案。

2.3 小结

OpenClaw 不是「网页版工具」，而是一个需要您自行部署（在本地电脑或云服务器）才能使用的软件。

---

运行 OpenClaw 主要需要两类凭证，其中大模型 API Key 为必需；聊天平台 Token 为可选。此外需准备相应的运行环境。

3.1 必需：大模型 API Key

OpenClaw 本身是「调度大脑」，不自带大模型，因此必须接入至少一家大模型服务商的 API 才能工作。可选方案包括：

国内常用模型：

• 通义千问 (Qwen / 阿里云百炼)：推荐直接按阿里云官方教程配置，包含开通百炼、获取 API Key、在 OpenClaw 中配置 Base URL / 模型及默认模型等完整步骤：
  OpenClaw 接入阿里云百炼（通义千问）
  要点：在 OpenClaw 中 provider 名为 ，Base URL 按地域选（北京为 ），模型 ID 如 、，需设置 ，默认模型在 中设为 等；支持 Web 控制台配置与直接编辑 两种方式。
  
  
  
  
  
• MiniMax：在其官网开通 Coding Plan 后获取 API Key。
• Kimi、DeepSeek：在各自开放平台注册并创建应用以获取 Key。

海外常用模型：

• OpenAI GPT：获取其 API Key。
• Anthropic Claude：获取其 API Key。

免费/低成本方案：

• 可使用讯飞星辰 MaaS 平台提供的免费 Token 计划，或阿里云百炼的新用户免费额度。

3.2 可选：聊天平台 Token

若希望通过特定聊天工具（如飞书、钉钉、企业微信、Telegram 等）与 OpenClaw 互动，需为相应平台创建机器人并获取凭证。这些并非运行 OpenClaw 的硬性要求。

3.3 运行环境

• 本地部署：一台电脑（Windows/macOS/Linux），并安装 Node.js 22+、Git 等依赖。
• 云端部署：一台云服务器及登录账号。

---

在虚拟机中运行 OpenClaw 是当前非常主流且推荐的做法：与主力系统隔离，安全性更高。对于环境搭建，首选 Ubuntu 虚拟机，其支持度、稳定性和社区资源都优于 Windows 原生环境。

4.1 为何首选 Ubuntu

1. 官方主力支持：OpenClaw 的官方安装脚本主要针对 Linux/macOS 设计。在 Windows 上，官方也推荐使用 WSL2（本质是在 Windows 内运行 Ubuntu 环境），说明开发团队的主要支持方向是 Linux 系。
2. 社区方案统一：目前中英文社区中最主流、文档最齐全的教程几乎都基于 Ubuntu，包括在云上部署、使用 VirtualBox/VMware 创建虚拟机或 Docker 部署。
3. 兼容性与稳定性更佳：OpenClaw 基于 Node.js 生态，许多依赖和脚本为 Unix/Linux 环境编写。在原生 Windows 上常会遇到路径、权限、脚本执行失败等问题；在 Ubuntu 中这些问题会大幅减少，安装过程更接近官方文档描述。

4.2 系统方案对比

4.3 虚拟机推荐配置

以在本地电脑的 VMware 或 VirtualBox 中运行 Ubuntu 为例，稳妥配置如下：

• 系统：Ubuntu 22.04/24.04 LTS（桌面版或服务器版均可）
• CPU：2～4 核（宿主机性能充足时可分配更多）
• 内存：至少 4GB，推荐 8GB 以保证流畅运行
• 磁盘：至少 40～60GB，为系统和后续文件留出空间

推荐部署路径简述：

1. 在 Windows 上使用 VirtualBox 或 VMware 创建 Ubuntu 22.04/24.04 LTS 虚拟机。
2. 为虚拟机分配至少 4GB 内存和 40GB 硬盘空间。
3. 在 Ubuntu 内打开终端，执行官方一键安装：
4. 按提示完成初始化配置。

4.4 核心前提与安全建议

在虚拟机中运行仍需满足：

1. 网络通畅：虚拟机需能访问互联网，以下载依赖、连接大模型 API 和聊天平台。
2. API Key：仍需提供大模型服务（如通义千问、OpenAI、Kimi 等）的 API Key。虚拟机仅提供隔离环境，不替代对 Key 的需求。

安全建议：将 OpenClaw 置于虚拟机中是一种安全实践，因其具备读写文件和执行系统命令的权限；隔离可有效降低对主力电脑的影响。

---

若使用 WSL2 而非独立虚拟机，WSL2 中的 Ubuntu 默认无图形界面，仅命令行。可通过以下方式为其添加图形界面。

5.1 方案一：WSLg（Windows 11）

Windows 11 的 WSL2 内置 WSLg，可直接运行 Linux 图形应用，无需额外配置 X 服务器。

1. 确认环境：系统为 Windows 11，且 WSL 版本 ≥ 0.50.0。
2. 安装桌面：在 Ubuntu 终端中安装轻量桌面，如 Xfce：

3. 启动桌面：执行 ，即可在当前窗口中弹出 Xfce 桌面。

5.2 方案二：Xrdp 远程桌面

适用于 Windows ¹⁰⁄₁₁，通过「远程桌面连接」访问 Ubuntu 桌面。

1. 安装桌面与 Xrdp：

2. 配置 Xrdp：将默认桌面设为 Xfce，并修改端口（避免与 Windows 远程桌面冲突）：

3. 连接：在 Windows 打开「远程桌面连接」(mstsc)，地址输入 ，使用 Ubuntu 用户名和密码登录。

5.3 方案三：X11 转发

仅需运行单个图形程序（如 gedit、xclock）时可使用。

1. Windows 端：安装并运行 X 服务器（如 VcXsrv 或 Xming）。
2. Ubuntu 端：安装图形应用并设置 ：

3. 启动 X 服务器后，在 Ubuntu 终端运行如 等程序，窗口将显示在 Windows 桌面上。

5.4 与 OpenClaw 的搭配建议

• 首选：在 Ubuntu 虚拟机中安装完整桌面，最稳定、最接近原生 Linux，教程资源也最丰富。
• 备选：若坚持使用 WSL2，可采用 WSLg + Xfce 组合，比 Xrdp 更轻量，能满足 OpenClaw 类应用的运行需求。

---

本节基于在 Ubuntu 本机（含以 root 运行）的实战整理：使用本文档提供的一键脚本解决国内网络下 NodeSource 连不上的问题，并说明配置向导中常见选项、root 下 systemd 用户服务不可用时的替代方案。

6.1 适用场景与脚本说明

• 适用：已是 Ubuntu 或其他 Linux，不想用虚拟机，直接在本机装 OpenClaw。
• 国内网络：若使用 NodeSource（）安装 Node.js 时出现「连接被拒绝」，可用本文档 6.2 节的 nvm + 国内镜像 一键脚本。
• 本文档内置的脚本（见 9.8 文档内附脚本说明）：
  • 一键部署脚本：安装系统依赖、nvm、Node 22、OpenClaw 官方安装脚本（见 6.2 下方完整脚本）。
  • Gateway 系统服务脚本与 unit：在 root 下让 Gateway 以 systemd 系统服务 后台运行（见 6.5 下方完整内容）。

6.2 一键脚本部署

1. 若之前用过 NodeSource 且安装失败，可先移除其源（可选）：

2. 将下面「一键部署脚本」保存为 ，在终端执行（会请求 sudo 密码）：

脚本会依次：安装系统依赖（curl、git、build-essential）→ 用 nvm + 国内镜像 安装 Node.js 22（避免直连 NodeSource）→ 配置 npm 镜像 → 执行官方 。遇到安全免责声明时输入 并回车。

一键部署脚本（复制整段保存为 ）：

3. 若提示找不到 命令：

6.3 配置向导步骤说明（实战）

执行 后，按提示操作即可，以下为实战中常见选项说明：

• 若向导中途退出：重新执行 即可，已有配置会保留。
• Skills 依赖安装失败（如 github 提示 brew not installed）：可忽略，选 No 跳过技能配置；或在 Ubuntu 上需要时手动 等，再通过配置启用对应技能。

6.4 启动 Gateway 与访问控制台

• 以 root 或未配置 systemd 用户服务时：向导会提示「Systemd user services are unavailable」，不会自动安装后台服务，需要手动启动 Gateway：

  保持该终端不关，再用浏览器打开向导最后给出的链接（带 token 的 ）。

• Health check failed / Gateway: not detected：说明此时 Gateway 未在运行，先执行上面命令启动后再访问控制台。
• 未配置大模型 API Key 时：打开控制台发消息会报错 （默认模型为 Claude）。解决：运行 在向导里添加一个模型提供商并填 Key，或执行 按提示配置；配置后无需重启 Gateway 即可使用。

6.5 root 下 systemd 不可用：改为系统服务

在以 root 运行的环境中，systemd 用户服务不可用，向导会跳过「安装守护进程」。若希望 Gateway 开机自启、后台常驻，可改用 systemd 系统服务。按下面步骤操作即可（脚本与 unit 均写在本文档中，无需额外文件）。

1. 保存启动脚本

将下面整段保存为 ，然后复制到 root 家目录并赋予执行权限：

执行（请把 换成你保存脚本的目录）：

2. 保存 systemd 服务单元

将下面整段保存为 ，然后复制到 systemd 目录：

执行（请把 换成你保存 unit 的目录）：

3. 检查状态

若显示 ，则 Gateway 已在后台运行。用浏览器打开之前的控制台链接（带 token 的 ）即可使用。

4. 常用命令

5. 若启动失败

• 先确认手动能跑：在 root 终端执行 ，能起来再试服务。
• 看日志：
• 若报错「未找到 openclaw」：编辑 ，把 改成你本机 的绝对路径，例如：
  （将 换成 显示的实际版本。）

---

以下引导您使用 VirtualBox 在 Windows 上从零部署 OpenClaw，请按步骤操作。

7.1 准备工作

1. VirtualBox 7.x

• 前往官网 https://www.virtualbox.org/ 下载并安装。
• 安装时按默认选项「下一步」即可。

2. Ubuntu 22.04/24.04 镜像

• 建议从国内镜像站下载，例如：
  • 中科大：https://mirrors.ustc.edu.cn/ubuntu-releases/24.04/ubuntu-24.04.3-desktop-amd64.iso
  • 清华：https://mirrors.tuna.tsinghua.edu.cn/ubuntu-cdimage/releases/24.04.4/release/
• 下载 备用。

3. 主机 BIOS 设置

• 重启进入 BIOS，开启虚拟化技术（Intel VT-x / AMD-V），保存并退出，否则虚拟机可能无法正常启动。

7.2 创建 Ubuntu 虚拟机

1. 新建虚拟机：打开 VirtualBox →「新建」。名称填 ，类型选 Linux，版本选 Ubuntu (64-bit)，下一步。
2. 分配内存：最低 4GB，推荐 8GB（主机内存 ≥ 16GB 时），下一步。
3. 创建虚拟硬盘：选择「创建虚拟硬盘」，类型默认 VDI，存储方式选「动态分配」，大小至少 40GB（推荐 60GB 以上），创建。
4. 挂载镜像：选中该虚拟机 →「设置」→「存储」→ 在「控制器: IDE」下点击光盘图标 →「选择虚拟光盘文件」→ 选中下载的 Ubuntu ISO，确定。
5. 配置网络：「设置」→「网络」→ 连接方式选 桥接网卡 (Bridged Adapter)，以便虚拟机获得与主机同网段的 IP，确定。
6. 安装 Ubuntu：启动虚拟机 → 引导菜单选「Try or install Ubuntu」→ 安装向导选「正常安装」，时区选「上海」，磁盘选「清除整个磁盘并安装 Ubuntu」→ 设置用户名和密码（请牢记）→ 等待安装完成并重启，登录进入桌面。

7.3 配置 Ubuntu 基础环境

1. 更新系统并安装基础工具

2. 安装 Node.js 22+

验证版本（应为 v22.x.x）：

3.（可选）配置国内 NPM 镜像

若使用 NodeSource 时出现「无法连接 deb.nodesource.com」，可改用 6.2 一键脚本部署 中的 nvm + 国内镜像方式安装 Node（将脚本在虚拟机内执行即可）。

7.4 安装 OpenClaw

1. 执行一键安装

在终端中以普通用户（非 root）执行：

遇到安全免责声明时，输入 并回车继续。

2. 验证安装

若提示 ，将 npm 全局目录加入 PATH 后重试：

（若安装脚本提示了其他路径，请以实际路径为准。）

7.5 初始化配置

执行配置向导并安装守护进程（便于开机自启）：

按终端提示依次完成：

• 安全警告：输入 确认。
• 安装模式：选 （快速开始）。
• 模型提供商：根据已有 API Key 选择（如 通义千问、 等）；暂无 Key 可先选 ，后续再配。
• 配置模型（未跳过时）：填写 、、。
• 消息渠道：可先选 ，后续再配置飞书、Web 等。
• Skills：选 ，后续按需安装。
• Hooks：选 。
• 完成后向导会自动安装依赖并启动 Gateway 服务。

7.6 访问 Web 控制台

1. 获取链接和 Token

终端会输出形如 的 URL。

2. 在虚拟机内访问

在 Ubuntu 的 Firefox 或 Chrome 中打开上述链接，即可看到 OpenClaw 聊天界面。

3. 从 Windows 主机访问

• 虚拟机使用桥接网卡（Bridged）时：在 Ubuntu 执行 或 查看虚拟机 IP，在 Windows 浏览器打开 ；若无法访问，在 Ubuntu 中执行 放行端口。
• 虚拟机使用 NAT（网络地址转换）时：需完成 Gateway 监听地址、端口转发与设备配对，详见 7.7 从 Windows 主机访问（NAT + 端口转发）。

7.7 从 Windows 主机访问虚拟机内的 OpenClaw（NAT + 端口转发）

当虚拟机网络为 NAT 时，需完成以下步骤方可在 Windows 浏览器中访问虚拟机内的 OpenClaw 控制台。

1. 让 Gateway 监听所有网卡

默认 Gateway 只监听本机（loopback），外部无法连接。在 虚拟机内打开 OpenClaw 控制台（或先在本机浏览器访问一次），在 Gateway 设置 中找到 Gateway Bind Mode（Network bind profile）：

• 将 或 改为 （推荐），保存后重启 Gateway（手动启动则重新执行 ；若为 systemd 服务则 ）。
• 若选择 ，必须同时设置 Custom Bind Host 为 ，否则会报错 。

2. 配置 VirtualBox 端口转发

• 在 Windows 上关闭该 Ubuntu 虚拟机（完全关机）。
• 打开 VirtualBox → 选中该虚拟机 → 设置 → 网络 → 网卡 1，确认连接方式为 NAT。
• 展开 高级 → 端口转发，添加一条规则：
  • 协议：TCP
  • 主机端口：18789
  • 子系统端口：18789
  • 主机 IP / 子系统 IP 可留空。
• 确定后启动虚拟机。

3. 获取带 Token 的链接

在 Ubuntu 虚拟机终端执行：

复制输出的链接（形如 ），在 Windows 浏览器中打开时保持使用 （不要改成虚拟机 IP），即：。

4. 若出现「已断开与网关的连接 / pairing required」

从 Windows 访问会被视为新设备，需在虚拟机内先批准该设备：

批准后在 Windows 浏览器中刷新页面即可正常连接。

5. 可选：放行防火墙

若仍无法访问，在 Ubuntu 中执行：

---

8.1 常见问题排查

8.2 后续步骤

• 接入通义千问（阿里云百炼）：按阿里云官方教程操作即可：OpenClaw 接入阿里云百炼（含 Web 控制台与配置文件两种配置方式、默认模型与切换说明）。
• 接入飞书：在 Web 控制台或执行 ，按引导完成飞书应用创建与权限配置。
• 切换模型：编辑 中的 或 部分，改为目标模型（如 ）后重启 Gateway。

---

OpenClaw 通常需要较高系统权限，配置不当或暴露于公网可能带来安全风险。建议：

• 避免不必要的公网暴露。
• 严格控制访问权限和 API 密钥。
• 及时更新和加固系统。

---

9.1 官方资源与参考链接

部署与排错时建议以官方文档为准，便于获取最新要求与变更：

• 官方文档：https://docs.openclaw.ai/
• 入门指南：https://docs.openclaw.ai/getting-started
• 安装与要求：https://docs.openclaw.ai/install（含各平台说明）;
• 一键安装脚本：https://openclaw.ai/install.sh（Linux/macOS）;

文档中的安装命令、端口（默认 18789）、配置路径等均与官方一致，若遇不一致请以官方当前说明为准。

9.2 其他安装方式

除文档中的一键脚本外，还可按需选择：

• npm 全局安装（需已安装 Node.js 22+）：

• Windows 原生：若在 Windows 上不采用 WSL/虚拟机，可使用官方 PowerShell 安装脚本（以管理员身份运行 PowerShell 后执行）：

• Docker：官方支持通过 Docker 进行容器化部署及沙箱化 Skills，详见官方 Docker 安装文档。

9.3 配置与数据目录

自定义配置与数据集中在用户目录下，便于备份和迁移：

修改配置后一般需重启 Gateway：。

9.4 Linux 常驻运行（systemd）

• 普通用户：OpenClaw 通过 systemd 用户服务运行。若希望登出后仍保持运行，可启用「linger」：

  完成后无需保持登录，Gateway 也会在后台持续运行。

• root 用户：用户级 systemd 对 root 不可用，向导不会安装守护进程。若需开机自启与后台常驻，请使用 systemd 系统服务：本文档 6.5 中写明了 与 的完整内容及安装步骤，按说明保存并启用即可。

9.5 常用命令速查

9.6 网络与代理（国内用户）

若部署环境在国内，可能遇到：

• 访问 openclaw.ai / 官方安装脚本：若无法直连，需在终端配置 HTTP/HTTPS 代理后再执行 。
• npm 安装依赖：文档中已建议配置国内镜像（如 ），可减少超时与失败。
• 大模型 API：选用国内可访问的模型（如通义、DeepSeek、Kimi 等）并填写正确的 （若厂商要求），避免 Gateway 连不上模型。

以上仅为常见情况，具体以本机网络与所用模型服务商为准。

9.7 安装脚本安全提示

执行「一键安装」前建议注意：

• 脚本会从互联网下载并执行代码，请确保来源可信（官方域名：openclaw.ai）。
• 若希望先审阅再执行，可先下载脚本查看内容后再决定是否运行：

• 安装过程会写入 、npm 全局包等，建议在虚拟机或专用环境中操作，避免与主力系统混用。

9.8 文档内附脚本说明

为便于仅凭本文档即可完成部署，脚本与 systemd 内容已全部写在正文中，无需单独下载文件：

使用顺序建议：先用 6.2 的一键脚本完成安装与 ；若以 root 运行且希望 Gateway 常驻，再按 6.5 配置系统服务。

---

以上内容供本地部署参考，请以官方文档及实际环境为准。