<p align="center">
  <img src="https://tuitui.cn/static/img/logo.6449dfbe.svg" alt="TuiTui Logo" width="360">
</p>

# TuiTui Channel for OpenClaw

<p class="repo-badges">
  <a href="https://www.npmjs.com/package/@qihoo/tuitui-openclaw-channel"><img alt="npm version" src="https://img.shields.io/npm/v/%40qihoo%2Ftuitui-openclaw-channel"></a>
  <a href="https://www.npmjs.com/package/@qihoo/tuitui-openclaw-channel"><img alt="npm downloads" src="https://img.shields.io/npm/dm/%40qihoo%2Ftuitui-openclaw-channel"></a>
  <a href="https://github.com/openclaw/openclaw"><img alt="OpenClaw" src="https://img.shields.io/badge/OpenClaw-%3E%3D2026.3.13-0A7CFF"></a>
</p>

OpenClaw 的推推机器人 Channel 渠道插件

## 功能特性

- 支持私聊、群聊和 @机器人、团队帖子等
- 支持文本、图片、语音、视频、文件、频道帖子
- 支持多 Agent + 多机器人绑定
- 支持安全控制（私聊模式与白名单、群聊模式与白名单）
- WebSocket 订阅模式，个人电脑可用，无需 Webhook 和公网ip依赖

## 安装与配置指南

> 最小兼容版本为 `OpenClaw 2026.3.8`。

龙虾+推推插件配置指南

### 什么是龙虾推推channel插件
在openclaw上安装推推插件后，可以通过推推与你的openclaw聊天。

### 第一步、创建你的专属推推机器人
推推搜索 推推机器人助手，和它私聊。使用 /创建 可自助创建一个机器人，得到appid和secret后用。
另外你也可以对它使用 /改头像 指令。

### 第二步、安装openclaw 推推插件
在终端命令行运行命令

`openclaw plugins install @qihoo/tuitui-openclaw-channel`

如果遇到 clawHub 429 报错、npm install failed Error: package.json missing openclaw.hooks 等。
均为下载连接npm仓库不稳定导致，可以多试几次。

### 第三步、配置插件。
打开龙虾dashboard页面，频道->Tuitui，在appid和secret填入第一步获取的密钥，下方点保存。

### 第四步、与你的机器人聊天

私聊你的龙虾机器人，会提示配对。复制提示消息末尾的那行指令，龙虾主人在终端执行你复制的那行命令，然后就能聊了。

如果不想配对，可以在dashboard中把Dm Policy切换为allowlist，然后从Allow From为你的账号添加白名单。

群聊的话，你把机器人拉到群里。需要@机器人触发。主人可以直接使用。其他人@机器人会提示让主人配置白名单，主人复制群id在dashboard上配置白名单以后就能聊了。

## 插件升级
后续如果更新，可以用下述命令升级插件
`openclaw plugins update tuitui-openclaw-channel`

## 安全备忘

推推机器人权限：用【推推机器人助手】自助创建的推推机器人，无论新老，默认私聊权限范围均调整为allstaff。因此你的机器人可以给本组织内任何人双向发消息。

私聊安全：推推插件还有一层私聊策略（Dm Policy），默认为配对，即只有配对成功的人才能聊（包括你自己），因此不影响安全性。

群聊安全：默认配置下，插件群聊策略（Group Policy）为白名单，即只有把群ID加白后才能聊，不在白名单机器人会提示你加白名单。另外私聊权限会继承到群聊，即如果你具备私聊权限，那么你自己在群里即使不加白也可以聊。

## 4月份版本注意

安装后建议显式配置 `plugins.allow`：

```json5
{
  "plugins": {
    "enabled": true,
    "allow": ["tuitui"]
  }
}
```

## 从3、4月份龙虾升级到5月份之后版本注意

plugins 字段参考配置如下，需要删除 plugins.installs，以及修改原来的 plugins.allow 以及 plugins.entries

```json5
  "plugins": {
    "allow": [
      "tuitui-openclaw-channel"
    ],    
    "entries": {
      "tuitui-openclaw-channel": {
        "enabled": true,
        "config": {},
        "hooks": {
          "allowConversationAccess": true
        }
      }
    }
  }
```


## 参考文档

- 推推的公开网站：<https://tuitui.cn>
- 了解推推机器人：<https://easydoc.soft.360.cn/doc?project=38ed795130e25371ef319aeb60d5b4fa&doc=d1f11ba4cac8886301ede97079df824e&config=menu_toc>
