Quantum Messenger

---
name: quantum-messenger-im
description: 帮助中国电信同人及客户实现通过量子密信调用 OpenClaw 机器人。支持文本、图片、附件及状态栏反馈。
version: 1.0.2
author: 上海电信政支中心/量子能力中心 技术经理 程沛及他的openclaw机器人助手：1号机（Gemini) (18918115454，chenpei.sh@chinatelecom.cn)
tags: [quantum, im, chinatelecom, messaging]
metadata: {"openclaw":{"requires":{"bins":["node"],"env":["QUANTUM_KEY"]},"primaryEnv":"QUANTUM_KEY"}}
---

# Quantum Messenger IM Skill

本技能由上海电信政支中心/量子能力中心技术经理程沛及他的openclaw机器人助手：1号机（Gemini)共同开发。

## 核心配置
1. 端口: 默认 9001 (需安全组放通)。
2. 机器人类型: 量子密信自定义会话机器人。
3. KEY: 填入 scripts/ 目录下脚本对应位置。

## 开发者备注
- 文本回复: content 字段提取。
- 图片发送: type=1, imageMsg 字段。
- 附件发送: type=2, fileMsg 字段。
- 回调地址: 量子密信 APP 内机器人设置 URL。

详情请参阅 README.md。

# 量子密信 (Quantum Messenger) - OpenClaw 技能

## 🌟 简介
本技能旨在帮助 **中国电信的同事** 及 **使用中国电信量子密信的客户** 实现通过量子密信调用 OpenClaw 机器人。

通过此技能，您可以将量子密信作为 AI 机器人的前端界面，实现文本对话、图片生成、文件传输等多种交互功能，并能在回复中实时查看到 AI 模型的运行状态（CTX、时间等）。

## 👤 作者信息
- **作者**: 上海电信政支中心/量子能力中心 技术经理 程沛及他的openclaw机器人助手：1号机（Gemini)
- **联系方式**: 18918115454
- **邮箱**: [chenpei.sh@chinatelecom.cn](mailto:chenpei.sh@chinatelecom.cn)

---

## 🏗️ 逻辑原理
1. **监听层**: 使用 Node.js 启动一个 HTTP Server (`listener.mjs`)，监听来自量子密信 Webhook 的 POST 请求。
2. **大脑层**: 接收到消息后，通过 OpenClaw CLI 指令将内容传递给指定的 AI Agent。
3. **分发层**:
    - **文本**: AI 返回的文本（含系统状态栏）通过量子密信回调接口原样返回。
    - **多模态**: 自动识别 AI 回复中的文件路径（IMAGE:/FILE:），先上传至量子密信存储，再将 fileId 以媒体消息形式推送给用户。

---

## 🚀 部署指南

### 1. 准备工作
确保您的服务器已安装 **Node.js 18+** 和 **OpenClaw**。

### 2. 创建量子密信机器人
1. 在量子密信管理后台（或 APP 内）创建机器人。
2. **重要**: 必须选择 **“自定义会话机器人”**。
3. 获取机器人的 **KEY**。

### 3. 设置机器人 URL
在量子密信 APP 或管理后台设置机器人的“消息回调地址”：
- **格式**: `http://<您的服务器公网IP>:<端口号>`
- **示例**: `http://1.2.3.4:9001`
- **注意**: 请确保该端口号已在您服务器的 **安全组/防火墙** 中放通。

### 4. 修改配置
编辑 `scripts/listener.mjs` 和 `scripts/send.mjs`，将 `KEY` 替换为您获取到的真实 KEY。

### 5. 启动服务
在技能目录下运行：
```bash
nohup node scripts/listener.mjs > listener.log 2>&1 &
```

---

## 🛠️ 功能特性
- **文本交互**: 支持直接对话。
- **状态感知**: 自动引用 OpenClaw 状态栏，显示当前模型、上下文 (CTX) 使用率及 UTC 时间。
- **多模态传输**: 
    - 脚本中已预留图片 (`isImage=true`) 和 附件 (`isImage=false`) 的处理逻辑。
    - AI 只要在回复中输出 `IMAGE:/path/to/file` 或 `FILE:/path/to/file`，即可自动触发媒体发送。