1小时轻松打造专属AI助手：Windows一键安装OpenClaw教程

大家好，我是刀哥。做过大厂研发、做过出海硬件，现在挖掘AI圈一手更新，深耕 AI 视频、AI 编程。
历时约6个小时，参考了无数教程，跟豆包和 deepseek 对话无数轮，我终于安装完了。中间踩了无数的坑：不开魔法无法下载？环境变量找不到？飞书机器人收不到openclaw回复怎么办？相信看了我的教程，你能在一个小时内装完。准备工作 1、https://platform.deepseek.com/ 到deepseek注册一个key，充值十元即可， 必须有一个大模型响应对话，也可以选择千问、kimi、豆包的key。 2、有一个飞书账号，自己创建一个组织，免费。
目前openclaw有三种安装方式，我选择原生的git bash。

• WSL（Linux子系统）：官方推荐，相当于在windows里又装了个安全隔离的系统，适合熟悉 Linux 命令行、能处理网络代理的高级用户。它提供原生 Unix 环境，插件安装更顺畅，但网络隔离问题（代理穿透、端口转发）容易劝退普通人。
• 原生 Git Bash：适合普通 Windows 用户，想避免虚拟机。网络配置简单（直接走 Windows 网络），但需要手动处理 Node.js 依赖、插件安装和 Windows 特有的权限问题。有AI架构师表示用WSL历时48 小时血泪安装之后都没成。

• Cherry Studio（有用过的朋友表示，windows里没有openclaw的应用。。。）：https://www.cherry-ai.com/download
• • 省掉 OpenClaw 本体安装：自动装 Node.js、网关、基础依赖，免去终端敲命令的繁琐。我不确认是否走国外路线，那就还是卡死。
  • 省掉模型 API 配置：内置阿里云百炼等提供商，点几下就能配好 DeepSeek。如果只用大模型可以选这个。
  • 但省不了飞书后台配置：权限开通（尤其是 im:message.group_at_msg:readonly ）、事件订阅、长连接状态确认、首次配对——这些必须亲手在飞书开发者后台操作，Cherry Studio 无法代劳

1️⃣ 安装 OpenClaw（使用淘宝镜像源） 需要先安装node和git， node：https://nodejs.org/zh-cn git：https://git-scm.com/install/windows 如果发现下载很慢，windows版本我给你下载好了，公众号后台对话回复【小龙虾】 第三个软件就是OpenClaw了，点左下角windows菜单，选择所有程序，右键git bash，管理员身份运行先输入npm --version测试一下 npm命令找不到? 添加环境变量

1. 打开系统环境变量设置 ：

• 按下 Win + R ，输入 sysdm.cpl ，回车 → 切换到「高级」→「环境变量」

• 编辑用户 PATH 变量 ：

• 在「用户变量」下找到 Path ，点击「编辑」
• 点击「新建」，粘贴 npm 全局目录（如 C:\Users\hechao\AppData\Roaming\npm ）
• 点击「确定」保存所有设置

然后重新打开git bash 安装openclaw，由于国内网络环境，建议使用淘宝镜像源安装（默认的npm install -g openclaw装一天都没完），并观察详细安装过程，避免没进度焦虑：

# 使用淘宝镜像源全局安装，显示详细日志
npm install openclaw --registry=https://registry.npmmirror.com --verbose

deepseek后来给我的更好的建议，可以尝试下： openclaw-cn 是适配国内网络环境的中文社区版，已将GitHub依赖包构建为npm包，使用淘宝镜像源可快速下载，避免网络问题。且内置了飞书支持（ https://www.npmjs.com/package/@dragonforce2010/openclaw-cn ） 命令：npm install -g openclaw-cn@latest --registry= https://registry.npmmirror.com --verbose 安装完成后，验证版本：

openclaw --version
# 或
openclaw-cn --version

2️⃣ 手动安装网关服务（关键步骤！） 网关服务必须单独安装，否则无法后台运行：

# 安装网关后台服务（会生成自启动配置）
openclaw gateway install

