小M-Quartz

【工具】OpenClaw 微信接入本地部署教程

4分钟阅读

OpenClaw 微信接入本地部署教程

本文档介绍如何在本地安装 OpenClaw，并通过微信扫码接入，实现微信端的 AI 助手功能。

本文部分内容由 AI 生成，经人工修订。

前置条件

  • Windows 10/11 操作系统
  • Node.js 18+ (推荐使用 nvm 管理)
  • 稳定的网络连接
  • 微信账号（用于扫码登录）

一、安装 OpenClaw

1.1 使用 npm 全局安装

npm install -g openclaw

1.2 验证安装

openclaw --version
openclaw status

二、安装微信扩展

OpenClaw 的微信接入需要安装 openclaw-weixin 扩展。

2.1 扩展安装位置

扩展默认安装在用户目录下：

C:\Users\<用户名>\.openclaw\extensions\openclaw-weixin\

2.2 配置扩展

编辑 OpenClaw 配置文件 ~/.openclaw/openclaw.json，添加微信渠道配置：

{
  "channels": {
    "openclaw-weixin": {
      "baseUrl": "https://ilinkai.weixin.qq.com"
    }
  }
}

或使用 CLI 命令配置：

openclaw config set channels.openclaw-weixin.baseUrl "https://ilinkai.weixin.qq.com"

三、扫码登录微信

3.1 启动 Gateway 服务

openclaw gateway start

3.2 发起微信登录

openclaw openclaw-weixin login

命令执行后会显示二维码链接和终端二维码。

3.3 扫码授权

  1. 打开微信，扫描终端显示的二维码
  2. 或复制二维码链接到浏览器打开后扫码
  3. 在微信中确认授权

3.4 登录成功

扫码确认后，系统会显示：

✅ 与微信连接成功！

登录信息会保存在：

C:\Users\<用户名>\.openclaw\openclaw-weixin\accounts\<account-id>.json

四、配置说明

4.1 账户配置文件结构

{
  "token": "xxx@im.bot:xxx",
  "savedAt": "2026-03-27T10:24:24.914Z",
  "baseUrl": "https://ilinkai.weixin.qq.com",
  "userId": "xxx@im.wechat"
}

4.2 多账户配置

支持配置多个微信账户，在配置文件中添加 accounts 字段：

{
  "channels": {
    "openclaw-weixin": {
      "baseUrl": "https://ilinkai.weixin.qq.com",
      "accounts": {
        "account1": {
          "enabled": true
        },
        "account2": {
          "enabled": false
        }
      }
    }
  }
}

4.3 可选配置项

配置项说明默认值
baseUrl微信服务 API 地址https://ilinkai.weixin.qq.com
cdnBaseUrlCDN 基础地址-
routeTag路由标签-
logUploadUrl日志上传地址-

五、使用说明

5.1 发送消息测试

登录成功后，可以通过微信向机器人发送消息进行测试。

5.2 查看状态

openclaw status

5.3 查看日志

openclaw logs --tail

5.4 常用命令

# 查看 Gateway 状态
openclaw gateway status
 
# 重启 Gateway
openclaw gateway restart
 
# 查看已登录账户
openclaw openclaw-weixin accounts
 
# 退出登录
openclaw openclaw-weixin logout

六、故障排除

6.1 登录超时

问题：二维码过期或扫码超时

解决：

  • 重新执行 openclaw openclaw-weixin login
  • 确保网络连接稳定

6.2 Gateway 无法启动

问题：Gateway 启动失败

解决：

# 检查状态
openclaw doctor
 
# 查看详细日志
openclaw logs --verbose

6.3 消息无法接收

问题：微信消息无响应

解决：

  1. 确认 Gateway 正在运行
  2. 确认账户登录状态
  3. 检查网络连接

6.4 扩展未加载

问题：微信扩展未识别

解决：

  • 确认扩展目录存在
  • 重启 Gateway：openclaw gateway restart

七、安全建议

  1. 保护 token：账户 token 存储在本地配置文件中，请勿泄露
  2. 定期更新：保持 OpenClaw 和扩展版本最新
  3. 限制访问：配置 allowFrom 限制允许访问的用户 ID
  4. 日志管理：定期清理日志文件

八、相关链接

📝 注意：微信接入功能依赖 iLink 服务，请确保网络可访问 ilinkai.weixin.qq.com。

关系图谱