OpenClaw新手0基础保姆级教程：安装+企微机器人对接（含命令速查表）

小白必读说明：全程手把手教学，Windows/Mac/Linux全适配，分本地测试（免费快速）和云端稳定（24小时在线）两种方案，不用懂代码，复制命令就能执行；文末附纯命令速查清单，直接抄作业不踩坑。

⚠️ 全程禁忌：别用普通成员企微账号、别装低版本Node.js、别选企微普通Webhook机器人，否则必失败！

一、前期准备：先把这些搞定，杜绝中途报错

这一步是基础，哪怕是纯小白，按清单核对完再动手，90%的报错都能避免。

1.1 账号权限核查（必看，没有权限直接放弃）

• 企业微信账号：必须是企业创建者/主管理员，部门管理员、普通员工没有创建机器人的权限，登错账号会找不到入口！
• 客户端准备：电脑端安装最新版企业微信，别用手机端、别用老旧版本，避免功能缺失。
• 网络要求：正常联网即可，别开代理/翻墙，否则命令执行会超时、连不上企微接口。

1.2 本地部署必备软件（云端部署可直接跳过）

OpenClaw靠Node.js运行，必须先装指定版本，严禁用系统自带低版本，否则命令全报错！

1.2.1 Node.js安装（一步到位）

1. 版本要求：必须是Node.js 22.0及以上LTS版（长期稳定版，新手首选）
2. 下载地址：官网直达 https://nodejs.org/，按系统选安装包：
   1. Windows选：.msi 后缀安装包（64位）
   2. Mac选：.pkg 后缀安装包（Intel/M芯片通用）
   3. Linux用命令安装，新手直接用桌面版安装包
3. 安装要点：全程默认下一步，Windows用户务必勾选“Add to PATH”（自动配置环境变量，不勾选后续命令用不了）
4. 校验是否装成功：按下Win+R输入cmd打开终端（Windows）/ 打开Mac启动台-终端，复制粘贴以下命令，回车执行：node -v npm -v显示版本号（比如v22.10.0）就算成功，没显示就是没装好/没重启终端。
5. 关键避坑：安装完必须关闭终端重新打开，否则系统识别不到命令！

1.2.2 可选辅助工具（新手可忽略）

• Python 3.10+：部分高级功能用，本地测试不用装
• Git：拉取源码用，npm安装方式不需要

1.3 云端部署准备（适合长期用，不用一直开电脑）

想让机器人24小时在线、不占本地电脑资源，选云端腾讯云轻量服务器：

• 注册腾讯云账号，完成实名认证（必须实名才能买服务器）
• 购买轻量应用服务器：配置选2核2GB起步，系统选CentOS/Ubuntu都行
• 优选OpenClaw官方镜像，不用手动装软件，买来直接配置
• 记好：服务器公网IP、登录密码（后续远程连接用）

二、OpenClaw全平台安装（本地+云端，复制命令就行）

方案1：本地安装（免费，适合新手测试）

1. 打开终端：Windows用管理员身份打开PowerShell/CMD；Mac/Linux直接打开自带终端
2. 复制粘贴全局安装命令，回车执行（耐心等待1-3分钟，别关闭终端）： npm install -g openclaw
3. 校验安装结果：粘贴命令回车，显示版本号（如2026.3.x）就是成功 openclaw -v

本地安装常见报错解决（小白专属）

• 报错“command not found”：重启终端，再执行校验命令；还是不行就重装Node.js
• 报错“权限不足”：Windows换管理员终端；Mac/Linux命令前加sudo sudo npm install -g openclaw
• 报错“网络超时”：切换国内镜像，执行完再重新安装 npm config set registry https://registry.npmmirror.com/

方案2：云端安装（一键部署，不用手动敲命令）

1. 登录腾讯云控制台 → 轻量应用服务器 → 创建实例
2. 选择“应用市场”，搜索OpenClaw，选中官方镜像
3. 选2核2GB配置，设置服务器登录密码，提交创建（等待3-5分钟）
4. 实例创建完成后，点击远程登录，一键进入服务器终端
5. 执行校验命令，确认预装成功：openclaw -v

三、企业微信机器人创建（核心：拿对接密钥）

⚠️ 必须建API长连接机器人，普通Webhook机器人接不上OpenClaw，别建错！

步骤1：新建自建机器人

