# wechat-access-unqclawed

OpenClaw 微信通路插件 — 通过 WeChat OAuth 扫码登录获取 token，连接 AGP WebSocket 网关收发消息。

## 功能

- 微信扫码登录（终端二维码 + 浏览器链接）
- Token 自动持久化，重启免登录
- AGP 协议 WebSocket 双向通信（流式文本、工具调用）
- 邀请码验证（可配置跳过）
- 支持生产/测试环境切换

## 安装

```bash
npm install
```

依赖 Node.js v22+，作为 OpenClaw 渠道插件运行。

## 配置

在 OpenClaw 配置文件的 `channels.wechat-access` 下：

```json
{
  "channels": {
    "wechat-access": {
      "token": "",
      "wsUrl": "",
      "bypassInvite": false,
      "environment": "production"
    }
  }
}
```

| 字段 | 类型 | 说明 |
|------|------|------|
| `token` | string | 手动指定 channel token（留空则走扫码登录） |
| `wsUrl` | string | WebSocket 网关地址（留空则使用环境默认值） |
| `bypassInvite` | boolean | 跳过邀请码验证 |
| `environment` | string | `production` 或 `test` |
| `authStatePath` | string | 自定义 token 持久化路径 |

## Token 获取策略

1. 读取配置中的 `token` — 如果有，直接使用
2. 读取本地保存的登录态（`~/.openclaw/wechat-access-auth.json`）
3. 以上都没有 — 启动交互式微信扫码登录

## 项目结构

```
index.ts                 # 插件入口，注册渠道、启停 WebSocket
auth/
  types.ts               # 认证相关类型
  environments.ts        # 生产/测试环境配置
  device-guid.ts         # 设备 GUID 生成（随机，持久化）
  qclaw-api.ts           # QClaw JPRX 网关 API 客户端
  state-store.ts         # Token 持久化
  wechat-login.ts        # 扫码登录流程编排
websocket/
  types.ts               # AGP 协议类型
  websocket-client.ts    # WebSocket 客户端（连接、心跳、重连）
  message-handler.ts     # 消息处理（调用 Agent）
  message-adapter.ts     # AGP <-> OpenClaw 消息适配
common/
  runtime.ts             # OpenClaw 运行时单例
  agent-events.ts        # Agent 事件订阅
  message-context.ts     # 消息上下文构建
http/                    # HTTP webhook 通道（备用）
```

## 协议

AGP (Agent Gateway Protocol) — 基于 WebSocket Text 帧的 JSON 消息协议，详见 `websocket.md`。

## License

MIT