新手必看!OpenClaw安装+环境配置,我踩了5个坑,保姆级避坑指南(微信+飞书双配置完整版)
承接上期自动化脚本,从下载到跑通一步不落,小白一次成功
家人们谁懂啊!上一期发的文件自动整理脚本,我本来等着被夸“太好用了”,结果后台直接被留言炸锅:
“博主!脚本存了,但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 | 完全免费 | 零难度 | 新手白嫖 |
七、我踩过的5个大坑(你别再踩)
- 1. Node.js版本太低 → 必须≥22.0.0,直接下22.x LTS
- 2. 没切国内镜像 → 下载必失败,先执行镜像源命令
- 3. 没用管理员权限 → PowerShell/终端必开管理员
- 4. 初始化乱选选项 → 只选QuickStart,其他全跳过
- 5. 权限开太大 → 不给完全磁盘访问,避免误删文件
八、1分钟测试装没成功
- 1. 打开OpenClaw控制面板
- 2. 粘贴上期的文件整理脚本
- 3. 修改文件夹路径
- 4. 能正常生成文件+台账,就完全装好了!
写在最后
OpenClaw安装真的不难,90%的问题都是旧教程过时、漏了微信/飞书配置。
这篇把安装+汉化+API配置+微信+飞书全套搞定,小白跟着走,10分钟从零到能用!
普通打工人不用死磕代码,用AI自动化工具,就能告别重复加班~
下期出《OpenClaw写代码万能模板》,不会提示词也能一键生成可用脚本!
需要Qclaw免费安装包、微信&飞书配置文件、汉化包的,评论区扣**「安装」**,直接发你!
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐



所有评论(0)