新手必看！OpenClaw安装+环境配置，我踩了5个坑，保姆级避坑指南（微信+飞书双配置完整版）

本文提供OpenClaw自动化工具的保姆级安装教程，涵盖Windows/Mac/Linux全平台。重点解决常见安装报错问题，包括Node.js版本要求、国内镜像源切换、权限管理等核心注意事项。教程包含一键汉化方案、微信/飞书双渠道配置指南，并推荐性价比API模型和完全免费的Qclaw替代方案。特别总结了5大常见安装陷阱及解决方案，确保新手10分钟内完成从安装到测试的全流程。最后提供文件整理脚本的运

m0_65077874

486人浏览 · 2026-04-16 10:21:44

m0_65077874 · 2026-04-16 10:21:44 发布

承接上期自动化脚本，从下载到跑通一步不落，小白一次成功

家人们谁懂啊！上一期发的文件自动整理脚本，我本来等着被夸“太好用了”，结果后台直接被留言炸锅：
“博主！脚本存了，但OpenClaw到底在哪下啊？”
“跟着教程装3遍，满屏红色报错，心态直接崩了”
“装完全是英文界面，跟看外星文似的”
“怕它权限太高乱删文件，根本不敢用啊”

太懂这种崩溃了！我第一次装OpenClaw，从下午2点熬到晚上6点，坑踩得我怀疑人生：
Node.js版本不对报错、权限不够装不上、国外镜像慢到下载失败、汉化改配置改到眼瞎，好不容易装完，还差点因为权限开太大把桌面项目文件夹全改名，吓得我一身冷汗！

今天直接把2026年4月最新、亲测3台电脑稳跑的保姆级教程甩给你，全程不跳步、不讲晦涩术语、不甩废话，跟着点，10分钟装完直接跑上期脚本，微信+飞书双渠道配置一步到位！

先锁3条铁律！不听劝必踩坑

这3条是我用4小时崩溃换的血泪教训，哪怕跳着看，也刻在DNA里：

1. Node.js必须≥22.0.0！ 低于这个版本，安装直接报错，90%新手栽在这
2. 国内必切镜像源！ 用默认国外源，下载到99%必失败，重试10次都没用
3. 绝对不给完全磁盘访问权限！ 安全底线从安装就守住，别让AI乱搞电脑

一、Windows完整安装教程（手残党闭眼跟）

1. 先装两个核心依赖：Node.js+Git

少一个都跑不起来，按步骤来零失误

（1）装Node.js（最易踩坑环节）

别用电脑里老版本的18.x/20.x！我第一次就是装错版本，直接报“不支持Node.js版本”，卸载重装半小时，想砸电脑的心都有。
正确操作：

1. 打开Node.js官网，下载22.x LTS长期支持版（别下最新版，兼容性拉胯）
2. 双击安装包，全程点下一步，务必勾选“Add to PATH”（不勾后续报错到崩溃）
3. 验证：Win+R输cmd打开命令行，输入node -v，弹出v22.xx.x就成功了

（2）装Git

全程下一步就行，唯一要点：勾选“Add Git to PATH”，不然会报“git不是内部命令”。

2. 正式装OpenClaw！权限一定要对

重中之重！ 右键开始菜单 → 选「Windows PowerShell (管理员)」，不用管理员权限，100%报权限不足！

打开后复制这3行命令，粘贴回车就行：

# 切国内镜像源（解决下载慢/失败）
npm config set registry https://registry.npmmirror.com
# 全局安装最新版OpenClaw
npm install -g openclaw@latest
# 验证安装
openclaw -v

弹出版本号，直接搞定！网上那些让装一堆杂七杂八依赖的，全是过时旧教程。

3. 初始化配置（新手照抄选项，不用动脑）

输入命令启动向导，--install-daemon必加，关掉终端也能后台运行：

openclaw onboard --install-daemon

接下来的选项，跟着选就行，一个字别改：

• 安全警告：选Yes（后续会加固安全，放心）
• 配置模式：必选QuickStart快速开始（手动模式填一堆东西，新手必错）
• 模型选择：Skip for now暂不配置（后续再弄，不卡进度）
• 通讯渠道：Skip for now（先跑通基础）
• 技能配置：No（后续按需装）
• 启动方式：选Open the Web UI（网页控制面板，新手最友好）

完成后终端会出控制面板链接：http://127.0.0.1:18789/?token=xxx，复制到浏览器打开就能用！
✅ 小提醒：token是登录凭证，丢了输cat ~/.openclaw/openclaw.json找回。

二、Mac/Linux安装教程（5分钟速通）

1. 装依赖

打开终端，复制执行：

# Mac先装Homebrew（国内源不失败）
/bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/Homebrew/install@HEAD/install.sh)"
# 一键装Node.js+Git
brew install node git

2. 装OpenClaw

# 切国内镜像源
npm config set registry https://registry.npmmirror.com
# 管理员权限安装（输电脑密码）
sudo npm install -g openclaw@latest
# 验证
openclaw -v

