OpenClaw 国内定制版部署指南：Windows 从零到跑通，全程国内网络

这篇写给谁？ 你在国内，用 Windows，想搞一个真正能用的 AI 私人助手。网上那些教程——要么是 Mac 的（你摸了摸手里的联想），要么跑到一半报错就没下文了（最气的一种）。这篇不一样——全程国内网络能跑通。

先说结论

OpenClaw 是 2026 年最火的开源 AI 助手项目（GitHub 146K+ Stars，没错，十四万六千颗星星），它能干啥？

• 🖥️ 直接操作你的电脑（读写文件、执行命令、管理日程——比你自己操作还利索）

• 💬 接入飞书/钉钉/微信，变成你的专属 AI 秘书（再也不用自己回老板消息了……开玩笑的）

• 🧠 使用国产大模型（通义千问 Qwen、DeepSeek），不花一分钱外币

本文目标：在你的 Windows 电脑上，用纯国内资源把 OpenClaw 跑起来，而且 24小时在线不掉线。泡杯茶，咱们开始。

第一步：安装 Node.js（3分钟搞定）

OpenClaw 跑在 Node.js 上面，所以我们先把地基打好。需要 22 以上版本。

方法一：官网安装（推荐，小白友好）

1. 打开 Node.js 中文网（国内可以直接访问，放心点）

2. 下载 LTS 版本（v22.x）的 Windows 安装包（.msi）

3. 双击安装，全部默认下一步——这可能是整个教程最简单的一步了

方法二：通过 fnm 安装（老手可以秀一下）

装完之后，打开一个全新的 PowerShell 窗口（划重点，一定要新开），验证一下：

看到版本号了？恭喜，地基打好了，接下来才是重头戏。

第二步：配置国内 npm 镜像（救命一步！）

这是国内安装成功的 最最最关键一步。npm 默认去国外服务器下载东西，从国内直连那个速度……蜗牛看了都摇头。不配镜像的话，你会在终端前面枯坐半小时，然后收获一个 ETIMEDOUT。

方案 A：安装 cnpm（推荐，省心省力）

cnpm 是淘宝团队出的 npm 镜像客户端，直接走国内源，不需要改任何全局配置：

装好后验证：

之后所有需要 npm install 的地方，用 cnpm 替代即可，速度飞起。

方案 B：直接换源（不想多装工具的话）

就这一行，把 npm 的默认下载源换成国内镜像。验证一下：

💡 说人话： 方案 A 装个 cnpm 最省心，后续直接 cnpm install 就完事。方案 B 改全局源也行，看你喜好。

第三步：安装 OpenClaw（终于到正主了）

方式一：cnpm 安装（推荐）

看到类似 added xxx packages 就成功了。感谢淘宝镜像，通常几十秒搞定。

如果不幸遇到 sharp 相关报错（这是个图片处理库，有时候在 Windows 上会闹脾气）：

方式二：npm 安装（如果你用了方案 B 换源）

方式三：官方安装脚本（一键流）

安装验证

如果提示 openclaw 不是内部或外部命令——别慌，这是经典的 PATH 问题：

第四步：配置国产大模型（零成本，这才是国内玩家的快乐）

不需要 OpenAI API Key（那玩意儿又贵又难搞），用国产模型就完事了。便宜、好用、还不用担心被封号。

推荐模型对比

配置方法：通义千问 Qwen（推荐首选）

第 1 步：搞到 API Key

1. 打开 阿里云百炼

2. 用支付宝扫码登录（对，就这么简单）

3. 进入「API Key管理」→ 「创建 API Key」

4. 复制保存好这个 Key——待会儿要用，丢了就得重新建

第 2 步：运行向导配置

向导会问你几个问题：

1. 是否了解风险 → 选 Yes

2. 安装方式 → 选 QuickStart

3. 模型服务商 → 选 Qwen

4. 按提示完成浏览器授权

或者直接编辑 ~/.openclaw/openclaw.json（新版本的格式可能会变化，不推荐直接编辑json）：

配置方法：DeepSeek（不推荐直接编辑json）

DeepSeek API Key 获取：platform.deepseek.com

第五步：接入国内社交工具（这步做完，才算真正好用）

装好了 OpenClaw，配好了模型，但它现在还只是个终端里的聊天窗口。想让它真正变成你的 AI 秘书？得接上聊天工具。

方案一：飞书（推荐，体验最丝滑）

飞书是目前国内接入 OpenClaw 体验最好的平台，没有之一。

1. 创建飞书应用

1. 打开 飞书开放平台

2. 创建企业自建应用（别怕，个人也能建）

3. 拿到 App ID 和 App Secret

2. 配置权限（一键导入）

