这篇写给谁? 你在国内,用 Windows,想搞一个真正能用的 AI 私人助手。网上那些教程——要么是 Mac 的(你摸了摸手里的联想),要么跑到一半报错就没下文了(最气的一种)。这篇不一样——全程国内网络能跑通。
先说结论
OpenClaw 是 2026 年最火的开源 AI 助手项目(GitHub 146K+ Stars,没错,十四万六千颗星星),它能干啥?
• 🖥️ 直接操作你的电脑(读写文件、执行命令、管理日程——比你自己操作还利索)
• 💬 接入飞书/钉钉/微信,变成你的专属 AI 秘书(再也不用自己回老板消息了……开玩笑的)
• 🧠 使用国产大模型(通义千问 Qwen、DeepSeek),不花一分钱外币
本文目标:在你的 Windows 电脑上,用纯国内资源把 OpenClaw 跑起来,而且 24小时在线不掉线。泡杯茶,咱们开始。
第一步:安装 Node.js(3分钟搞定)
OpenClaw 跑在 Node.js 上面,所以我们先把地基打好。需要 22 以上版本。
方法一:官网安装(推荐,小白友好)
-
打开 Node.js 中文网(国内可以直接访问,放心点)
-
下载 LTS 版本(v22.x)的 Windows 安装包(.msi)
-
双击安装,全部默认下一步——这可能是整个教程最简单的一步了
方法二:通过 fnm 安装(老手可以秀一下)
PowerShell(管理员模式)
winget install Schniz.fnm fnm install 22 fnm use 22装完之后,打开一个全新的 PowerShell 窗口(划重点,一定要新开),验证一下:
node -v
应该显示 v22.x.x
npm -v
应该显示 10.x.x看到版本号了?恭喜,地基打好了,接下来才是重头戏。
第二步:配置国内 npm 镜像(救命一步!)
这是国内安装成功的 最最最关键一步。npm 默认去国外服务器下载东西,从国内直连那个速度……蜗牛看了都摇头。不配镜像的话,你会在终端前面枯坐半小时,然后收获一个 ETIMEDOUT。
方案 A:安装 cnpm(推荐,省心省力)
cnpm 是淘宝团队出的 npm 镜像客户端,直接走国内源,不需要改任何全局配置:
npm install -g cnpm --registry=https://registry.npmmirror.com装好后验证:
cnpm -v
应该显示版本信息之后所有需要 npm install 的地方,用 cnpm 替代即可,速度飞起。
方案 B:直接换源(不想多装工具的话)
npm config set registry https://registry.npmmirror.com就这一行,把 npm 的默认下载源换成国内镜像。验证一下:
npm config get registry
应该显示 https://registry.npmmirror.com
💡 说人话: 方案 A 装个 cnpm 最省心,后续直接
cnpm install就完事。方案 B 改全局源也行,看你喜好。
第三步:安装 OpenClaw(终于到正主了)
方式一:cnpm 安装(推荐)
以管理员身份打开 PowerShell(右键→以管理员身份运行)
cnpm install -g openclaw@latest看到类似 added xxx packages 就成功了。感谢淘宝镜像,通常几十秒搞定。
如果不幸遇到 sharp 相关报错(这是个图片处理库,有时候在 Windows 上会闹脾气):
$env:SHARP_IGNORE_GLOBAL_LIBVIPS=1 cnpm install -g openclaw@latest
方式二:npm 安装(如果你用了方案 B 换源)
npm install -g openclaw@latest
方式三:官方安装脚本(一键流)
iwr -useb https://openclaw.ai/install.ps1 | iex
安装验证
openclaw --version
应该显示版本号,如 2026.2.x如果提示 openclaw 不是内部或外部命令——别慌,这是经典的 PATH 问题:
查看 npm 全局安装路径
npm prefix -g
把输出的路径加到系统 PATH 环境变量里
通常是 C:\Users\你的用户名\AppData\Roaming\npm
然后重新打开 PowerShell 就好了
第四步:配置国产大模型(零成本,这才是国内玩家的快乐)
不需要 OpenAI API Key(那玩意儿又贵又难搞),用国产模型就完事了。便宜、好用、还不用担心被封号。
推荐模型对比
| 模型 | 厂商 | 免费额度 | 一句话点评 |
|---|---|---|---|
| Qwen(通义千问) | 阿里 | 100万 tokens/月 | ⭐ 首选!额度大方,稳如老狗 |
| DeepSeek | 深度求索 | 1000万 tokens | 推理一把好手,性价比之王 |
| GLM-4 | 智谱 | 有免费额度 | 写代码可以信赖 |
| Kimi | 月之暗面 | 有免费额度 | 长文本处理的王者 |
配置方法:通义千问 Qwen(推荐首选)
第 1 步:搞到 API Key
-
打开 阿里云百炼
-
用支付宝扫码登录(对,就这么简单)
-
进入「API Key管理」→ 「创建 API Key」
-
复制保存好这个 Key——待会儿要用,丢了就得重新建
第 2 步:运行向导配置
openclaw onboard --install-daemon向导会问你几个问题:
-
是否了解风险 → 选 Yes
-
安装方式 → 选 QuickStart
-
模型服务商 → 选 Qwen
-
按提示完成浏览器授权
或者直接编辑 ~/.openclaw/openclaw.json(新版本的格式可能会变化,不推荐直接编辑json):
{ "models": { "default": "qwen/qwen-max", "providers": { "qwen": { "apiKey": "sk-你的API Key" } } } }
配置方法:DeepSeek(不推荐直接编辑json)
{ "models": { "default": "deepseek/deepseek-chat", "providers": { "deepseek": { "apiKey": "sk-你的API Key", "baseUrl": "https://api.deepseek.com/v1" } } } }DeepSeek API Key 获取:platform.deepseek.com
第五步:接入国内社交工具(这步做完,才算真正好用)
装好了 OpenClaw,配好了模型,但它现在还只是个终端里的聊天窗口。想让它真正变成你的 AI 秘书?得接上聊天工具。
方案一:飞书(推荐,体验最丝滑)
飞书是目前国内接入 OpenClaw 体验最好的平台,没有之一。
1. 创建飞书应用
-
打开 飞书开放平台
-
创建企业自建应用(别怕,个人也能建)
-
拿到 App ID 和 App Secret
2. 配置权限(一键导入)
在应用后台的「权限管理」页面,可以手动逐个添加,也可以用批量导入的方式一步到位。
方式一:批量导入(推荐)
在飞书开放平台的应用配置页面,找到「权限管理」→「批量开通」,粘贴以下 JSON:
{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:…