Windows 10 下 OpenClaw-CN（龙虾）超详细安装教程（2026 版）

Windows 10 安装 OpenClaw-CN（龙虾）超详细教程（2026最新版）

适用场景：零基础用户、有开发经验用户、飞书机器人部署需求用户

核心目标：全程无死角拆解，从系统准备到机器人上线，每一步都附操作截图描述、命令解释、错误解决，确保一次性安装成功。

---

一、安装前必看（准备工作）

1. 系统环境检查

检查项	要求	验证方法
Windows版本	10 1903及以上（64位）	右键「此电脑」→ 属性 → 查看Windows版本
内存	≥4GB（推荐8GB+）	右键「此电脑」→ 属性 → 查看内存
网络	稳定宽带（国内网络推荐用国内镜像）	打开浏览器访问百度，确认网速正常
权限	管理员权限（必须）	后续所有操作均需「以管理员身份运行」

2. 关闭临时干扰

• 关闭360安全卫士、腾讯电脑管家等杀毒软件（安装过程会被误判，安装后可重启）

• 关闭VPN/代理（国内镜像无需代理，代理可能导致下载失败）

---

二、方法一：一键安装（新手首选，全程自动，5分钟搞定）

这是官方推荐的国内优化版，自动安装Node.js、Git、OpenClaw-CN，无需手动配置环境变量。

步骤1：打开「管理员权限 PowerShell」（最关键！）

有两种方式，任选其一，必须确认是管理员身份：

方式A（快捷）：

1. 按键盘 Win + X 组合键，弹出快捷菜单

2. 选择「Windows PowerShell (管理员)」或「终端 (管理员)」（Win10新版显示终端）

3. 弹出用户账户控制（UAC） 提示框，点击「是」（若点击否，安装必失败）

方式B（搜索）：

1. 点击电脑左下角「搜索框」，输入 PowerShell

2. 在搜索结果中，右键点击「Windows PowerShell」

3. 选择「以管理员身份运行」

4. 弹出UAC提示，点击「是」

✅ 验证管理员身份：PowerShell窗口标题栏会显示「管理员: Windows PowerShell」

步骤2：设置PowerShell执行策略（允许运行安装脚本）

Windows默认禁止运行脚本，必须修改，否则安装脚本无法执行。

1. 在管理员PowerShell中输入以下命令，按回车：

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

2. 出现提示 确认更改执行策略吗?，输入 Y（大小写均可），按回车确认

🔍 命令解释：

• Set-ExecutionPolicy：修改执行策略命令

• RemoteSigned：允许本地脚本无签名运行，互联网脚本需可信签名（兼顾安全）

• Scope CurrentUser：仅对当前用户生效，不影响系统全局

✅ 验证执行策略：输入 Get-ExecutionPolicy，回车后显示 RemoteSigned 即成功

步骤3：运行国内优化版一键安装脚本

复制以下国内镜像命令（解决官方脚本国内下载慢、失败问题），完整粘贴到PowerShell中，按回车：

iwr -useb https://clawd.org.cn/install.ps1 | iex

🔍 命令解释：

• iwr：Invoke-WebRequest 的缩写，从指定URL下载安装脚本

• -useb：使用基本解析模式，避免格式错误

• iex：Invoke-Expression 的缩写，执行下载的脚本

⚠️ 可能出现的错误及解决：

错误提示	原因	解决方法
无法连接到远程服务器	网络不稳定或代理干扰	关闭VPN/代理，重启PowerShell重新执行
脚本未签名	执行策略未设置成功	重新执行步骤2，或用命令：Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass（单次有效）

步骤4：跟随交互式向导完成初始化配置（核心步骤）

脚本运行后，会自动下载依赖并启动配置向导，严格按照以下步骤选择/输入：

阶段1：安全确认

• 提示：This script will install OpenClaw-CN and its dependencies...

• 输入：yes（必须小写），按回车

阶段2：安装模式选择

• 提示：Select install mode

• 选项：quickstart（快速启动）、custom（自定义）

• 选择：输入 quickstart，按回车（新手必选，自动配置所有基础项）

阶段3：模型平台选择

• 提示：Select model provider

• 选项：openai、anthropic、qwen 等

• 选择：输入 openai（后续可在控制UI添加其他模型，如通义千问、文心一言），按回车

阶段4：OpenAI API密钥配置（可选，可先跳过）

• 提示：Enter your OpenAI API key (optional, skip with Enter)

• 操作：有密钥则粘贴输入，无密钥直接按回车（后续在控制UI配置即可）

阶段5：聊天渠道选择

