Windows上安装“小龙虾”(OpenClaw)保姆级教程:从零搭建你的AI智能体

最近“赛博养虾”突然爆火，腾讯大厦门口甚至排起长队安装OpenClaw 。这款被称为“小龙虾”的AI智能体，能真正帮你操作电脑、调用工具、接入聊天软件，堪称你的私人AI员工。本文将用最通俗的语言，手把手教你在Windows上成功“养虾”，并解决你可能遇到的所有问题。

一、为什么要在Windows上装“小龙虾”？

OpenClaw（昵称“龙虾”）是一款能真正做事的AI助手——它不只是聊天，还能调用浏览器、操作文件系统、接入聊天渠道、自动执行任务。简单说，你可以让它帮你写周报、总结网页、监控信息，甚至自动运营社交媒体。

官方推荐通过WSL2在Windows上运行（兼容性更好），但Windows原生安装同样可行。本文重点介绍Windows原生安装方式，无需学习Linux就能快速上手。

二、安装前的准备工作

2.1 硬件和系统要求

在开始前，请确认你的电脑满足以下条件：

操作系统：Windows 10/11 64位
内存：至少4GB（推荐8GB以上）
磁盘空间：500MB以上（后续Skills会占用更多）
网络：能够正常访问GitHub和npm（国内用户可能需要科学上网或配置镜像）

2.2 核心依赖安装

OpenClaw基于Node.js运行，需要先安装Node.js环境。

第一步：安装Node.js 22+版本

访问 Node.js官网，下载22.x LTS版本（截至2026年3月，推荐22.22.0）。安装时务必勾选“Add to PATH”，这样系统才能识别 node 和 npm 命令。

验证安装：打开命令提示符（或PowerShell），输入以下命令，看到版本号即成功：

node --versionnpm --version

第二步：安装Git（可选但推荐）

从 Git官网下载安装，后续安装Skills时会用到。

第三步：配置npm国内镜像（关键！）

由于网络原因，直接使用npm官方源可能很慢或失败。打开管理员权限的PowerShell，执行：

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

这是淘宝npm镜像，速度飞快。

2.3 重要提醒：隐私安全

⚠️ 特别注意：OpenClaw涉及自动化操作和环境配置，如果你的电脑存有重要的商业数据或个人隐私信息，强烈建议使用一台干净的备用设备，或者租用一个云服务器来运行，公司电脑不建议使用 。

三、Windows原生安装OpenClaw（核心步骤）

3.1 以管理员身份打开PowerShell

这是最容易出错的步骤！必须用管理员权限，否则后续安装会因权限不足失败。

点击“开始”菜单，输入 PowerShell
右键点击“Windows PowerShell”，选择 “以管理员身份运行”

3.2 解决执行策略限制（必做）

首次运行脚本可能会遇到这个经典错误：

无法加载文件 ...npm.ps1，因为在此系统上禁止运行脚本

这是因为PowerShell默认禁止执行未签名脚本。这是为了保护电脑免受恶意脚本的侵害；在刚才打开的管理员PowerShell中执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force#或者使用Get-ExecutionPolicy#如果显示 Restricted，说明确实禁止了脚本运行#输入以下命令，将策略临时改为 RemoteSigned（该策略允许运行本地脚本，并信任从互联网下载的已签名脚本）：Set-ExecutionPolicy RemoteSigned

这条命令允许运行本地脚本和已签名的远程脚本。

（重要）完成安装后，建议恢复默认策略：

为了保证系统安全，建议在OpenClaw安装配置完成后，将执行策略恢复为默认的 Restricted。
在管理员PowerShell中再次运行：

Set-ExecutionPolicy Restricted#输入 Y 确认即可。

3.3 一键安装OpenClaw

在管理员PowerShell中执行官方安装命令：

iwr -useb https://openclaw.ai/install.ps1 | iex

如果这条命令失败，可以尝试备用命令：

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta

安装过程需要几分钟，你会看到大量文字滚动。只要最后出现类似“OpenClaw installed successfully”的提示，就说明安装成功。

3.4 常见安装错误及解决方法

错误1：Git SSH权限问题

npm error git@github.com: Permission denied (publickey).

原因：npm试图通过SSH协议拉取代码，但你没有配置SSH密钥。

解决方法：在PowerShell中执行以下命令，强制Git使用HTTPS代替SSH ：

git config --global url."https://github.com/".insteadOf git@github.com:

然后重新运行安装命令。

错误2：各种弃用警告（deprecated）和EPERM错误

npm warn deprecated inflight@1.0.6...npm warn cleanup Failed to remove some directories...

原因：这些是依赖库的警告和权限清理错误。

解决方法：直接忽略！ 只要最后有“added XXX packages”和OpenClaw的Logo出现，就说明安装成功了。这些警告不影响使用。

错误3：安装完成后“openclaw”命令找不到

原因：npm全局安装路径没有添加到系统PATH环境变量。

解决方法：

手动添加npm全局路径到PATH：

右键“此电脑” → “属性” → “高级系统设置” → “环境变量”

在“用户变量”或“系统变量”中找到Path，编辑添加：

%USERPROFILE%\AppData\Roaming\npm

完全关闭当前PowerShell，重新打开一个新的（普通权限即可），再试

openclaw --version

四、初始化配置：给“小龙虾”装上大脑

安装完成后，OpenClaw只是一个空壳，需要配置AI模型才能“聪明”起来。

4.1 运行配置向导

在PowerShell中执行：

openclaw onboard

或者：

openclaw config wizard

4.2 交互配置步骤详解

你会看到一个彩色菜单，按以下步骤操作：

第1步：风险提示

