openClaw对接个人微信教程（openclaw-wechat）

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

???? 这份指南将手把手带你完成 OpenClaw 与微信的对接，实现一个7×24小时在线的AI助理。目前主流有两种方案：官方的 ClawBot（免费且简单）和第三方的 wechat 插件（功能更完整），你可以根据自己的需求选择。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

???? 目录

• 前置准备
• [方案一：官方 ClawBot 插件（推荐）](#方案一官方-clawbot-插件推荐)
• [方案二：第三方 wechat 插件](#方案二第三方-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 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 通道：
将获取到的 ROBOTID 和 Token 填入对应位置。

"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：
将 wechat 插件的 enabled 设置为 true。

"entries": {
  "feishu": { "enabled": true },
  "wechat": { "enabled": true }
}

步骤 5：调整工具权限

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

步骤 6：重启 OpenClaw

配置修改后，务必重启服务使其生效：

# 如果使用进程保护启动
openclaw daemon restart

# 如果普通启动
openclaw gateway restart
# 或
openclaw gateway stop
openclaw gateway start

步骤 7：安装必要技能

为了让AI助理更聪明，建议安装一些基础技能包：

clawhub install summarize
clawhub install ta vily-search
clawhub install self-improving
clawhub install skill-vetter

⚙️ 配置详解

为了让你更清晰地理解整个配置结构，这里提供一个 openclaw.json 的完整示例，特别是包含了 wechat 通道的配置。

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 网关服务正在运行（openclaw gateway status）
2. 检查手机微信版本是否为最新
3. 尝试重启 OpenClaw 服务：openclaw gateway restart
4. 检查电脑和手机是否在同一网络环境下

Q2: 收不到 AI 回复？

解决方案：

1. 检查 openclaw.json 中 channels 配置是否正确，特别是 robotId 和 token
2. 确认 models 配置中的默认模型是否有效可用
3. 查看服务日志寻找错误信息：openclaw gateway logs
4. 验证第三方插件的 API 凭证是否已过期

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

解决方案：

1. 确保 OpenClaw 的工具权限已设置为“完整模式”
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

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

???? 技能扩展

基础的AI助理搭好了，如何让它变得更强大？答案是安装更多的“技能”。

推荐安装的 Skills

下面这些技能可以大幅提升助理的能力：

# 搜索技能：让AI能联网搜索
clawhub install ta vily-search

# 摘要技能：快速总结长文本
clawhub install summarize

# 写作助手：辅助中文写作
clawhub install ai-writing-assistant-cn

# 自我改进：让AI优化自己的回答
clawhub install self-improving

# 技能审查：管理其他技能
clawhub install skill-vetter

# 浏览器自动化：模拟网页操作
clawhub install agent-browser

查看已安装技能

clawhub list

更新所有技能

clawhub update --all

???? 方案对比总结

为了帮你快速决策，两种方案的核心区别对比如下：

???? 快速开始建议

根据你的身份和需求，可以这样选择：

• 新手用户：无脑选择官方 ClawBot，5 分钟搞定，先跑起来再说。
• 高级用户：直接上第三方 wechat 插件，功能全面，可玩性高。
• 企业用户：可以进一步调研企业微信的集成方案，满足合规和协作需求。

???? 参考资源

• OpenClaw 官方文档
• ClawHub 技能市场
• 龙虾开发者社区
• GitHub 仓库
• Discord 社区

???? 更新日志

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

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