1. 打开电脑端企业微信 → 进入工作台
2. 找到智能机器人（没有就去应用市场搜索添加）
3. 点击创建机器人 → 选择自建机器人 → 跳过场景模板，直接进配置页

步骤2：开启API模式+长连接（拿密钥）

1. 在机器人配置页，找到连接方式板块，务必勾选API模式（普通模式无法对接）
2. 连接方式选长连接（新手首选，不用公网IP、不用域名）
3. 页面会自动生成Bot ID和Secret（两串英文+数字组合）
4. 重中之重：把Bot ID和Secret复制，粘贴到记事本保存好，丢了只能重新建机器人！
5. 先别点保存，留着这个页面，等OpenClaw配置完再提交

步骤3：机器人基础设置（可选，方便识别）

• 给机器人改个名字（比如OpenClaw助手）、上传头像
• 权限只开接收消息、发送消息，多余权限关掉更安全

四、OpenClaw+企微机器人关联（二选一，全程复制命令）

本地/云端选一种就行，新手先试本地，稳定了再换云端。

方案A：本地部署关联（新手测试首选）

步骤1：安装企微对接插件

打开终端，粘贴命令回车，等待提示“安装成功”

openclaw plugins install @wecom/wecom-openclaw-plugin

如果报错，换备用命令执行：

openclaw plugins install @tencent/openclaw-wecom

步骤2：启动OpenClaw网关（必须开着）

粘贴命令回车，这个终端窗口不能关，关了机器人就掉线

openclaw gateway start

步骤3：添加企微渠道，配置密钥

1. 重新打开一个新终端（别关之前的网关窗口），粘贴命令回车： openclaw channels add
2. 终端会弹出渠道列表，用上下方向键选中企业微信(WeCom)，按回车确认
3. 按提示粘贴Bot ID → 回车 → 粘贴Secret → 回车
4. 最后选中Finished/Done，回车完成基础配置

步骤4：用户配对授权（必做，否则机器人不回话）

1. 回到企业微信，找到刚建的机器人，发任意消息（比如“你好”）
2. 机器人会自动回复配对码+授权命令，把整条命令复制下来
3. 粘贴到新终端里回车，提示“授权成功”就搞定 openclaw pairing approve openclaw-wecom 你的配对码

步骤5：完成机器人创建

回到企业微信机器人配置页，点击保存并创建，关联完成！

方案B：云端部署关联（24小时在线，稳定不卡顿）

1. 登录腾讯云OpenClaw实例 → 进入应用管理 → 找到Channels（通道）
2. 选择企微机器人（长连接），粘贴之前保存的Bot ID和Secret，点击添加并应用
3. 返回实例管理页，点击重启OpenClaw服务，等待10秒让配置生效
4. 和本地步骤一样，完成用户配对授权，再回企微保存机器人即可

五、验证是否对接成功（一看便知）

1. 打开企业微信，给机器人发消息：你是谁
2. 机器人正常回复AI助手相关内容，说明对接完全成功
3. 如果不回话：检查密钥是否输错、网关终端是否关闭、配对是否成功、企微账号是否是管理员

六、进阶小设置（新手可选，提升体验）

6.1 开机自启（不用每次手动开服务）

本地/云端通用，设置后重启设备自动运行OpenClaw：

openclaw service enable

6.2 服务启停命令（日常维护）

# 停止OpenClaw服务（机器人暂时下线）
openclaw gateway stop
# 重启服务（改配置后必执行）
openclaw gateway restart

6.3 查看日志（排查报错）

机器人异常时用，看具体报错原因：

openclaw logs

OpenClaw+企微机器人 小白命令速查表（直接复制）

使用说明：对着场景复制命令，替换【】里的内容，粘贴到终端回车即可，不用记语法！

第一部分：环境核查+安装命令

第二部分：企微对接核心命令（最常用）

第三部分：服务管理命令

七、小白高频问题终极解决

• 机器人发消息不回：网关终端关了→重新启动网关；没配对→重新执行配对命令；密钥输错→重新配置渠道
• 终端提示命令不存在：没装Node.js/版本太低；没重启终端；环境变量没配置
• 插件装不上：切换npm镜像；用备用插件命令；检查网络是否正常
• 本地机器人一关电脑就掉线：配置开机自启；换成云端部署
• 找不到企微智能机器人：账号不是管理员；客户端版本太旧；去应用市场手动添加