国内Windows 系统从0到1安装OpenClaw 图文详细教程
在你的 Windows 电脑上，用纯国内资源把 OpenClaw 跑起来，而且 24小时在线不掉线。泡杯茶，咱们开始。
第一步：安装 Node.js（3分钟搞定）
OpenClaw 跑在 Node.js 上面，所以我们先把地基打好。需要 22 以上版本。
方法一：官网安装（推荐，小白友好）
1. 打开 Node.js 中文网（国内可以直接访问，放心点）
2. 下载 LTS 版本（v22.x）的 Windows 安装包（.msi）
3. 双击安装，全部默认下一步——这可能是整个教程最简单的一步了
方法二：通过 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
1. 打开 阿里云百炼
2. 用支付宝扫码登录（对，就这么简单）
3. 进入「API Key管理」→ 「创建 API Key」
4. 复制保存好这个 Key——待会儿要用，丢了就得重新建
第 2 步：运行向导配置openclaw onboard –install-daemon
向导会问你几个问题：
1. 是否了解风险 → 选 Yes
2. 安装方式 → 选 QuickStart
3. 模型服务商 → 选 Qwen
4. 按提示完成浏览器授权
或者直接编辑 ~/.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. 创建飞书应用
1. 打开 飞书开放平台
2. 创建企业自建应用（别怕，个人也能建）
3. 拿到 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:write”, “contact:contact.base:readonly”, “contact:user.employee_id:readonly”, “corehr:file:download”, “docs:document.content:read”, “event:ip_list”, “im:chat”, “im:chat.access_event.bot_p2p_chat:read”, “im:chat.members:bot_access”, “im:message”, “im:message.group_at_msg:readonly”, “im:message.group_msg”, “im:message.p2p_msg:readonly”, “im:message:readonly”, “im:message:send_as_bot”, “im:resource”, “sheets:spreadsheet”, “wiki:wiki:readonly” ], “user”: [ “aily:file:read”, “aily:file:write”, “contact:contact.base:readonly”, “im:chat.access_event.bot_p2p_chat:read” ] } }
方式二：手动添加
如果你偏好手动操作，以下是需要开通的权限清单：
应用权限（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{ “channels”: { “feishu”: { “accounts”: { “default”: { “appId”: “cli_你的AppID”, “appSecret”: “你的AppSecret”, “encryptKey”: “你的加密Key”, “verificationToken”: “你的验证Token”, “enabled”: true } } } } }
方案二：钉钉
钉钉接入方式类似飞书，通过企业内部应用 + 机器人实现。路子差不多，这里就不重复了。
方案三：微信（需要第三方桥接，稍微折腾一点）
微信没有官方机器人 API（你懂的），需要通过 WeChat Bridge 等第三方工具桥接。
💡 真心建议：先用飞书跑通，体验最流畅。飞书个人版免费，不需要企业认证。等你玩明白了再搞微信也不迟。
第六步：Windows 防睡眠配置（别让你的 AI 秘书打瞌睡）
OpenClaw 是常驻后台服务。如果电脑进入睡眠……你的 AI 秘书就直接下班了。以下几招彻底解决睡眠问题，让它 7×24 给你打工。
方法一：powercfg 命令（最快，30秒搞定）
以管理员身份打开 PowerShell：# 关闭睡眠（交流电模式下） powercfg /change standby-timeout-ac 0 # 关闭休眠 powercfg /change hibernate-timeout-ac 0 # 关闭屏幕（可选，省电但不影响 OpenClaw） powercfg /change monitor-timeout-ac 15 # 禁用休眠文件（还能省几个G磁盘空间） powercfg -h off
方法二：创建”永不睡眠”电源计划
# 创建新的电源计划 powercfg -duplicatescheme 8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c # 在 “控制面板 → 电源选项” 中找到新计划，设置： # – 关闭显示器：15分钟 # – 使计算机进入睡眠状态：从不 # – 关闭硬盘：从不
方法三：创建 keep-awake 脚本
创建 keep-awake.ps1：# OpenClaw Keep Awake Script # 每 4 分钟模拟一次按键，防止系统进入睡眠 Write-Host “🦞 OpenClaw Keep Awake – 防睡眠模式已启动” -ForegroundColor Green Write-Host “按 Ctrl+C 停止” -ForegroundColor Yellow $shell = New-Object -ComObject WScript.Shell while ($true) { $shell.SendKeys(“{SCROLLLOCK}”) Start-Sleep -Milliseconds 200 $shell.SendKeys(“{SCROLLLOCK}”) $timestamp = Get-Date -Format “yyyy-MM-dd HH:mm:ss” Write-Host “[$timestamp] 💓 心跳 – 系统保持唤醒” -ForegroundColor DarkGray Start-Sleep -Seconds 240 # 4分钟 }
方法四：设置开机自启（一劳永逸）
创建 openclaw-startup.bat，放到 Windows 启动文件夹：@echo off echo Starting OpenClaw Gateway… :: 防止睡眠 powercfg /change standby-timeout-ac 0 powercfg /change hibernate-timeout-ac 0 :: 启动 OpenClaw openclaw gateway start echo OpenClaw is running!
启动文件夹怎么找？按 Win + R，输入 shell:startup，把 bat 文件丢进去就行。
验证防睡眠生效
# 查看当前电源设置 powercfg /query SCHEME_CURRENT # 查看活跃的电源请求 powercfg /requests
第七步：启动并验证（激动人心的时刻！）
启动 Gateway
openclaw gateway start
检查状态
openclaw status openclaw health
打开 Web 界面
openclaw dashboard
浏览器会自动打开 http://localhost:18789，看到管理面板了？那就是你的 AI 管家的控制中心。
测试对话
在飞书（或其他已配置的聊天工具）中，给机器人发一条消息：你好，你是谁？
如果收到回复——恭喜你，你做到了！ 🎉 国内版 OpenClaw 配置成功，从此你有了一个 24 小时待命的 AI 私人助手。
常见问题 FAQ（踩坑指南）
Q: npm/cnpm install 很慢/超时怎么办？
十有八九是没配镜像源。回去看第二步，装 cnpm 或换源：npm install -g cnpm –registry=https://registry.npmmirror.com
Q: sharp 安装报错？
这货在 Windows 上偶尔会闹别扭：$env:SHARP_IGNORE_GLOBAL_LIBVIPS=1 cnpm install -g openclaw@latest
Q: 找不到 openclaw 命令？
经典 PATH 问题：# 先看看 npm 把东西装到哪儿了 npm prefix -g # 把输出的路径加到系统 PATH 环境变量里 # 通常是 C:\Users\你的用户名\AppData\Roaming\npm # 加完重开 PowerShell 就好了
Q: Gateway 启动报端口被占用？
# 查看是谁占了 netstat -aon | findstr 18789 # 请它走 taskkill /PID 进程ID /F
Q: 模型回复很慢？
1. 通义千问 qwen-max 响应最快，日常用它
2. DeepSeek 推理任务用 deepseek-reasoner
3. 确保用的是国内 API 端点（别走国际线路）
Q: 电脑重启后 OpenClaw 没自动启动？
用上面的 openclaw-startup.bat 放到启动文件夹，或者：openclaw onboard –install-daemon
这会把 OpenClaw 注册为系统服务，重启也不怕。
完整配置文件参考
给你一份 ~/.openclaw/openclaw.json 的完整示例，直接抄作业：{ “models”: { “default”: “qwen/qwen-max”, “providers”: { “qwen”: { “apiKey”: “sk-你的通义千问API Key” }, “deepseek”: { “apiKey”: “sk-你的DeepSeek API Key”, “baseUrl”: “https://api.deepseek.com/v1” } } }, “channels”: { “feishu”: { “accounts”: { “default”: { “appId”: “cli_你的AppID”, “appSecret”: “你的AppSecret”, “encryptKey”: “你的加密Key”, “verificationToken”: “你的验证Token”, “enabled”: true } } } } }
总结：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 时代，朋友。这才刚刚开始。🦞