安装成功后，会看到类似 Service: Scheduled Task (registered) 的提示。 ⚠️ 注意 ： gateway install 是必须执行的步骤，仅仅安装主程序是不够的。这个命令会在系统中注册后台服务，确保网关能开机自启、长期运行。 输入 “ openclaw gateway start ” 启动，然后输入命令： openclaw gateway status ，正常会显示 Dashboard: http://127.0.0.1:18789/ 复制到浏览器，就可以看到小龙虾安装好了：但这时候还不能对话，因为还没有配置大模型。 3️⃣ 安装飞书插件（手动方式，避免自动安装失败） 登录 飞书开发者后台 ，创建一个机器人应用：

下一步会需要用到App ID和secret。
然后就可以开始安装插件了。根据我的经验，自动安装容易失败，推荐手动下载并安装：

# 方法1：通过npm pack下载插件包
npm pack @overlink/openclaw-feishu --registry=https://registry.npmmirror.com


 # 会生成类似 openclaw-feishu-0.1.10.tgz 的文件
# 然后本地安装
openclaw plugins install ./openclaw-feishu-*.tgz

如果上述方法失败，可以手动下载并安装：

# 方法2：直接curl下载
curl -O https://registry.npmmirror.com/@overlink/openclaw-feishu/-/openclaw-feishu-0.1.10.tgz


 # 安装本地包
openclaw plugins install ./openclaw-feishu-0.1.10.tgz

验证插件安装：

openclaw plugins list
# 应看到 @overlink/openclaw-feishu 在列表中

4️⃣ 准备配置文件 在任意工作目录（如 E:\openclaw ）创建 config.ini ，内容如下（替换为你的真实信息）：

APP_ID=你的飞书App ID
APP_SECRET=你的飞书App Secret
DEEPSEEK_KEY=你的DeepSeek API Key

5️⃣ 运行一键配置脚本 为了自动化安装，我制作了一个脚本： setup_openclaw.bat ，跟ini文件保存到同一目录， 以管理员身份运行 。脚本会自动：

• 读取配置并生成 ~/.openclaw/openclaw.json
• 检查网关服务状态（如果未安装会提示）
• 重启网关

公众号后台对话回复【小龙虾】 配置文件和配置脚本都是为了自动化安装，如果还是有问题，参考我的配置，复制替换这个openclaw文件，在c盘user目录下，需要在我的电脑-》查看-》文件夹选项里，显示隐藏的文件和文件夹

{
  "meta": {
    "lastTouchedVersion": "2026.2.26",
    "lastTouchedAt": "2026-03-01T12:55:46.889Z"
  },
"wizard": {
    "lastRunAt": "2026-03-01T12:55:46.764Z",
    "lastRunVersion": "2026.2.26",
    "lastRunCommand": "doctor",
    "lastRunMode": "local"
  },
"agents": {
    "defaults": {
      "model": "deepseek/deepseek-chat",  
      "compaction": { "mode": "safeguard" },
      "maxConcurrent": 4,
      "subagents": { "maxConcurrent": 8 }
    }
  },
"models": {
"mode": "merge",
"providers": {
    "deepseek": {
      "baseUrl": "https://api.deepseek.com/v1",  // 注意末尾要带 /v1
      "apiKey": "必须替换：你的API Key",  // 你的API Key
      "api": "openai-completions",  // 固定写法
      "models": [
        {
          "id": "deepseek-chat",  // DeepSeek的模型ID
          "name": "DeepSeek Chat",
          "input": ["text"],
          "contextWindow": 128000,
          "maxTokens": 8192,
          "reasoning": false
        }
      ]
    }
  }
},
"messages": {
    "ackReactionScope": "group-mentions"
  },
"commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
"channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "default": {
          "appId": "必须替换：你的飞书appid",
          "appSecret": "必须替换，你的飞书app key"
        }
      }
    }
  },
"gateway": {"mode": "local",
    "auth": {
      "mode": "token",
      "token": "必须替换：openclaw自动生成的"
    }
  },
"plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
    }
  }
}

配置完成后，重启网关

openclaw gateway restart

