命令行工具

qwb-cli

让 AI Agent 通过 Shell 直接操作企微瓣系统

覆盖认证、语音合成、声音克隆、数字人、AI 对话、图片生成等全部客户端 API

39+ 子命令

覆盖认证、语音、数字人、AI 对话等全部 API

AI Agent 友好

默认 compact JSON 输出，方便机器解析

零依赖运行

编译为单文件 JS，使用 Node.js 内置 fetch

一键安装

npm install -g qwb-cli，即装即用

安装与快速开始

要求Node.js >= 18

npm install -g qwb-cli

Bash

# 1. 安装
npm install -g qwb-cli

# 2. 登录
qwb auth login --phone 13800138000 --password your_password

# 3. 查看瓣值余额
qwb petals overview

# 4. AI 对话
qwb ai chat --input "帮我写一段产品介绍"

# 5. 语音合成
qwb voice synthesize --text "你好世界" --voice-id voice_xxx

# 6. 生成数字人视频
qwb dh video-create --script "欢迎使用企微瓣" --wait

输出格式

默认输出 compact JSON（AI Agent 友好），可通过全局选项切换为格式化 JSON、表格或静默模式。

示例

# JSON（默认）— 一行紧凑 JSON，AI Agent 友好
$ qwb petals overview
{"balance":1000,"totalEarned":2000,"totalSpent":1000}

# 格式化 JSON
$ qwb petals overview --pretty

# 表格模式 — 人类可读
$ qwb petals overview --format table

# 静默模式 — 只输出关键值
$ qwb petals overview --format quiet
1000

命令一览

🔐

认证与登录

auth

qwb auth login -p <phone> -w <password>密码登录

qwb auth login -p <phone> -c <code>验证码登录

qwb auth send-code -p <phone>发送验证码

qwb auth logout退出登录

qwb auth status查看登录状态

qwb auth config查看配置

qwb auth config --base-url <url>设置 API 地址

🎵

语音合成

voice

qwb voice voices系统音色列表

qwb voice synthesize -t "文本" --voice-id <id>合成语音

qwb voice synthesize -t "文本" --clone-id <id>用克隆声音合成

qwb voice works作品列表

qwb voice work <id>作品详情

qwb voice delete <id>删除作品

🎭

声音克隆

clone

qwb clone list克隆声音列表

qwb clone upload -f audio.mp3上传音频样本

qwb clone create --name "我的声音" --voice-id <id> --audio-id <id>创建克隆声音

qwb clone delete <id>删除声音

qwb clone restore <id>恢复已删除声音

🤖

数字人

qwb dh list数字人列表（含系统预设）

qwb dh my我的克隆数字人

qwb dh create --video ./video.mp4 --name "名称"创建数字人

qwb dh status <id>查询创建状态

qwb dh video-create --script "文本"生成数字人视频

qwb dh video-create --script "文本" --wait生成并等待完成

qwb dh video-status <jobId>查询视频状态

💬

AI 大模型对话

qwb ai models可用模型列表

qwb ai chat -i "你好"AI 对话

qwb ai chat -i "内容" --stream流式输出

qwb ai chat -i "内容" --model-id <id>指定模型

🧠

DashScope 阿里百炼

qwb ds chat -i "你好" --model qwen-plus通义千问对话

qwb ds chat -i "搜索" --search联网搜索对话

qwb ds tts -t "你好世界"CosyVoice 语音合成

qwb ds voices预设音色列表

qwb ds clone-create --prefix myvoice --audio-url <url>创建克隆音色

qwb ds clone-list克隆音色列表

🖼️

图像处理

image

qwb image generate "提示词"AI 文生图

qwb image generate "提示词" -i ref.jpg图生图

qwb image remove-bg -f photo.jpg去背景

🌸

瓣值管理

petals

qwb petals overview瓣值概览

qwb petals batches瓣值批次列表

qwb petals history --page 1 --limit 20消费历史

语音合成选项

选项	说明	默认值
--speed <n>	语速 (0.5-2.0)	1.0
--volume <n>	音量 (0.1-2.0)	1.0
--pitch <n>	音调 (-1.0 到 1.0)	0
--emotion <type>	auto / happy / sad / angry / calm / fluent	auto
--format <fmt>	mp3 / wav / pcm	mp3
--title <title>	作品标题	-
--subtitle	生成字幕	false

AI Agent 集成

qwb-cli 专为 AI Agent 通过 Shell 调用而设计，默认输出 compact JSON，支持管道输入和流式输出。

Exit 0成功

Exit 1业务错误（API 返回失败）

Exit 2认证错误（未登录/Token 过期）

Exit 3网络错误

管道 & 流式

# 管道输入
echo "帮我写一段产品文案" | qwb ai chat
cat prompt.txt | qwb ai chat --stream

# 异步任务等待
qwb dh video-create --script "演示文本" --wait

# 流式对话
qwb ai chat -i "写一篇文章" --stream

技能安装（AI Agent Skill）

除了直接在终端使用 qwb-cli，你还可以将其安装为 AI Agent 技能，让 Cursor、Claude 等 AI 助手自动识别并调用企微瓣的所有能力。

🐾 通过 ClawHub 一键安装

访问 ClawHub 技能市场，一键安装 qwb-cli 技能到你的 AI Agent 环境：

安装 qwb-cli 技能

安装后效果

技能安装后，AI Agent 将能自动识别以下意图并调用 qwb-cli 完成操作：

"帮我生成一段语音"→自动调用 qwb voice synthesize

"克隆我的声音"→自动调用 qwb clone 流程

"生成数字人视频"→自动调用 qwb dh video-create

"用 AI 写一段文案"→自动调用 qwb ai chat

"生成一张图片"→自动调用 qwb image generate

"查看我的瓣值"→自动调用 qwb petals overview

前置条件

1全局安装 CLI：npm install -g qwb-cli
2完成登录认证：qwb auth login -p 手机号 -w 密码
3在 ClawHub 安装技能到你的 AI Agent

配置

凭证和配置存储在 ~/.qwb/ 目录：

文件	权限	内容
~/.qwb/credentials.json	600	JWT Token、过期时间、用户信息
~/.qwb/config.json	644	API 基础 URL、默认输出格式

📡

API 文档

RESTful API 接口和示例代码

📖

帮助中心

常见问题和使用指南

开始使用 qwb-cli

一行命令安装，即刻体验 AI 创作的命令行魅力

npm install -g qwb-cli