微信接入 OpenClaw

本章节介绍如何将 OpenClaw 接入微信平台。

一、前置操作

在灵镜云官网（https://www.ljyun.cn (opens in a new tab) ） 创建 OpenClaw 实例，并进入实例管理界面。

二、微信官方插件入口及推荐的接入方式

入口：我 - 设置 - 插件 - 微信ClawBot

推荐接入方式：点击 微信ClawBot 中的详情，即可查看接入方式。

三、具体步骤

1. 进入 JupyterLab Terminal

在实例管理界面，在实例的操作列，点击竖向的三个点，选择 JupyterLab，点击 Other-Terminal 进入后端。

2. 执行安装命令

在 Terminal 中执行以下步骤连接微信。参考微信推荐的安装方式，在步骤 1 中 Terminal 中输入或复制（使用 Ctrl+V 或 Shift + 鼠标右键，选择粘贴）以下命令，并按回车：

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

注意：该命令会安装微信的 openclaw 插件，并弹出二维码让用户登录，用户使用微信扫一扫即可登录。

回车后出现如下内容：

提示：若出现问题，可在 四、相关问题解决方案 中查看具体解决方法。

3. 扫码连接

用户使用微信扫描上方弹出来的二维码后，在手机微信中点击连接。

扫描成功后

Terminal 中显示和微信连接成功：

点击连接

用户点击连接后，会自动跳转到和微信ClawBot的聊天界面中，可以进行后续使用：

四、相关问题的解决方案

1. 输入 npx -y @tencent-weixin/openclaw-weixin-cli@latest install 后没有弹出二维码

可能存在如下问题：

1.1 提示缺少飞书相关插件

问题现象：使用 npx -y 命令安装微信插件时，提示缺少飞书相关的模块，提示类似：

feishu failed to load from /usr/lib/node_modules/openclaw/dist/extensions/feishu/index.js:
Error: Cannot find module '@larksuiteoapi/node-sdk'

解决方案：全局安装相关模块即可。然后再次执行 npx -y 命令进行安装：

npm install -g @larksuiteoapi/node-sdk

1.2 首次连接未完成

问题现象：输入上述命令后，出现 插件就绪，开始首次连接 ...，首次连接未完成，可稍后手动重试 等字样，并给出一条重试命令。

解决方案：在 Terminal 中复制并粘贴给出的重试命令。也可复制下方命令粘贴到 Terminal 中：

openclaw channels login --channel openclaw-weixin

1.3 其他错误

问题现象：若未出现上述的情况，而是其他错误，一般认为是安装时网络波动等因素导致安装过程产生了错误。

解决方案：再次执行 三、具体步骤中的第 2 步，再次进行安装即可。

2. 输入 npx -y @tencent-weixin/openclaw-weixin-cli@latest install 并弹出二维码后不想扫码登录了

解决方案：

1. 使用 Ctrl + C 中断此次连接
2. 后续再次想登录时，使用如下命令即可：

openclaw channels login --channel openclaw-weixin

3. 输入 npx -y @tencent-weixin/openclaw-weixin-cli@latest install 并弹出二维码，微信扫码后和 AI 聊天没有回应

问题现象：微信扫码后和 AI 聊天没有回应。

解决方案：此时有可能是 OpenClaw 的热重启没有完全加载微信的相关插件，在 Terminal 中执行 /restart.sh 重启 OpenClaw，后续等待几秒钟后重试聊天即可。

/restart.sh

4. 输入 openclaw channels login --channel openclaw-weixin 出现 Channel login failed

问题现象：出现 Channel login failed: Error: Unsupported channel: openclaw-weixin 报错。

解决方案：该问题说明相关插件还未安装，再次执行 三、具体步骤中的第 2 步，进行安装即可。

5. 输入 openclaw channels login --channel openclaw-weixin 出现 feishu failed to load

问题现象：出现 feishu failed to load from /usr/lib/node_modules/openclaw/dist/extensions/feishu/index.js: Error: Cannot find module '@larksuiteoapi/node-sdk'。

解决方案：全局安装相关模块即可。然后再次执行 login 命令进行登录：

npm install -g @larksuiteoapi/node-sdk