这篇写给谁? 你在国内,用 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(通义千问) | 阿里 | 100万 tokens/月 | ⭐ 首选!额度大方,稳如老狗 |
| DeepSeek | 深度求索 | 1000万 tokens | 推理一把好手,性价比之王 |
| GLM-4 | 智谱 | 有免费额度 | 写代码可以信赖 |
| Kimi | 月之暗面 | 有免费额度 | 长文本处理的王者 |
配置方法:通义千问 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 秘书
| 步骤 | 干了啥 | 花了多久 |
|---|---|---|
| 1 | 装 Node.js | 5 分钟 |
| 2 | 配 npm 镜像 | 1 分钟 |
| 3 | 装 OpenClaw | 3 分钟 |
| 4 | 配国产大模型 | 5 分钟 |
| 5 | 接飞书 | 15 分钟 |
| 6 | 防睡眠 | 3 分钟 |
| 7 | 启动验证 | 2 分钟 |
总计约 30 分钟,全程国内网络,不需要花美金。
你现在拥有了一个 24小时在线的 AI 私人助手——它能帮你管理日程、读写文件、处理消息、操作电脑,而且跑在你自己的机器上,数据全掌控,没有人偷看你的聊天记录。
欢迎来到 AI Agent 时代,朋友。这才刚刚开始。🦞