• 提示：Select channels to enable

• 选项：feishu（飞书）、telegram（电报）等

• 选择：输入 feishu，按回车（国内用户首选）

阶段6：飞书凭证配置（核心！需提前准备App ID和App Secret）

⚠️ 暂停配置！先按「步骤六」获取飞书App ID和App Secret，再回来继续输入

---

三、方法二：手动安装（适合有开发经验，或一键安装失败用户）

全程手动控制，适合已安装Node.js的用户，排查问题更方便。

步骤1：安装Node.js（必须22.x LTS版本，兼容OpenClaw-CN）

1. 访问Node.js官网：https://nodejs.org/zh-cn/download/

2. 下载「Windows 安装程序 (.msi)」→ 选择「长期支持版(LTS)」（当前为22.x）

3. 双击下载的 .msi 文件，启动安装向导：

   1. 步骤1：点击「下一步」

   2. 步骤2：勾选「我接受许可协议」，点击「下一步」

   3. 步骤3：必须勾选「Add to PATH」（自动添加环境变量，关键！）

   4. 步骤4：点击「下一步」，默认安装路径即可

   5. 步骤5：点击「安装」，等待完成

   6. 步骤6：点击「完成」

✅ 验证Node.js安装：

1. 打开新的PowerShell（无需管理员）

2. 输入 node --version，回车后显示 v22.x.x 即成功

3. 输入 npm --version，回车后显示 10.x.x 即成功

步骤2：安装Git（可选，但推荐）

OpenClaw部分插件依赖Git，未安装可能导致部分功能异常。

1. 访问Git官网：https://git-scm.com/download/win

2. 下载Windows版安装程序，双击安装

3. 安装向导默认设置即可，勾选「Add Git to PATH」

4. 安装完成后，验证：PowerShell输入 git --version，显示版本即成功

步骤3：安装OpenClaw-CN CLI（核心工具）

在管理员PowerShell中输入以下命令，按回车：

npm install -g openclaw-cn@latest

🔍 命令解释：

• npm install -g：全局安装Node.js包

• openclaw-cn@latest：安装最新版本的OpenClaw-CN

⚠️ 下载慢解决方法：

使用淘宝NPM镜像加速：

npm config set registry https://registry.npmmirror.com npm install -g openclaw-cn@latest

✅ 验证安装：输入 openclaw-cn --version，显示 0.1.7 及以上版本即成功

步骤4：初始化配置（与一键安装的向导一致）

1. 输入命令启动配置向导：

   openclaw-cn onboard --install-daemon

2. 后续步骤与「一键安装的步骤4」完全一致，按提示操作即可

---

四、关键前置：飞书开放平台创建机器人（获取App ID和App Secret）

必须完成此步骤，才能继续OpenClaw的飞书配置！

注意：需使用飞书企业管理员账号登录，个人账号无法创建企业自建应用。

步骤1：登录飞书开放平台

1. 打开浏览器，访问：https://open.feishu.cn/

2. 使用飞书企业账号扫码登录（必须是管理员权限）

步骤2：创建企业自建应用

1. 登录后，点击左上角「创建企业自建应用」按钮

2. 填写应用信息：

   1. 应用名称：如「OpenClaw智能助手」（自定义，如“龙虾机器人”）

   2. 应用描述：如「基于OpenClaw的AI智能体」（可选）

   3. 应用图标：可上传龙虾图标，或使用平台默认（可选）

3. 点击「创建」按钮，完成应用初始化

步骤3：添加「机器人」能力（核心！）

1. 进入应用详情页，左侧菜单栏找到「添加应用能力」

2. 在弹出的窗口中，选择「机器人」，点击「添加」

3. 添加完成后，左侧菜单栏会出现「机器人」选项

步骤4：获取App ID和App Secret（关键凭证）

1. 左侧菜单栏点击「凭证与基础信息」

2. 在页面中找到：

     ⚠️ 重要提醒：App Secret是核心密钥，请勿泄露给他人，勿提交到代码仓库！

   1. App ID：格式为 cli_xxxxxxxxxxxxx，点击右侧「复制」按钮保存

   2. App Secret：首次查看需点击「显示」，再点击「复制」保存

步骤5：配置飞书机器人事件订阅（确保能接收消息）

1. 左侧菜单栏点击「事件订阅」

2. 开启「事件订阅」开关

3. 添加事件：点击「添加事件」，搜索 im.message.receive_v1（接收消息事件），勾选并保存

4. 消息接收模式：选择「长连接（WebSocket）」（与OpenClaw兼容）

---

