基于 OpenClaw 与微信实现 AI 自动回复接入指南

2. 获取 Token

登录服务并完成绑定，获取 token。请将配置文件复制到 ~/.openclaw/openclaw.json。

{
  "channels": {
    "synodeai": {
      "enabled": true,
      "token": "<your-token>",
      "webhookHost": "0.0.0.0",
      "webhookPort": 4399,
      "webhookPath": "/webhook",
      "autoQuoteReply": false,
      "allowFrom": [],
      "dmPolicy": "open",
      "groupPolicy": "open",
      "groups": {
        "*": {
          "trigger": { "mode": "at" },
          "reply": { "mode": "quote_source" }
        }
      }
    }
  }
}

3. 配置 Webhook

Webhook 是服务将微信消息推送到你本地 OpenClaw 的入口地址，必须公网可访问。如在本地环境使用，推荐用 ngrok 做内网穿透。

安装 ngrok

brew install ngrok

配置 token

注册 ngrok 后获取 token，然后执行：

ngrok config add-authtoken YOUR_TOKEN

启动穿透

ngrok http 4399

你会看到类似输出：

https://xxxx.ngrok-free.app -> http://localhost:4399

这个 https://xxxx.ngrok-free.app 就是你的公网地址。

4. 填写 Webhook 并启动

把上一步的公网地址按下面格式填写到服务后台：

https://xxxx.ngrok-free.app/webhook

最后启动 OpenClaw：

openclaw start

5. 验证

向机器人发一条微信消息验证，包括：

• 私聊直接发消息
• 群聊中 @机器人
• 群聊中引用机器人上一条消息继续追问

正确顺序建议为：登录服务 → 安装 OpenClaw plugin → 复制 json 配置文件 → 配置 ngrok 拿到公网地址 → 填写 webhook → 启动 openclaw start。

高级配置

群聊 / 私聊触发与回复规则

groups 和 dms 都支持 * 默认项 + 精确项覆写。

群聊触发 groups[*].trigger.mode 支持：

• at：只有被 @ 时触发
• quote：只有引用机器人消息时触发
• at_or_quote：@ 或引用机器人消息都触发
• any_message：任何消息都触发

群聊默认值是 at。

群聊回复 groups[*].reply.mode 支持：

• plain：普通回复
• quote_source：首条回复自动引用当前入站消息
• at_sender：首条文本回复自动 @ 发送者
• quote_and_at：首条文本回复同时引用并 @

群聊默认值会跟随 autoQuoteReply。

私聊触发与回复 dms[*].trigger.mode 支持 any_message 或 quote。 dms[*].reply.mode 支持 plain 或 quote_source。

绑定到 Agent / ACP

除了 channels.synodeai 这一段插件配置，还支持配合 OpenClaw 顶层 bindings[] 使用。

绑定到普通 Agent

{
  "bindings": [
    {
      "type": "route",
      "agentId": "ops",
      "match": {
        "channel": "synodeai",
        "accountId": "work",
        "peer": { "kind": "group", "id": "ops-room@chatroom" }
      }
    }
  ],
  "channels": {
    "synodeai": {
      "accounts": {
        "work": {
          "groups": {
            "ops-room@chatroom": {
              "trigger": { "mode": "at_or_quote" },
              "reply": { "mode": "quote_and_at" }
            }
          }
        }
      }
    }
  }
}

绑定到 ACP 持久会话

{
  "bindings": [
    {
      "type": "acp",
      "agentId": "codex",
      "match": {
        "channel": "synodeai",
        "accountId": "work",
        "peer": { "kind": "group", "id": "repo-room@chatroom" }
      },
      "acp": {
        "label": "repo-room",
        "mode": "persistent",
        "cwd": "/workspace/repo-a",
        "backend": "acpx"
      }
    }
  ]
}

群里的绑定身份

groups.<groupId>.bindingIdentity 用来描述机器人在群里显示成什么样。当前只同步两项：机器人自己的群昵称 selfNickname 和备注 remark。

{
  "channels": {
    "synodeai": {
      "groups": {
        "*": {
          "bindingIdentity": {
            "enabled": true,
            "selfNickname": { "source": "agent_name" },
            "remark": { "source": "agent_id" }
          }
        }
      }
    }
  }
}

富消息与消息复用

除了直接构造 channelData["synodeai"]，也可以通过共享 message 工具走标准动作：send、reply、unsend。

示例：在当前群里回复并做部分引用

{
  "action": "reply",
  "message": "收到，我接着处理",
  "synodeai": {
    "quote": { "partialText": "需要继续跟进的那一段" }
  }
}

示例：撤回一条已经发出的消息

{
  "action": "unsend",
  "to": "ops-room@chatroom",
  "messageId": "10001",
  "newMessageId": "10002",
  "createTime": "1710000002"
}

插件支持通过 channelData["synodeai"] 传入专有消息语义，结构如下：

• appMsg：直接发送 <appmsg> XML
• quoteReply：发送引用回复
• emoji：发送表情
• nameCard：发送名片
• miniApp：发送小程序
• revoke：撤回指定消息
• forward：复用已存在消息 XML 进行二次转发

如果希望让模型主动发'部分引用'，通道会识别回复末尾的一行隐藏指令：

[[GEWE_QUOTE_PARTIAL:要引用的原文片段]]

插件会在发送前剥离这行指令，并自动转成 quoteReply.partialText。

依赖

npm 依赖

• zod

peer 依赖

• openclaw (>= 2026.1.29)

系统级工具

• ffmpeg / ffprobe（用于视频缩略图与时长）
• rust-silk（出站语音转 silk + 入站语音解码；支持自动下载）

网络 / 服务依赖

• 服务 API 服务
• Webhook 回调需要公网可达（可配合 FRP）
• 媒体对外地址（mediaPublicUrl）

源码地址：https://github.com/Devo919/openclaw-wechat-channel