Channel Wukongim

Name: Channel Wukongim
Rating: 3.5 (1 reviews)
Author: cjs1050

By cjs1050 👁 43 views ▲ 0 votes

悟空IM channel plugin for OpenClaw — 通过 WebSocket 长连接接入悟空IM，**无需公网 IP** Stream 模式。

GitHub

Install

npm install

#

Configuration Example

{
  "channels": {
    "wukongim": {
      "enabled":     true,
      "wsAddr":      "ws://your-wukongim-server",
      "botUid":      "bot001",
      "botToken":    "my-bot-token-123",
      "dmPolicy":    "open",
      "groupPolicy": "off",
      "debug":       false
    }
  }
}

README

# openclaw-channel-wukongim

悟空IM channel plugin for OpenClaw — 通过 WebSocket 长连接接入悟空IM，**无需公网 IP** Stream 模式。

## 原理

```
用户（悟空IM 客户端）
       ↕ 长连接
  悟空IM Server（公共服务器）
       ↕ WebSocket 长连接（插件主动发起）
  OpenClaw + 本插件（用户自己的机器）
       ↕
  OpenClaw AI Agent
```

插件主动连接悟空IM Server，不需要公网 IP，和 Telegram Bot 原理一样。

---

## 安装


**安装插件**

```bash
# 克隆或下载本插件
git clone https://github.com/cjs1050/openclaw-channel-wukongim.git

# 安装依赖
cd openclaw-channel-wukongim
npm install

# 安装到 OpenClaw（链接模式，方便开发调试）
openclaw plugins install -l .

```

**：配置 `~/.openclaw/openclaw.json`**

```json
{
  "channels": {
    "wukongim": {
      "enabled":     true,
      "wsAddr":      "ws://your-wukongim-server",
      "botUid":      "bot001",
      "botToken":    "my-bot-token-123",
      "dmPolicy":    "open",
      "groupPolicy": "off",
      "debug":       false
    }
  }
}
```

**第四步：重启 Gateway**

```bash
openclaw gateway restart
```

查看日志确认连接成功：

```bash
openclaw logs | grep wukongim
# [wukongim] ✅ 认证成功，机器人 bot001 已上线
```

**第五步：用悟空IM 客户端发消息**

在悟空IM 客户端找到 `bot001`，发一条消息，即可收到 AI 回复。

---

## 配置项说明

| 字段          | 类型    | 必填 | 说明                              |
|---------------|---------|------|-----------------------------------|
| `enabled`     | boolean | 否   | 是否启用，默认 true               |
| `wsAddr`      | string  | ✅   | 悟空IM WebSocket 地址 |
| `botUid`      | string  | ✅   | 机器人 UID                        |
| `botToken`    | string  | ✅   | 机器人 Token                      |
| `dmPolicy`    | string  | 否   | 私聊策略：`open` / `allowlist`    |
| `groupPolicy` | string  | 否   | 群聊策略：`open` / `allowlist` / `off`（默认 off）|
| `allowFrom`   | array   | 否   | 白名单 UID 列表                   |
| `debug`       | boolean | 否   | 是否开启调试日志                  |

---

## 常见问题

**Q: 连接失败 / 一直重连？**
- 检查 `wsAddr` 是否正确
- 检查 `botUid` 和 `botToken` 是否已在悟空IM 注册

**Q: 发消息没有回复？**
- 查看日志：`openclaw logs | grep wukongim`
- 确认机器人已注册为系统账号（否则会触发消息回环）

**Q: 群聊不响应？**
- 把 `groupPolicy` 改为 `"open"`
- 把机器人加入群聊

## License

MIT

channels