微信clawbot插件连接openclaw全过程详细

微信 ClawBot 插件连接 OpenClaw 全过程详细

目标：在已经安装了 OpenClaw 的服务器上，通过插件把个人微信接入 OpenClaw，实现微信 AI 助手。

核心原理：微信没有官方的 Bot API，所以通过第三方协议（ilink）中转。OpenClaw 的 openclaw-weixin 插件负责这个中转。

⚠️ 本文所有 IP、域名、API Key 均为示例，请替换为你自己的实际信息。

〇、OpenClaw 可以放在哪？

很多人以为「要装个 Bot 就必须租云服务器」，其实关键看连接方式：

企业微信 vs 个人微信 连接方式完全不一样

企业微信（之前的 ClawBot） 个人微信（OpenClaw）
谁来发起连接 企业微信找你 ← 它主动访问你的服务器 你找微信 → OpenClaw 主动连微信服务器
需要公网IP？ ✅ 必须（企业微信要能访问到你的机器） ❌ 不需要
需要备案域名？ ✅ 必须 ❌ 不需要
可以放本地？ ❌ 不行，本地没有公网IP和备案域名 ✅ 完全可以

为什么会有这个区别？

  • 企业微信的回调机制：当有人给 Bot 发消息，企业微信服务器要把消息推送到你的服务器，所以你的服务器必须有公网IP、备案域名、HTTPS。
  • 个人微信的 ilink 协议：OpenClaw 启动后主动去连微信的 ilink 服务器，建立一条长连接，消息从这条管道走。微信不需要知道你的IP在哪。

可选部署方案

方案 优点 缺点
✅ 腾讯云/阿里云 稳定，24小时在线 花钱（最低几十/月）
✅ 家里旧电脑/笔记本 不额外花钱 不能断网断电关机
✅ 树莓派 功耗低、省电 性能一般
✅ 你本机 Windows 现成的，装个 Node.js 就行 关机就用不了
⚠️ MUSE Pi Pro (RISC-V) 也是台电脑 Node.js 可能没 RISC-V 版本

本地 Windows 安装 OpenClaw

# 以管理员身份运行 PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

# 后续步骤一样：配置 DeepSeek Key、扫码绑定微信

我推荐怎么放？

场景一：想要 24 小时在线，随时能聊
→ 放云服务器 / 家里不关机的旧电脑

场景二：先玩玩，不一定一直用
→ 放本地电脑，想用的时候开一下

场景三：省服务器钱
→ 搬回家里的树莓派或旧笔记本上

一、什么是 OpenClaw？

OpenClaw 是一个开源的个人 AI 助手平台。可以理解为一个「AI 中间件」：

你的微信 → OpenClaw Gateway → AI 模型 (DeepSeek)
                    ↓
       插件系统 (微信、飞书、钉钉、Discord...)

它做什么：

  • 接收消息 — 通过插件连接各种聊天平台
  • 调用 AI — 把消息发给 DeepSeek 等模型
  • 扩展能力 — 通过 Skill 系统加功能（搜索、读文件、定时任务等）

二、链路全景

你的手机微信
    │
    ▼ 发送消息
第三方微信网关 (ilinkai.weixin.qq.com)
    │ 微信没有官方 Bot API，通过 ilink 协议中转
    ▼ WebSocket 长连接
腾讯云服务器 :37051
    │
    ├─ OpenClaw Gateway (核心进程)
    │   │
    │   ├─ openclaw-weixin 插件 ← 你扫码绑定的就是这个
    │   │   │                  微信认证凭证存在 ~/.openclaw/openclaw-weixin/accounts/
    │   │   │
    │   │   └─ 收到消息 → 触发 AI 推理
    │   │
    │   └─ 返回回复 → weixin 插件 → ilink → 你手机
    │
    └─ DeepSeek API (api.deepseek.com)
        模型: deepseek-v4-pro
        API Key 存在 OpenClaw 配置中

三、一步步是怎么搭的

3.1 安装 Node.js（OpenClaw 的运行环境）

OpenClaw 是用 JavaScript 写的，需要 Node.js 来跑。

# 安装 Node.js 22（OpenClaw 要求 >= 22）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node --version  # 应该显示 v22.x.x

3.2 安装 OpenClaw

sudo npm install -g openclaw

npm 是 Node.js 的包管理器（类似 Python 的 pip），-g 表示全局安装。

验证版本：

openclaw --version
# OpenClaw 2026.6.6 (8c802aa)

3.3 安装微信插件

OpenClaw 的核心是插件系统。要连微信就要装 openclaw-weixin 插件：

openclaw plugins install @tencent-weixin/openclaw-weixin --force

@tencent-weixin/openclaw-weixin 是插件名，--force 表示如果已存在就覆盖安装。

3.4 配置 DeepSeek 为 AI 模型

OpenClaw 支持多种 AI 模型提供商，包括 DeepSeek：

# 第一步：把 DeepSeek API Key 存进去
echo 'sk-你的key' | openclaw models auth paste-api-key --provider deepseek

# 第二步：设置默认模型
openclaw config set agents.defaults.model 'deepseek/deepseek-v4-pro'

为什么这样就能用？ 因为 OpenClaw 内置了一个模型列表，你 openclaw models list 就能看到：

deepseek/deepseek-v4-pro    text    195k    no    no    default

这个表告诉 OpenClaw：DeepSeek 支持哪些模型、输入类型（text）、上下文长度（195k tokens）。OpenClaw 知道怎么跟 DeepSeek API 通信，你只需要提供 Key。