五、继续OpenClaw配置（完成飞书凭证输入）

回到PowerShell的配置向导，继续阶段6：

1. 提示：Enter Feishu App ID → 粘贴之前复制的App ID，按回车

2. 提示：Enter Feishu App Secret → 粘贴之前复制的App Secret，按回车

3. 提示：Enable Feishu channel? → 输入 yes，按回车

步骤5：安装守护进程（可选，推荐）

• 提示：Install gateway as a Windows Scheduled Task?（是否安装为系统计划任务，开机自启）

• 输入：yes，按回车（安装后，网关会在后台自动运行，无需每次手动启动）

步骤6：完成配置，自动启动网关

配置完成后，脚本会自动启动OpenClaw网关服务，提示：

Gateway started on ws://127.0.0.1:18789 → 代表网关启动成功！

---

六、验证安装成果（核心检查，确保所有功能正常）

检查1：网关可达性

在PowerShell中输入以下命令，按回车：

openclaw-cn status

✅ 关键指标：Gateway 显示 reachable（之前的 unreachable 已修复）

检查2：飞书通道状态

在 openclaw-cn status 输出的「Channels」部分，确认：

Feishu | ON | OK | configured → 飞书通道配置成功

检查3：访问控制UI

1. 输入命令：openclaw-cn dashboard

2. 自动打开浏览器，访问 http://127.0.0.1:18789

3. 能看到OpenClaw控制面板，即成功

检查4：测试飞书机器人（最终验证）

1. 打开飞书，在「工作台」中找到你创建的机器人（如「OpenClaw智能助手」）

2. 发送消息：你好，我是测试

3. 机器人回复消息 → 整套流程完全打通！

---

七、修复安全告警（必做，解决3个CRITICAL）

安装后运行 openclaw-cn security audit 会出现3个权限告警，按以下步骤修复（Windows专用命令）：

在管理员PowerShell中依次输入以下命令，每个命令按回车执行：

# 修复主目录权限（仅当前用户可读写） icacls "C:\Users\Administrator\.openclaw" /inheritance:r /grant:r "%USERNAME%:(OI)(CI)F" # 修复配置文件权限 icacls "C:\Users\Administrator\.openclaw\openclaw.json" /inheritance:r /grant:r "%USERNAME%:F" # 修复凭证目录权限 icacls "C:\Users\Administrator\.openclaw\credentials" /inheritance:r /grant:r "%USERNAME%:(OI)(CI)F"

✅ 验证修复：输入 openclaw-cn security audit，无CRITICAL告警即成功

---

八、常用操作命令（安装后必备）

功能	命令	场景
手动启动网关	openclaw-cn gateway --force	网关未启动，或端口被占用
查看网关日志	openclaw-cn logs --follow	机器人无响应，排查错误
重新配置飞书	openclaw-cn configure feishu	飞书凭证变更，或通道异常
更新版本	openclaw-cn update	官方发布新版本，升级功能
停止网关	openclaw-cn gateway stop	停止后台运行的网关
卸载	openclaw-cn uninstall	彻底删除OpenClaw及数据

---

九、常见问题终极解决（90%用户会遇到）

问题1：网关启动失败，提示 connect ECONNREFUSED 127.0.0.1:18789

• 原因：端口18789被占用，或网关未启动

• 解决：执行 openclaw-cn gateway --force（强制终止占用进程，启动网关）

问题2：飞书机器人无响应，日志显示 Feishu token expired

• 原因：App Secret错误，或飞书应用未发布

• 解决：

  • 重新配置飞书凭证：openclaw-cn configure feishu

  • 飞书开放平台应用详情页，点击「发布」（企业自建应用需发布后才能使用）

问题3：一键安装脚本提示 node: command not found

• 原因：Node.js未自动安装成功，或环境变量未生效

• 解决：重启电脑，或手动安装Node.js（参考方法二步骤1）

问题4：PowerShell执行命令提示「权限不足」

• 原因：未使用管理员身份运行PowerShell

• 解决：关闭当前窗口，重新以管理员身份打开PowerShell

---

十、总结

1. 核心关键：管理员权限、执行策略设置、飞书凭证正确配置

2. 新手优先：一键安装（国内镜像），自动解决所有环境问题

3. 必做步骤：获取飞书App ID/App Secret、修复安全权限、测试机器人回复

4. 遇到问题：先看日志（openclaw-cn logs --follow），再用 openclaw-cn doctor --fix 自动诊断

安装成功后，你就可以在飞书中使用龙虾机器人，实现AI对话、代码编写、文档处理等功能了！