OpenClaw 微信插件完整部署指南（2026 最新版）

📋 本文档详细介绍如何将 OpenClaw 接入微信，实现 AI 助理 7×24 小时在线服务。支持两种方案：官方 ClawBot（免费简单）和第三方 wechat 插件（功能完整）。

📖 目录

🛠️ 前置准备

1. 安装 OpenClaw

# 使用 npm 安装（推荐）
npm install -g openclaw@latest

# 或使用 pnpm
pnpm add -g openclaw@latest

2. 启动 OpenClaw

# 启动网关服务
openclaw gateway start

# 查看状态
openclaw gateway status

3. 确认版本

openclaw --version
# 建议版本：0.5.0+

4. 微信版本要求

  • iOS: 8.0.70 及以上
  • Android: 最新版本

📱 方案一：官方 ClawBot 插件（推荐⭐）

优点

  • ✅ 官方支持，安全可靠
  • ✅ 一条命令安装
  • ✅ 扫码即连，无需复杂配置
  • ✅ 完全免费

限制

  • ⚠️ 仅支持私聊，暂不支持群聊
  • ⚠️ 多媒体推送功能有限

安装步骤

步骤 1：安装 CLI 工具

打开终端（PowerShell/CMD/Terminal），执行：

npx -y @tencent-weixin/openclaw-weixin-cli@latest install
步骤 2：微信内配置
  1. 打开手机微信
  2. 点击 我 → 设置 → 插件
  3. 找到 「ClawBot」 卡片，点击进入
  4. 扫描二维码完成配对
    如果未出现二维码 在个人终端重新输入
openclaw channels login --channel openclaw-weixin
步骤 3：验证连接

在微信聊天窗口发送测试消息：

你好

如果收到 AI 回复，说明连接成功！

步骤 4：查看频道状态

访问 OpenClaw 后台查看频道状态：

openclaw status

或在配置目录查看 ~/.openclaw/openclaw.json 中的 channels 配置。

🔧 方案二：第三方 wechat 插件

优点

  • ✅ 支持主动推送图片、文件、视频
  • ✅ 功能更完整
  • ✅ 可定制性强

限制

  • ⚠️ 需要收费获取 ROBOTID 和 Token
  • ⚠️ 配置相对复杂

安装步骤

步骤 1：获取插件文件

从龙虾开发者社区或相关渠道获取 wechat 插件包，解压到：

~/.openclaw/extensions/wechat/
步骤 2：安装依赖
cd ~/.openclaw/extensions/wechat/
npm install
步骤 3：获取凭证

访问 https://www.wechatbot.online 获取：

  • ROBOTID（收费）
  • Authorization Token（收费）
步骤 4：配置 openclaw.json

编辑 ~/.openclaw/openclaw.json，进行三处修改：

① 在 channels 中配置 wechat 通道：

"channels": {
  "wechat": {
    "enabled": true,
    "accounts": {
      "default": {
        "robotId": "你的 ROBOTID",
        "authorization": "你的 Authorization Token",
        "serverIp": "124.223.95.144",
        "serverPort": 5555,
        "apiHost": "124.221.45.58"
      }
    }
  }
}

② 在 plugins.allow 列表中添加 wechat：

"plugins": {
  "allow": ["feishu", "wechat"]
}

③ 在 plugins.entries 中启用 wechat：

"entries": {
  "feishu": { "enabled": true },
  "wechat": { "enabled": true }
}
步骤 5：调整工具权限

在 OpenClaw 配置中将工具执行权限设置为 完整模式，以支持主动推送多媒体内容。

步骤 6：重启 OpenClaw
# 如果使用进程保护启动
openclaw daemon restart

# 如果普通启动
openclaw gateway restart
# 或
openclaw gateway stop
openclaw gateway start
步骤 7：安装必要技能
clawhub install summarize
clawhub install tavily-search
clawhub install self-improving
clawhub install skill-vetter

⚙️ 配置详解

openclaw.json 完整示例

{
  "channels": {
    "wechat": {
      "enabled": true,
      "accounts": {
        "default": {
          "robotId": "YOUR_ROBOT_ID",
          "authorization": "YOUR_AUTH_TOKEN",
          "serverIp": "???",
          "serverPort": 5555,
          "apiHost": "？？？"
        }
      }
    },
    "feishu": {
      "enabled": true
    }
  },
  "plugins": {
    "allow": ["feishu", "wechat"],
    "entries": {
      "feishu": { "enabled": true },
      "wechat": { "enabled": true }
    }
  },
  "models": {
    "default": "bailian/qwen3.5-plus"
  }
}

环境变量配置

