目录
龙虾AI（OpenClaw）在Windows保姆级部署教程
whataicc
2026年03月10日 11:07
openclaw

OpenClaw 是最近非常火的 AI Agent 工具平台。和普通聊天机器人不同，它不仅能聊天，还能执行任务，例如搜索网页、打开浏览器、运行命令、自动化处理任务等。很多开发者把它当成一个 AI 自动化助手框架 来使用。

这篇教程将从 零基础 出发，带你在 Windows 系统完整安装 OpenClaw，并配置神马中转 API，实现可以稳定调用 Claude / GPT / Gemini 等模型。

OpenClaw 是什么

简单理解：

OpenClaw = AI Agent 操作平台

它可以：

  • 调用大模型（GPT、Claude、Gemini 等）

  • 让 AI 自动执行任务

  • 控制浏览器

  • 搜索网页

  • 执行命令

  • 创建自动化任务

比如你可以让它：

  • “搜索今天 AI 新闻并总结”

  • “打开某个网页并提取内容”

  • “写一个 Python 脚本并保存文件”

  • “每天 9 点自动给我总结科技新闻”

所以 OpenClaw 本质上是一个 AI 自动化助手系统。

安装前准备

在 Windows 上安装 OpenClaw 前，需要准备几个基础环境。

1、Windows 系统

推荐：

Windows 10 / Windows 11

2、准备 API Key（最重要）

OpenClaw 需要连接 AI 模型。

但在国内很多人会使用 中转 API，因为：

  • 速度更稳定

  • 可以统一管理模型

  • 支持多个模型

本教程使用：

神马中转 API

示例地址：

代码块
PlainText
自动换行
复制代码
https://api.whatai.cc/v1
复制成功

你需要准备：

API KEY

稍后配置。

Windows 安装 OpenClaw

WSL2 + Ubuntu部署（强烈推荐）

这是官方推荐的Windows部署方式，提供最完整的Linux环境支持。

第一步：启用WSL2

以管理员身份打开PowerShell，执行：

代码块
PlainText
自动换行
复制代码
# 启用WSL功能
复制成功
代码块
PlainText
自动换行
复制代码
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
复制成功
代码块
PlainText
自动换行
复制代码
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
复制成功
代码块
PlainText
自动换行
复制代码
# 设置WSL 2为默认版本
复制成功
代码块
PlainText
自动换行
复制代码
wsl --set-default-version 2
复制成功

重启计算机。

第二步：安装Ubuntu

方法一：Microsoft Store安装（推荐）

  1. 打开Microsoft Store

  2. 搜索「Ubuntu 22.04 LTS」或「Ubuntu 24.04 LTS」

  3. 点击「获取」并安装

  4. 首次启动设置用户名和密码

安装完成后会自动打开Ubuntu终端，按提示设置用户名和密码。

第三步：更新Ubuntu系统

在Ubuntu终端中执行：

# 更新软件包列表

代码块
PlainText
自动换行
复制代码
sudo apt update && sudo apt upgrade -y
复制成功

# 安装基础工具

代码块
PlainText
自动换行
复制代码
sudo apt install -y curl git wget build-essential
复制成功

第四步：安装Node.js 22+

#运行 NVM 安装脚本

代码块
PlainText
自动换行
复制代码
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
复制成功

#使 NVM 生效

代码块
PlainText
自动换行
复制代码
source ~/.bashrc
复制成功

#安装 Node.js：

代码块
PlainText
自动换行
复制代码
nvm install 22
复制成功

#验证 Node.js 版本（必须≥22.x）

代码块
PlainText
自动换行
复制代码
node --version
复制成功
代码块
PlainText
自动换行
复制代码
npm --version
复制成功

第五步：安装 OpenClaw

一键脚本安装

代码块
PlainText
自动换行
复制代码
curl -fsSL https://openclaw.ai/install.sh | bash
复制成功

选择AI模型：

选择你的AI供应商选择Custom Provider：

输入BaseURL和API Key：

代码块
PlainText
自动换行
复制代码
输入模型BaseURL：https://api.whatai.cc/v1，输入对应的API Key，选择OpenAI-compatible，输入模型ID如：claude-sonnet-4-6
复制成功

第六步：验证安装

# 查看版本

代码块
PlainText
自动换行
复制代码
openclaw --version
复制成功

# 查看帮助

代码块
PlainText
自动换行
复制代码
openclaw --help
复制成功

# 查看系统状态

代码块
PlainText
自动换行
复制代码
openclaw status
复制成功

第七步：配置Windows访问WSL2服务

由于OpenClaw运行在WSL2中，需要配置端口转发以便Windows访问。

创建启动脚本 start-openclaw.bat：

代码块
PlainText
自动换行
复制代码
@echo off

echo Starting OpenClaw Gateway in WSL2...

wsl -d Ubuntu-22.04 -u root service openclaw start

timeout /t 3

start http://localhost:18789
复制成功

或直接在WSL2中启动：

# 在WSL2 Ubuntu终端中

代码块
PlainText
自动换行
复制代码
openclaw gateway run --port 18789
复制成功

然后在Windows浏览器访问 http://localhost:18789

OpenClaw 常用命令

常用命令：

查看状态

openclaw status

打开控制台

openclaw dashboard

查看日志

openclaw logs

健康检查

openclaw doctor

重启服务

openclaw gateway restart

解决常见问题

openclaw命令找不到

原因：

Node 没加入环境变量。

解决：

重新安装 Node。

网页打不开

检查：

openclaw gateway status

如果没启动：

openclaw gateway start

模型报错

通常是：

API Key 错误

或者 BaseURL 填错

重新运行：

openclaw onboard

重新配置。

OpenClaw 是目前非常热门的 AI Agent 工具平台。

相比普通聊天 AI，它最大的特点是：

  • 能执行真实任务

  • 支持自动化

  • 支持插件工具

  • 支持多模型接入

  • 可以本地部署

通过 Windows + OpenClaw + 神马中转 API，你就可以搭建一个属于自己的 AI 自动化助手系统。

本文为我原创，未经授权禁止转载
cv46634526