在应用后台的「权限管理」页面，可以手动逐个添加，也可以用批量导入的方式一步到位。

方式一：批量导入（推荐）

在飞书开放平台的应用配置页面，找到「权限管理」→「批量开通」，粘贴以下 JSON：

方式二：手动添加

如果你偏好手动操作，以下是需要开通的权限清单：

应用权限（tenant）：

• im:message / im:message:send_as_bot / im:message:readonly（消息收发）

• im:resource（获取文件/图片资源）

• im:chat / im:chat.members:bot_access（群聊访问）

• im:message.group_msg / im:message.group_at_msg:readonly（群消息）

• im:message.p2p_msg:readonly / im:chat.access_event.bot_p2p_chat:read（私聊）

• docs:document.content:read / wiki:wiki:readonly / sheets:spreadsheet（文档/知识库/表格读取）

• contact:contact.base:readonly / contact:user.employee_id:readonly（通讯录基本信息）

• cardkit:card:write（交互式卡片）

• application:application:self_manage / application:bot.menu:write（应用管理）

• 其他：aily:file:read/write、corehr:file:download、event:ip_list

用户权限（user）：

• aily:file:read / aily:file:write

• contact:contact.base:readonly

• im:chat.access_event.bot_p2p_chat:read

3. 配置事件订阅

• 请求地址：https://你的服务器地址:18789/feishu/webhook

• 订阅事件：im.message.receive_v1

4. 配置 openclaw.json

方案二：钉钉

钉钉接入方式类似飞书，通过企业内部应用 + 机器人实现。路子差不多，这里就不重复了。

方案三：微信（需要第三方桥接，稍微折腾一点）

微信没有官方机器人 API（你懂的），需要通过 WeChat Bridge 等第三方工具桥接。

💡 真心建议：先用飞书跑通，体验最流畅。飞书个人版免费，不需要企业认证。等你玩明白了再搞微信也不迟。

第六步：Windows 防睡眠配置（别让你的 AI 秘书打瞌睡）

OpenClaw 是常驻后台服务。如果电脑进入睡眠……你的 AI 秘书就直接下班了。以下几招彻底解决睡眠问题，让它 7×24 给你打工。

方法一：powercfg 命令（最快，30秒搞定）

以管理员身份打开 PowerShell：

方法二：创建"永不睡眠"电源计划

方法三：创建 keep-awake 脚本

创建 keep-awake.ps1：

方法四：设置开机自启（一劳永逸）

创建 openclaw-startup.bat，放到 Windows 启动文件夹：

启动文件夹怎么找？按 Win + R，输入 shell:startup，把 bat 文件丢进去就行。

验证防睡眠生效

第七步：启动并验证（激动人心的时刻！）

启动 Gateway

检查状态

打开 Web 界面

浏览器会自动打开 http://localhost:18789，看到管理面板了？那就是你的 AI 管家的控制中心。

测试对话

在飞书（或其他已配置的聊天工具）中，给机器人发一条消息：

如果收到回复——恭喜你，你做到了！ 🎉 国内版 OpenClaw 配置成功，从此你有了一个 24 小时待命的 AI 私人助手。

常见问题 FAQ（踩坑指南）

Q: npm/cnpm install 很慢/超时怎么办？

十有八九是没配镜像源。回去看第二步，装 cnpm 或换源：

Q: sharp 安装报错？

这货在 Windows 上偶尔会闹别扭：

Q: 找不到 openclaw 命令？

经典 PATH 问题：

Q: Gateway 启动报端口被占用？

Q: 模型回复很慢？

1. 通义千问 qwen-max 响应最快，日常用它

2. DeepSeek 推理任务用 deepseek-reasoner

3. 确保用的是国内 API 端点（别走国际线路）

Q: 电脑重启后 OpenClaw 没自动启动？

用上面的 openclaw-startup.bat 放到启动文件夹，或者：

这会把 OpenClaw 注册为系统服务，重启也不怕。

完整配置文件参考

给你一份 ~/.openclaw/openclaw.json 的完整示例，直接抄作业：

总结：30 分钟，从零到拥有 AI 秘书

总计约 30 分钟，全程国内网络，不需要花美金。

你现在拥有了一个 24小时在线的 AI 私人助手——它能帮你管理日程、读写文件、处理消息、操作电脑，而且跑在你自己的机器上，数据全掌控，没有人偷看你的聊天记录。

欢迎来到 AI Agent 时代，朋友。这才刚刚开始。🦞

本文基于 OpenClaw 2026.2.x 版本编写，如有更新请以官方文档为准。 官方文档：https://docs.openclaw.ai GitHub：https://github.com/openclaw/openclaw