Xeonasr

# Xeon ASR

🎤 基于 OpenVINO Qwen3-ASR 模型的本地语音转文字技能。集成 xdp-audio-service，一键安装自动配置。

## 快速安装

```bash
# 从 ClawHub 安装
clawhub install xeon-asr
cd xeon-asr

# 运行一键安装脚本
bash install.sh
```

安装脚本会自动：
1. ✅ 检查 Python 3.10
2. ✅ 创建虚拟环境
3. ✅ 安装 xdp-audio-service
4. ✅ 生成配置文件
5. ✅ 配置模型路径
6. ✅ 配置 QQ Bot STT

## 智能启动

直接运行 `npm start` 时会自动检测配置：
- 配置完整 → 直接启动服务
- 配置缺失 → 提示用户确认是否运行安装脚本
- **不会自动执行安装**，需要用户输入 `y` 确认

## 配置

### 1. 下载 Qwen3-ASR 模型

```bash
# 从 HuggingFace 下载
git lfs install
git clone https://huggingface.co/Qwen3-ASR-0.6B-INT8_ASYM-OpenVINO /root/models/Qwen3-ASR-0.6B-INT8_ASYM-OpenVINO
```

### 2. 启动服务

```bash
# 启动 ASR Skill (9001 端口)
npm start

# 启动 Flask ASR (5001 端口，另一个终端)
source venv/bin/activate
npm run start:asr
```

### 3. 重启 OpenClaw

```bash
openclaw gateway restart
```

## 使用

- QQ 收到语音消息时自动转写
- 本地运行，无需外部 API
- 基于 OpenVINO 优化的 Qwen3-ASR-0.6B 模型

## 依赖

- Node.js 18+
- Python 3.10
- xdp-audio-service 0.1.0
- Qwen3-ASR 模型（需下载）

## 文档

详细文档请查看 README.md

## 许可证

MIT

# Xeon ASR Skill

🎤 基于 OpenVINO Qwen3-ASR 模型的语音转文字技能，为 OpenClaw/QQBot 提供本地语音识别能力。

## 功能特性

- ✅ 本地运行，无需外部 API
- ✅ 基于 OpenVINO 优化的 Qwen3-ASR-0.6B 模型
- ✅ 支持多种音频格式（.silk, .slk, .amr, .wav, .mp3, .ogg, .pcm）
- ✅ 自动集成 QQ Bot
- ✅ 一键安装脚本
- ✅ 支持模型名称传递
- ✅ OpenAI 兼容接口 (`/audio/transcriptions`)
- ✅ 启动时自动检测配置，缺失时提示用户确认安装

---

## 快速开始

### 方式 1：一键安装（推荐）

```bash
# 克隆 skill
git clone <repository-url> xeon_asr
cd xeon_asr

# 运行安装脚本
bash install.sh
```

安装脚本会自动：
1. 检查 Python 3.10
2. 创建虚拟环境
3. 安装 xdp-audio-service
4. 生成配置文件
5. 配置模型路径
6. 配置 QQ Bot STT

### 方式 2：从 ClawHub 安装

```bash
clawhub install xeon-asr
cd ~/.openclaw/skills/xeon-asr
bash install.sh
```

### 方式 3：直接启动（自动检测配置）

```bash
npm start
```

**智能配置检测：**
- 首次启动时会自动检查配置是否完整
- 如果缺少配置文件或依赖，会提示你运行 `install.sh`
- **需要用户确认后才执行安装**，不会自动修改系统
- 配置完整则直接启动服务

---

## 手动安装步骤

### 步骤 1：创建 Python 3.10 环境

```bash
# 安装 Python 3.10（如果没有）
sudo apt install python3.10 python3.10-venv

# 创建虚拟环境
python3.10 -m venv venv
source venv/bin/activate
```

### 步骤 2：安装 xdp-audio-service

```bash
pip install --upgrade pip
pip install xdp-audio-service==0.1.0
```

### 步骤 3：生成配置文件

```bash
xdp-asr-init-config --output ./audio_config.json
```

### 步骤 4：配置模型路径

编辑 `audio_config.json`，修改 `qwen3_asr_ov` 部分：

```json
{
  "qwen3_asr_ov": {
    "model": "/path/to/your/Qwen3-ASR-0.6B-INT8_ASYM-OpenVINO",
    "language": "zh",
    "task": "transcribe",
    "backend": "openvino",
    "device": "CPU",
    "inference_precision": "int8",
    "max_new_tokens": 256
  }
}
```

**模型获取：**
- HuggingFace: https://huggingface.co/Qwen3-ASR-0.6B-INT8_ASYM-OpenVINO
- ModelScope: https://modelscope.cn/models/Qwen3-ASR-0.6B-INT8_ASYM-OpenVINO

### 步骤 5：安装 Node....