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



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

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

---

1. 系统环境检查

2. 关闭临时干扰

• 关闭360安全卫士、腾讯电脑管家等杀毒软件（安装过程会被误判，安装后可重启）
• 关闭VPN/代理（国内镜像无需代理，代理可能导致下载失败）

---

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

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

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

方式A（快捷）：

1. 按键盘 组合键，弹出快捷菜单
2. 选择「Windows PowerShell (管理员)」或「终端 (管理员)」（Win10新版显示终端）
3. 弹出用户账户控制（UAC） 提示框，点击「是」（若点击否，安装必失败）

方式B（搜索）：

1. 点击电脑左下角「搜索框」，输入
2. 在搜索结果中，右键点击「Windows PowerShell」
3. 选择「以管理员身份运行」
4. 弹出UAC提示，点击「是」

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

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

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

1. 在管理员PowerShell中输入以下命令，按回车：
2. 出现提示 ，输入 （大小写均可），按回车确认

🔍 命令解释：

• ：修改执行策略命令
• ：允许本地脚本无签名运行，互联网脚本需可信签名（兼顾安全）
• ：仅对当前用户生效，不影响系统全局

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

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

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

🔍 命令解释：

• ： 的缩写，从指定URL下载安装脚本
• ：使用基本解析模式，避免格式错误
• ： 的缩写，执行下载的脚本

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

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

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

阶段1：安全确认

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

阶段2：安装模式选择

• 提示：
• 选项：（快速启动）、（自定义）
• 选择：输入 ，按回车（新手必选，自动配置所有基础项）

阶段3：模型平台选择

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

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

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

阶段5：聊天渠道选择

• 提示：
• 选项：（飞书）、（电报）等
• 选择：输入 ，按回车（国内用户首选）

阶段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. 双击下载的 文件，启动安装向导：
   1. 步骤1：点击「下一步」
   2. 步骤2：勾选「我接受许可协议」，点击「下一步」
   3. 步骤3：必须勾选「Add to PATH」（自动添加环境变量，关键！）
   4. 步骤4：点击「下一步」，默认安装路径即可
   5. 步骤5：点击「安装」，等待完成
   6. 步骤6：点击「完成」

✅ 验证Node.js安装：

1. 打开新的PowerShell（无需管理员）
2. 输入 ，回车后显示 即成功
3. 输入 ，回车后显示 即成功

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

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

1. 访问Git官网：https://git-scm.com/download/win
2. 下载Windows版安装程序，双击安装
3. 安装向导默认设置即可，勾选「Add Git to PATH」
4. 安装完成后，验证：PowerShell输入 ，显示版本即成功

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

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

🔍 命令解释：

• ：全局安装Node.js包
• ：安装最新版本的OpenClaw-CN

⚠️ 下载慢解决方法：

使用淘宝NPM镜像加速：

✅ 验证安装：输入 ，显示 及以上版本即成功

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

1. 输入命令启动配置向导：
2. 后续步骤与「一键安装的步骤4」完全一致，按提示操作即可

---

必须完成此步骤，才能继续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：格式为 ，点击右侧「复制」按钮保存
   2. App Secret：首次查看需点击「显示」，再点击「复制」保存

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

1. 左侧菜单栏点击「事件订阅」
2. 开启「事件订阅」开关
3. 添加事件：点击「添加事件」，搜索 （接收消息事件），勾选并保存
4. 消息接收模式：选择「长连接（WebSocket）」（与OpenClaw兼容）

---

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

1. 提示： → 粘贴之前复制的App ID，按回车
2. 提示： → 粘贴之前复制的App Secret，按回车
3. 提示： → 输入 ，按回车

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

• 提示：（是否安装为系统计划任务，开机自启）
• 输入：，按回车（安装后，网关会在后台自动运行，无需每次手动启动）

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

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

→ 代表网关启动成功！

---

检查1：网关可达性

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

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

检查2：飞书通道状态

在 输出的「Channels」部分，确认：

→ 飞书通道配置成功

检查3：访问控制UI

1. 输入命令：
2. 自动打开浏览器，访问
3. 能看到OpenClaw控制面板，即成功

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

1. 打开飞书，在「工作台」中找到你创建的机器人（如「OpenClaw智能助手」）
2. 发送消息：
3. 机器人回复消息 → 整套流程完全打通！

---

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

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

✅ 验证修复：输入 ，无CRITICAL告警即成功

---

---

问题1：网关启动失败，提示

• 原因：端口18789被占用，或网关未启动
• 解决：执行 （强制终止占用进程，启动网关）

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

• 原因：App Secret错误，或飞书应用未发布
• 解决：
  • 重新配置飞书凭证：
  • 飞书开放平台应用详情页，点击「发布」（企业自建应用需发布后才能使用）

问题3：一键安装脚本提示

• 原因：Node.js未自动安装成功，或环境变量未生效
• 解决：重启电脑，或手动安装Node.js（参考方法二步骤1）

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

• 原因：未使用管理员身份运行PowerShell
• 解决：关闭当前窗口，重新以管理员身份打开PowerShell

---

1. 核心关键：管理员权限、执行策略设置、飞书凭证正确配置
2. 新手优先：一键安装（国内镜像），自动解决所有环境问题
3. 必做步骤：获取飞书App ID/App Secret、修复安全权限、测试机器人回复
4. 遇到问题：先看日志（），再用 自动诊断

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