# QQ机器人完整升级方案

## 系统概述
您的Clawdbot系统通过QQ机器人扩展完美支持了QQ机器人功能，包括：
- QQ消息接收和发送
- 群组和私聊支持  
- WebSocket连接
- 自动重连机制
- 基于真实市场数据的股票分析

## 文件清单
```
qqbot_upgrade/
├── qqbot/                    # QQ机器人扩展完整文件
│   ├── src/                  # 源代码
│   │   ├── api.ts           # API接口
│   │   ├── channel.ts       # 通道实现
│   │   ├── config.ts        # 配置处理
│   │   ├── gateway.ts       # WebSocket网关
│   │   ├── onboarding.ts    #  onboarding向导
│   │   ├── outbound.ts      # 出站消息
│   │   ├── runtime.ts       # 运行时支持
│   │   └── types.ts         # 类型定义
│   ├── dist/                 # 编译后的JavaScript
│   ├── node_modules/         # 依赖包
│   ├── package.json          # 包配置
│   ├── clawdbot.plugin.json  # 插件配置
│   └── README.md             # 说明文档
└── clawdbot.json             # 包含QQ机器人配置的主配置文件
```

## 升级步骤

### 1. 系统要求
- Linux系统 (Ubuntu/Debian/CentOS等)
- Node.js 18+ 
- Clawdbot最新版本
- npm或yarn包管理器

### 2. 安装基础系统
```bash
# 安装Node.js 18+
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 安装Clawdbot
npm install -g clawdbot
```

### 3. 安装QQ机器人扩展
```bash
# 创建扩展目录
mkdir -p ~/.clawdbot/extensions/

# 复制QQ机器人扩展
cp -r qqbot/* ~/.clawdbot/extensions/qqbot/

# 进入扩展目录安装依赖
cd ~/.clawdbot/extensions/qqbot
npm install
```

### 4. 配置Clawdbot
在 `~/.clawdbot/clawdbot.json` 中添加QQ机器人配置:

```json
{
  "channels": {
    "qqbot": {
      "enabled": true,
      "appId": "YOUR_QQ_APP_ID",
      "clientSecret": "YOUR_QQ_CLIENT_SECRET"
    }
  }
}
```

### 5. 关键文件说明

#### QQ机器人扩展 (`qqbot/`)
- **channel.ts**: QQ机器人通道插件实现
- **config.ts**: 配置解析和账户管理
- **gateway.ts**: WebSocket连接和消息处理
- **api.ts**: QQ API接口封装
- **outbound.ts**: 出站消息发送
- **types.ts**: 类型定义

#### 插件配置 (`clawdbot.plugin.json`)
```json
{
  "id": "qqbot",
  "channels": ["qqbot"],
  "configSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {}
  }
}
```

#### 主配置 (`clawdbot.json`)
包含QQ机器人频道配置，启用QQ消息接收和发送功能。

### 6. 重启服务
```bash
# 重启Clawdbot服务
sudo systemctl restart clawdbot

# 或手动重启
clawdbot gateway restart
```

## 关键功能

### 1. 消息处理
- 接收QQ私聊和群组消息
- 发送文本消息到QQ
- 支持消息回复和转发

### 2. WebSocket连接
- 稳定的WebSocket连接
- 自动重连机制
- 心跳保持连接

### 3. 配置管理
- 多账户支持
- 灵活的配置选项
- 运行时配置更新

### 4. 与股票系统集成
- 接收QQ消息
- 返回基于真实数据的股票分析
- 支持中文显示和编码修复

## 配置说明

### QQ机器人配置
```json
"channels": {
  "qqbot": {
    "enabled": true,
    "appId": "YOUR_QQ_APP_ID",
    "clientSecret": "YOUR_QQ_CLIENT_SECRET"
  }
}
```

### 股票数据集成
系统会自动将QQ消息转发给股票分析功能，返回基于真实市场数据的分析结果。

## 测试验证

安装完成后，可以通过以下方式测试:
```bash
# 测试API接口
curl http://localhost:8080/api/data

# 测试网页访问
curl http://localhost:8080

# 检查服务状态
systemctl status clawdbot
```

## 故障排除

### 常见问题
1. **权限问题**: 确保Clawdbot有访问扩展目录的权限
2. **依赖问题**: 确保已安装所有npm依赖
3. **配置问题**: 检查appId和clientSecret是否正确
4. **网络问题**: 确保服务器可以访问QQ API

### 日志查看
```bash
# 查看Clawdbot日志
tail -f /var/log/clawdbot/*.log

# 查看系统日志
journalctl -u clawdbot -f
```

## 升级说明

这个升级包包含了:
1. **完整的QQ机器人扩展**: 所有源代码和依赖
2. **配置文件**: 包含QQ机器人配置的主配置
3. **安装脚本**: 自动化安装过程
4. **说明文档**: 详细的安装和使用说明

您可以直接使用这个升级包在其他机器上安装完整的QQ机器人功能！