I understand this is powerful and inherently risky. Continue?

输入yes 回车（必须同意）。

第2步：选择配置模式选择 QuickStart（快速开始）。

第3步：选择模型提供商

这里最关键！国内用户推荐以下免费/易用的选项：

Qwen（阿里千问）：注册阿里云账号就有免费额度，auth方式接入最简单
MiniMax：有免费试用额度
Moonshot AI（Kimi）：中文效果好
如果你有OpenAI Key，也可以选OpenAI

以Qwen为例的接入步骤：

选择 Qwen
选择 Qwen Auth 方式
浏览器会自动打开Qwen授权页面，登录你的阿里云账号（没有就注册）
点击“确认授权”
回到PowerShell，会看到模型列表，选择默认模型（如 qwen-max 或 qwen-plus）

第4步：配置聊天工具这一步选 Skip for now（先跳过），后续可以单独配置飞书、QQ等。

第5步：配置基础Skills选yes。然后按空格键选择以下核心技能库：

clawhub（技能市场）
github（开源技能）
obsidian（写作辅助，可选）

第6步：选择孵化方式建议选 Open the Web UI，会自动打开浏览器进入操作界面。

4.3 完成配置后的界面

配置成功后，浏览器会自动打开 http://localhost:18789，你会看到OpenClaw的Web控制台。在这里可以直接和你的“小龙虾”聊天。

五、给“小龙虾”开智：让它真正能干活

刚装好的OpenClaw可能只会聊天，不会操作你的电脑。这是因为权限限制。给它“提权”后，它才能真正帮你做事 。

5.1 修改配置文件

找到OpenClaw的配置文件：

在Windows资源管理器地址栏粘贴：%USERPROFILE%\.openclaw\openclaw.json
用记事本或VS Code打开这个文件

找到 “tools”节点（可能在文件中间），修改或添加以下内容：

"tools": {    "profile": "full"}

原来的 profile 可能是 messaging，改成 full 即可。

5.2 重启服务使配置生效

在PowerShell中执行：

openclaw gateway restart

现在试试让OpenClaw“写一个文本文件保存在桌面”或“总结这个网页”，它会真的去执行！

六、常用命令速查（建议收藏）

命令	作用
openclaw gateway start	启动网关服务
openclaw gateway restart	重启网关（修改配置后常用）
openclaw gateway status	查看网关运行状态
openclaw token generate	生成新的访问令牌
openclaw logs --follow	实时查看日志（排查问题神器）
openclaw doctor	诊断检查环境问题
openclaw config	修改配置
openclaw plugins install <插件名>	安装插件（如飞书）

七、进阶玩法：让“小龙虾”更强大

7.1 安装实用Skills（技能）

在Web控制台中，可以直接让OpenClaw安装技能。例如输入：

安装“国内镜像源”技能，解决 pip 和 npm下载慢的问题

它会自动从ClawHub安装相关技能。

常用的中国开发者技能包包括：

中文编码规范：解决中文乱码
国内镜像源：自动配置pip、npm的国内镜像
完整代码输出：确保AI输出完整可运行的代码
中文文档生成：自动生成中文技术文档

7.2 接入飞书/QQ

想让“小龙虾”在飞书里工作？安装飞书插件：

openclaw plugins install @m1heng-clawd/feishu

然后在飞书开放平台创建应用，配置App ID和Secret即可。详细步骤可以参考官方文档或社区教程。

7.3 配置阿里云百炼API（免费额度）

如果你想要更稳定的模型服务，阿里云百炼提供免费调用额度：

# 配置百炼API密钥openclaw config set models.providers.bailian.accessKeyId "你的AccessKeyId"openclaw config set models.providers.bailian.accessKeySecret "你的AccessKeySecret"openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"openclaw config set models.default "qwen-max"

八、常见问题终极解答

Q1：安装过程中各种红色警告，是不是失败了？

A：大概率是成功了！只要最后出现OpenClaw的Logo（一只龙虾）和“Your task has been queued”之类的话，就说明安装成功。前面的警告大多是依赖库的弃用提示，可以忽略。

Q2：打开Web界面后发消息，它说不认识我或权限不足？

A：这是没有提权的表现。请按照第五章“给小龙虾开智”的步骤，修改配置文件中的tools.profile为full，然后重启网关。

Q3：提示“No API key found for provider”怎么办？

A：模型认证没成功。可以重新运行openclaw onboard，重新走一遍模型配置流程。如果之前用OAuth失败，建议改用API Key方式（如果有的话）。

Q4：服务启动但无法访问 http://localhost:18789？

A：检查网关是否运行：openclaw gateway status。如果没运行，执行openclaw gateway start。如果运行了还是打不开，检查防火墙是否放行了18789端口

Q5：安装Skills时很慢或失败？

A：网络问题。确保npm镜像已配置为淘宝源（见2.2节）。如果还是慢，可以尝试科学上网。

Q6：Windows Defender报毒或拦截？

A：OpenClaw是开源工具，但某些自动化操作可能被误报。可以将%USERPROFILE%\.openclaw目录添加到Windows Defender的排除列表。

九、写在最后：养虾注意事项

安全第一：OpenClaw功能强大，能操作你的文件甚至执行命令。不要随意安装来路不明的Skills，安装前最好审阅一下脚本内容。
定期备份：配置文件（.openclaw目录）和重要数据建议定期备份。
Token管理：访问令牌（Token）相当于你的登录密码，不要分享给他人。可以定期用openclaw token generate重新生成。
资源占用：如果电脑配置较低（如4GB内存），不要同时运行太多Skills，以免卡顿。
官方文档优先：遇到问题先看 OpenClaw官方文档，其次才是社区教程。