让 AI Agent 通过 Shell 直接操作企微瓣系统
覆盖认证、语音合成、声音克隆、数字人、AI 对话、图片生成等全部客户端 API
覆盖认证、语音、数字人、AI 对话等全部 API
默认 compact JSON 输出，方便机器解析
编译为单文件 JS，使用 Node.js 内置 fetch
npm install -g qwb-cli，即装即用
npm install -g qwb-cli# 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
1000qwb 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 地址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>删除作品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>查询视频状态qwb ai models可用模型列表qwb ai chat -i "你好"AI 对话qwb ai chat -i "内容" --stream流式输出qwb ai chat -i "内容" --model-id <id>指定模型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克隆音色列表qwb image generate "提示词"AI 文生图qwb image generate "提示词" -i ref.jpg图生图qwb image remove-bg -f photo.jpg去背景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 |
qwb-cli 专为 AI Agent 通过 Shell 调用而设计，默认输出 compact JSON，支持管道输入和流式输出。
# 管道输入
echo "帮我写一段产品文案" | qwb ai chat
cat prompt.txt | qwb ai chat --stream
# 异步任务等待
qwb dh video-create --script "演示文本" --wait
# 流式对话
qwb ai chat -i "写一篇文章" --stream除了直接在终端使用 qwb-cli，你还可以将其安装为 AI Agent 技能， 让 Cursor、Claude 等 AI 助手自动识别并调用企微瓣的所有能力。
技能安装后，AI Agent 将能自动识别以下意图并调用 qwb-cli 完成操作：
npm install -g qwb-cliqwb auth login -p 手机号 -w 密码凭证和配置存储在 ~/.qwb/ 目录：
| 文件 | 权限 | 内容 |
|---|---|---|
| ~/.qwb/credentials.json | 600 | JWT Token、过期时间、用户信息 |
| ~/.qwb/config.json | 644 | API 基础 URL、默认输出格式 |
一行命令安装，即刻体验 AI 创作的命令行魅力