3. 初始化配置

和Windows完全一样：

openclaw onboard --install-daemon

照着上面的选项选就行。

⚠️ Mac专属小坑：提示“无法检查恶意软件”
打开「系统设置→隐私与安全性」，找到阻止项，点「仍要打开」输密码即可。

三、一键汉化！告别英文天书

纯英文界面劝退90%新手，给你最简单的有效汉化方案，不用改配置文件：

1. 卸载原版（没装跳过）

npm uninstall -g openclaw

2. 一键装中文版

• Windows（管理员PowerShell）

iwr -useb https://cdn.cn-mirror.com/install.ps1 | iex

• Mac/Linux

curl -sSf https://cdn.cn-mirror.com/install.sh | sh

3. 验证：输openclaw-cn -v，弹出版本号就成功，后续命令把openclaw换成openclaw-cn，全中文界面，爹妈都能看懂！

四、模型API购买+性价比选型（省钱必看）

OpenClaw想要正常对话、写脚本、自动化操作，必须接入大模型API，国内模型最稳、最便宜，别去搞国外的！

1. 首选实惠模型（按量计费，几毛钱用一天）

1. 通义千问（阿里）：国内访问稳定，价格极低，办公/写脚本首选
2. Kimi月之暗面：长文本解析强，新用户送免费额度
3. 智谱GLM：性价比天花板，日常用一天几分钱

2. 一键配置API Key

打开配置文件~/.openclaw/openclaw.json，填入你的API Key，保存后重启：

openclaw gateway restart

不想花钱？直接看文末Qclaw免费方案，纯白嫖不花一分钱！

五、核心进阶：微信+飞书双渠道完整配置（保姆级一步不落）

OpenClaw最强的就是对接聊天工具，个人微信+飞书机器人全套配置给你，手机就能遥控AI干活！

5.1 个人微信一键接入（ClawBot插件，iOS 8.0.70+）

前置条件

• 微信版本：iOS 8.0.70及以上
• 已安装并运行OpenClaw

操作步骤

1. 打开微信 → 我 → 设置 → 插件，找到「ClawBot」卡片点击进入
2. 复制终端命令，在OpenClaw设备终端执行：

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

3. 终端生成二维码，用微信扫码绑定
4. 扫码成功自动重启，OpenClaw后台频道显示微信已部署
5. 直接在微信聊天窗口，就能和OpenClaw对话

Windows用户必看！报错解决

Windows用npx会报“未找到openclaw”，用这3行命令替代：

# 安装微信插件
openclaw plugins install "@tencent-weixin/openclaw-weixin"
# 启用插件
openclaw config set plugins.entries.openclaw-weixin.enabled true
# 扫码登录
openclaw channels login --channel openclaw-weixin

终端出二维码后，微信扫码授权就搞定！

终极兜底方案（插件安装失败用）

新建cli.mjs、package.json、LICENSE三个文件，粘贴对应代码，执行：

node ./cli.mjs install

直接绕过所有报错，一键装好微信插件！

5.2 飞书机器人完整配置（办公自动化首选）

第一步：启用飞书插件

openclaw plugins enable feishu
# 查看状态，显示loaded就是启用成功
openclaw plugins list

第二步：飞书开放平台创建机器人

1. 打开飞书开放平台，创建企业自建应用，填名称、图标
2. 复制应用的App ID和App Secret（务必保存）

第三步：配置OpenClaw飞书频道

1. 终端执行：

openclaw channels add

2. 选择Feishu/Lark (飞书)，输入App Secret和App ID
3. 连接模式选国内域名，群聊策略选Open（所有群都能@机器人）
4. 选择Finished完成配置

第四步：开启机器人+配置权限

1. 飞书应用后台 → 添加应用能力 → 开启机器人
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:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

第五步：配置事件订阅

1. 事件与回调 → 订阅方式选长连接接收事件
2. 添加4个核心事件：

• 接收消息：im.message.receive_v1
• 消息已读：im.message.message_read_v1
• 机器人进群：im.chat.member.bot.added_v1
• 机器人被移出群：im.chat.member.bot.deleted_v1

第六步：发布应用+测试

1. 版本管理与发布 → 创建版本 → 提交发布
2. 启动OpenClaw：

openclaw gateway --port 18789

3. 飞书建群，添加机器人，@机器人能正常回复，就配置成功！

六、零成本白嫖！Qclaw免费方案（新手首选）

不想买API、不想折腾配置？直接冲Qclaw，完全免费、全中文、零配置！
✅ 不用装Node.js/Git，双击安装
✅ 内置免费大模型，不用申请API Key
✅ 自带安全沙箱，不碰系统文件
✅ 微信/飞书一键对接，小白闭眼用

三种方案对比

方案	成本	难度	适合人群
原版OpenClaw	按量付费（几分钱/天）	中等	想深度定制的玩家
EasyClaw	小额会员	简单	办公懒人
Qclaw	完全免费	零难度	新手白嫖