手把手教你在 Windows 主机直接安装龙虾 OpenClaw，保姆级教程（附图）

在 Windows 系统上直接部署龙虾（OpenClaw）是一种灵活且高效的方式，其最大优势在于可以直接访问和控制本机资源，包括文件系统、进程管理及本地软件调用等，从而充分发挥 AI Agent 的能力。无需服务器也能拥有专属龙虾 AI 助手，让 AI 帮你管理或操作本地电脑。

安全提示： 出于安全考虑，强烈建议使用一台独立的专用电脑来部署龙虾服务，避免与日常工作环境混用，以降低潜在的安全风险。
详细教程来源于“龙虾实验室”社区（longxialab.cn）。龙虾实验室包含大量入门教程和龙虾应用资源，是个很不错的龙虾资源聚合平台。

1、下载并安装 Node.js

龙虾运行依赖 Node.js 环境，请前往 Node.js 官方网站下载最新稳定版本（LTS）：

Node.js 官方下载地址：https://nodejs.org/zh-cn/download/

https://nodejs.org/zh-cn/download/

进入下载页面后，根据您的系统架构（通常选择 Windows x64）点击下载按钮，获取安装程序。

下载完成后，双击打开安装文件，按默认方式点击 “Next” 逐步完成安装，无需修改任何默认选项。安装过程中程序会自动将 Node.js 和 npm 添加到系统环境变量中。

安装成功后，打开 CMD 命令窗口（按 Win+R，输入 cmd 回车），分别输入以下命令验证安装是否成功，正常情况下会输出对应的版本号：

node -v
npm -v

接下来安装 pnpm，这是一款高效的包管理工具，相比 npm 具有更快的安装速度和更低的磁盘占用。同时配置镜像源以提高依赖下载速度：

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

2、安装 Git Bash

由于龙虾的安装脚本依赖 Linux/Unix 风格的 Shell 指令，而 Windows 原生命令提示符（CMD）并不支持这些指令，因此我们需要借助 Git Bash 来完成安装过程。Git Bash 提供了一个完整的 Bash 模拟环境，使得在 Windows 下运行 Linux 命令成为可能。

Git Bash 官方下载地址：https://git-scm.com/download/win

https://git-scm.com/download/win

下载完成后，双击安装程序启动安装向导。重要提示： 安装过程中务必勾选 “Add Git Bash to PATH” 选项，这样才能在系统的任意位置直接调用 Git Bash 相关命令。安装完成后，请关闭所有已打开的终端窗口，然后重新打开，以确保环境变量生效。

3、安装龙虾

步骤一：下载 OpenClaw

从以下地址下载龙虾源码压缩包（如 GitHub 访问较慢，可使用 Gitee 备用地址）：

主下载地址：https://github.com/openclaw/openclaw/archive/refs/heads/main.zip

备用地址：https://gitee.com/fgai/openclaw/repository/archive/main.zip

下载完成后，将压缩包解压到本地目录。本文以解压到 D:\longxialab\openclaw 为例进行说明，您可根据实际情况选择合适的路径，建议路径中不要包含中文或空格。

步骤二：安装 OpenClaw

在 openclaw 文件夹上右键单击，在弹出的右键菜单中选择 “Git Bash Here”，以在当前目录下打开 Git Bash 终端。

在 Git Bash 终端中，依次输入以下编译命令。每条命令执行完毕后，等待其完成再执行下一条：

pnpm install
pnpm ui:build
pnpm build

• pnpm install：安装所有项目依赖，首次执行可能需要几分钟
• pnpm ui:build：编译前端界面资源
• pnpm build：编译后端核心程序

步骤三：初始化配置

在 Git Bash 中运行以下命令完成初始化配置：

openclaw setup

该命令会自动生成默认配置文件。其中 ~ 符号在 Windows 环境下通常代表当前用户的主目录，例如 C:\Users\Administrator。

配置文件路径为：~\.openclaw\openclaw.json

例如：C:\Users\Administrator\.openclaw\openclaw.json

步骤四：更新配置

使用文本编辑器（如记事本、VS Code）打开上述配置文件，根据您的实际环境修改以下 4 个关键参数：

参数	说明	示例值
baseUrl	大模型 API 地址	http://xxxxx/v1
apiKey	大模型访问密钥	your-api-key
id	大模型名称/型号	qwen-plus
workspace	工作空间目录路径	C:\Users\用户名\.openclaw\workspace

完整配置内容参考如下：

4、启动龙虾（OpenClaw）

配置完成后，在 Git Bash 中启动龙虾服务。若系统提示 openclaw 命令找不到，请先执行 source ~/.bashrc 重新加载环境变量，然后再尝试启动。

龙虾提供两种启动方式：

# 方式一：前台运行（调试推荐）
# 日志会直接输出到终端，关闭窗口后服务会随之退出
openclaw gateway --port 18789 --verbose

# 方式二：后台运行（生产环境推荐）
# 使用 nohup 将服务运行在后台，日志输出到指定文件，方便后续排查问题
nohup openclaw gateway --port 18789 > /tmp/openclaw-gateway.log 2>&1 &

前台启动成功后，终端会显示服务运行日志，如下图所示：

5、页面测试

服务启动成功后，可通过以下步骤验证龙虾是否正常工作。

步骤一：访问前端页面

打开网页浏览器（推荐使用 Chrome 或 Edge），在地址栏输入以下地址并回车：

http://localhost:18789/overview

首次访问时，页面默认会提示需要 Token 验证后才可进行登录与连接。

步骤二：获取 Token

Token 是访问龙虾服务的安全凭证，存储在配置文件中。打开配置文件，找到 token 字段对应的值并复制。

步骤三：输入 Token 完成连接

返回 http://localhost:18789/overview 页面，在 Token 输入框中粘贴刚才复制的 Token 值，点击"连接"按钮。连接成功后，页面状态会从"离线"变为"正常"，表示龙虾服务已正确运行。

步骤四：聊天功能测试

在浏览器中打开聊天测试页面，开始与龙虾 AI 进行对话：

http://localhost:18789/chat?session=agent%3Amain%3Amain

故障排除： 如果龙虾没有任何回复，或提示 LLM request timed out，大概率是大模型配置有误。请重新检查配置文件中的 baseUrl、apiKey 和 id 字段是否填写正确，修改后需重新启动龙虾服务才能生效。

在主机上直接安装龙虾的一大核心优势，正是能够直接访问和操控本地系统资源。例如，您可以在聊天框中询问"我的桌面上有哪些文件"，龙虾会调用系统工具扫描桌面并返回文件列表；还可以让它启动指定的应用程序，或在浏览器中打开特定网址，真正实现 AI 对本地电脑的智能控制。

提示： 如遇到其他问题，请检查修改配置文件后重新启动龙虾服务。