6️⃣ 飞书后台核心权限配置（最关键！） 登录 飞书开发者后台，打开之前创建的机器人应用：权限管理（必须开通以下5项）：

权限标识 权限名称 重要性 作用 im:message.group_at_msg:readonly 接收群聊中@机器人消息事件 ⚠️ 最关键 缺了这个，群里@机器人完全收不到消息 contact:contact.base:readonly 获取通讯录基本信息 ⚠️ 最关键 缺了会报错 code 99991672 ，无法识别说话人 im:message 获取与发送单聊、群组消息 必需 收发消息的基础权限 im:message.p2p_msg:readonly 读取用户发给机器人的单聊消息 必需 接收私聊消息 im:message:send_as_bot 以应用的身份发消息 必需 发送回复

deepseek各种幻觉和误导，只告诉我开通 im.message.receive_v1 事件订阅配置：

• 订阅方式 ：必须选择 「使用长连接接收事件」 （不是 Webhook！）
• 添加事件 ：必须添加 im.message.receive_v1 （接收消息 v2.0）

⚠️ 重要顺序 ：必须先安装插件并配置好 App ID/Secret，重启网关后，再到飞书后台配置长连接。如果先配置长连接，会提示“未建立长连接”。 发布应用：

• 前往 「版本管理与发布」 → 创建新版本 → 填写版本号（如 1.0.1 ）→ 发布
• 任何权限或事件配置的修改，都必须发布新版本才能生效！

7️⃣ 将机器人加入群聊 在飞书客户端，进入目标群聊 → 点击右上角“…” → 群机器人 → 添加机器人 ，搜索你的应用名称并添加。 8️⃣ 首次配对 在群里 @你的机器人，发送任意消息（如“你好”）。你会收到类似：

OpenClaw: access not configured.
Your Feishu user id: ou_xxxx
Pairing code: XXXXXXXX
Ask the bot owner to approve with:
  openclaw pairing approve feishu XXXXXXXX

在 Git Bash 中执行批准命令（将 XXXXXXXX 替换为实际配对码）：

openclaw pairing approve feishu XXXXXXXX

9️⃣ 最终测试 批准后，再次在群里 @机器人 发送消息，应该会收到来自 DeepSeek 的正常回复。

告诉他给我安装steam，然后真的就弹窗告诉我下载好了，可以安装了！
常用命令速查

操作 命令 查看网关状态 openclaw gateway status 重启网关 openclaw gateway restart 查看实时日志 openclaw logs --follow 查看飞书频道状态 openclaw channels status 运行诊断修复 openclaw doctor --fix

openclaw里都有什么？
OpenClaw 的核心组件：

• 关键文件：
• • openclaw.json ：主配置文件（包含飞书账号、DeepSeek Key、网关设置等）。
  • config.json ：可能旧版遗留或插件配置。
  • gateway.cmd ：手动启动网关的脚本。
  • update-check.json ：版本更新记录。
• 重要文件夹：
• • agents/ ：AI 代理配置（如模型、技能）。
  • channels/ ：消息通道（飞书等）的运行状态。
  • extensions/ ：已安装插件（你手动装的飞书插件就在这里）。
  • workspace/ ：工作区文件（如用户身份、记忆等）。
  • logs/ ：运行日志（排错必备）。
  • cron/ 、 devices/ 、 identity/ 等：分别对应定时任务、设备认证、身份信息。

这个文件夹就是 OpenClaw 的大本营，所有配置和运行时数据都在这里。我们下一篇再深入讲。 总结 根据我的经验，最容易被遗漏的三个关键点是：

1. 手动安装网关服务 （ openclaw gateway install ）
2. 手动下载安装飞书插件 （避免自动安装失败）

每个人的电脑环境千变万化，如果遇到指南里也无法解决的，安装中遇到问题建议打开豆包或者deepseek随时提问。
这是一份经过实战检验的完整安装指南。如果还有任何问题，随时反馈！
创作不易，如果这篇对你有帮助，请多多支持！ 我们下期见！ 我是刀哥，做过大厂研发、做过出海硬件，现在挖掘AI圈一手更新，深耕 AI 视频、AI 编程。