创建或编辑 ~/.openclaw/.env：

# CSDN 发布凭证（可选）
CSDN_USERNAME=your_username
CSDN_PASSWORD=your_password

# 其他服务凭证
# ...

❓ 常见问题

Q1: 扫码后无法连接？

解决方案：

  1. 确认 OpenClaw 服务正在运行
  2. 检查微信版本是否为最新
  3. 尝试重启 OpenClaw：openclaw gateway restart
  4. 检查网络连接

Q2: 收不到 AI 回复？

解决方案：

  1. 检查 openclaw.json 中 channels 配置是否正确
  2. 确认模型配置有效
  3. 查看日志：openclaw gateway logs
  4. 验证 API 凭证是否过期

Q3: 无法发送图片/文件？

解决方案：

  1. 确保工具权限设置为完整模式
  2. 安装必要的技能包
  3. 第三方插件需要正确的 ROBOTID 和 Token
  4. 官方 ClawBot 暂不支持完整多媒体推送

Q4: 如何查看日志？

# 查看实时日志
openclaw gateway logs --follow

# 查看最近 100 行
openclaw gateway logs --lines 100

Q5: 如何更新插件？

# 官方 ClawBot
npx -y @tencent-weixin/openclaw-weixin-cli@latest update

# 第三方插件
cd ~/.openclaw/extensions/wechat/
git pull  # 如果是 git 安装
npm install

🚀 技能扩展

推荐安装的 Skills

# 搜索技能
clawhub install tavily-search

# 摘要技能
clawhub install summarize

# 写作助手
clawhub install ai-writing-assistant-cn

# 自我改进
clawhub install self-improving

# 技能审查
clawhub install skill-vetter

# 浏览器自动化
clawhub install agent-browser

查看已安装技能

clawhub list

更新所有技能

clawhub update --all

📊 方案对比总结

特性 官方 ClawBot 第三方 wechat 插件
安装难度 ⭐ 极简 ⭐⭐⭐ 中等
费用 免费 收费
配置复杂度 低 高
多媒体推送 有限 完整支持
群聊支持 ❌ 需确认
官方支持 ✅ ❌
适合人群 普通用户 高级用户/开发者

🎯 快速开始建议

新手用户： 选择官方 ClawBot，5 分钟即可完成配置

高级用户： 选择第三方 wechat 插件，获得完整功能

企业用户： 考虑企业微信集成方案

📚 参考资源

📝 更新日志

  • 2026-03-25: 初版发布，包含两种完整部署方案
  • 后续将根据官方更新持续维护

作者: 小白 📋
生成时间: 2026-03-25
标签: OpenClaw, 微信，AI 助理，部署教程

# 微信
Logo
腾讯云开发者社区

腾讯云面向开发者汇聚海量精品云计算使用和开发经验，营造开放的云计算技术生态圈。

更多推荐

终极指南：Flink SQL连接器版本管理从混乱到有序的升级之路

Apache Flink作为流处理领域的佼佼者，其SQL连接器的版本管理一直是开发者面临的核心挑战。本文将系统讲解Flink SQL连接器版本管理的最佳实践，帮助你轻松应对版本兼容性问题，实现从混乱到有序的升级之旅。## 连接器版本管理的常见痛点 😫在Flink应用开发中，连接器版本管理常常让开发者头疼不已。不同版本的连接器可能导致各种兼容性问题，例如API变更、功能差异甚至运行时错误。

avatar 腾讯云开发者社区

Elasticsearch复杂数据类型终极指南：从入门到精通

Elasticsearch作为功能强大的搜索引擎，支持多种复杂数据类型，让开发者能够灵活处理各种结构化和非结构化数据。本文将带你全面了解Elasticsearch中的复杂数据类型，从基础概念到实际应用，助你轻松掌握数据建模的核心技巧。## 内部对象：构建层级化数据结构在Elasticsearch中，对象类型（Object）是最基础的复杂数据类型之一，用于表示具有嵌套关系的数据。例如，我们可

avatar 腾讯云开发者社区

如何快速搭建Neon无服务器PostgreSQL：面向初学者的完整指南

Neon是一款革命性的无服务器PostgreSQL解决方案，它通过分离存储和计算层，实现了自动扩缩容、类代码式数据库分支以及零级扩展能力。本指南将帮助你从零开始搭建Neon开发环境，体验这款创新数据库的强大功能。## 准备工作：环境要求与依赖项在开始搭建Neon环境前，请确保你的系统满足以下要求：- Linux操作系统（推荐Ubuntu 20.04+或Debian 11+）- Git

avatar 腾讯云开发者社区