3.5 扫码绑定微信

openclaw channels login --channel openclaw-weixin

执行后终端会出现一个二维码。用手机微信扫码（不是企业微信，是个人微信）。

扫码后发生了什么：

1. 你的微信扫了二维码
2. 微信服务器生成了一个「Bot 身份」→ `YOUR_WECHAT_BOT_ID`
3. 这个 Bot 跟你的服务器建立了一条 WebSocket 长连接
4. 以后发的消息都会通过这条连接转发到服务器
5. 认证凭证保存在 ~/.openclaw/openclaw-weixin/accounts/

什么是 WebSocket 长连接？ 普通的 HTTP 请求是「你问一句我答一句」，每次都要重新建立连接。WebSocket 是一条一直保持畅通的管道，微信消息随时流过来，服务器回复也随时流回去，延迟低。

3.6 配置开机自启

服务器重启后要让 OpenClaw 自动起来：

openclaw gateway install --force   # 安装 systemd 服务
systemctl --user enable openclaw-gateway.service  # 启用开机自启
systemctl --user start openclaw-gateway.service   # 立即启动

systemd 是什么？ Ubuntu 系统的「服务管理器」，负责管理后台进程。用它管理 OpenClaw 后，系统就会：

  • 开机自动启动 OpenClaw
  • 如果 OpenClaw 崩溃了，自动重启
  • 记录了所有日志，方便排查问题

四、OpenClaw 的核心概念

4.1 Gateway（网关）

OpenClaw 的核心进程，负责：

  • 监听 37051 端口
  • 管理插件生命周期
  • 调度 AI 推理
  • 维护微信连接

4.2 Plugin（插件）

每个聊天平台对应一个插件：

插件 连接平台
openclaw-weixin 个人微信
wecom-wecom-openclaw-plugin 企业微信
dingtalk-real-ai-dingtalk-connector 钉钉
larksuite-openclaw-lark 飞书
openclaw-discord Discord
openclaw-qqbot QQ

4.3 Skill（技能）

除了聊天，OpenClaw 还能扩能力。这台服务器上有 46 个 Skills：

  • web_search — 搜索互联网
  • web_fetch — 读取网页
  • cron — 定时任务
  • exec — 执行命令
  • read/write — 读写文件
  • 等等

你发「帮我搜一下...」时，OpenClaw 的 AI 会自动决定用哪个 Skill。

4.4 配置存储

所有配置存在 ~/.openclaw/openclaw.json，包括：

  • 端口、IP 绑定
  • AI 模型设置
  • 插件启停
  • 运行版本记录

五、文件结构

~/.openclaw/
├── openclaw.json                 # 主配置文件（AI 模型、端口、插件等）
│
├── openclaw-weixin/
│   ├── accounts.json             # 微信账号列表
│   └── accounts/
│       └── YOUR_WECHAT_BOT_ID.json  # 微信 Bot 认证凭证
│
├── npm/projects/                 # 所有插件的代码
│   ├── tencent-weixin-openclaw-weixin-.../   # 微信插件
│   ├── wecom-wecom-openclaw-plugin-.../      # 企业微信插件
│   └── ...
│
├── credentials/                  # 各种 API Key（如未创建则不存在）
├── memory/                       # OpenClaw 的记忆存储
├── logs/                         # 稳定性日志
└── state/                        # 会话状态

~/.config/systemd/user/
└── openclaw-gateway.service      # systemd 服务定义

/tmp/openclaw/
└── openclaw-2026-06-13.log       # 运行日志（每次重启追加）

六、常用命令速查

# 查看整体状态
openclaw gateway status
systemctl --user status openclaw-gateway.service

# 实时查看日志
journalctl --user -u openclaw-gateway.service -f

# 重启 OpenClaw
systemctl --user restart openclaw-gateway.service

# 切换 AI 模型
openclaw config set agents.defaults.model 'deepseek/deepseek-v4-pro'
openclaw config set agents.defaults.model 'deepseek/deepseek-v4-flash'

# 查看所有可用模型
openclaw models list

# 重新扫码绑定微信（换号时用）
openclaw channels login --channel openclaw-weixin

# 进入管理面板
openclaw dashboard
# 或者浏览器打开 http://服务器IP:37051/

七、常见问题

Q: 扫码后显示「已连接过此 OpenClaw，无需重复连接」

不需要重新扫码，认证凭证已经保存在 accounts/ 目录了。

Q: 换个手机登录微信，Bot 还能用吗？

Bot 是跟微信账号绑定的，不是跟手机。只要还是同一个微信号，扫码一次就永久有效。

Q: 换个服务器需要重新做哪些？

全部重做一遍。因为：

  • OpenClaw 要重新装
  • 微信要重新扫码（新的 Bot ID）
  • DeepSeek Key 不用换

可以用之前写的 deploy-openclaw.sh 一键安装。

Q: OpenClaw 日志在哪里看？

有两个地方：

  • journalctl --user -u openclaw-gateway.service -f — systemd 日志
  • /tmp/openclaw/openclaw-*.log — 详细日志文件

一句话总结：OpenClaw = 一个「AI 消息中转站」。它通过插件连上你的微信，收到消息后转给 DeepSeek 处理，再把回复发回微信。你要做的就是装好它、配个 Key、扫个码，后面就不用管了。

posted @ 2026-06-13 11:53  Gaooooo  阅读(51)  评论(0)    收藏  举报