在AI开发与应用场景日益复杂的当下,开发者与AI Agent迫切需要一个统一、高效、全能力覆盖的命令行工具,以简化多模态AI能力的调用与集成。阿里云百炼CLI(命令行工具)正是为此而生,它将百炼平台150+大模型与十余项全栈AI能力统一封装为命令行接口,原生支持主流AI Agent框架,实现“一行命令,全模态覆盖”。无论是个人开发者快速调试AI功能,还是企业级Agent自动化编排复杂任务,百炼CLI都能大幅降低集成成本、提升开发效率。本文将从核心定位、技术架构、安装配置、命令详解、实战应用与Agent集成六大维度,对阿里云百炼CLI进行全方位深度解析,帮助用户全面掌握这款AI命令行神器的核心价值与使用方法。
一、核心定位:AI Agent的全能命令行中枢
阿里云百炼CLI是阿里云百炼平台专为AI Agent开发、自动化任务编排与全模态AI能力调用打造的官方命令行工具。其核心定位是成为连接开发者/Agent与百炼平台所有AI能力的统一入口,彻底解决传统AI开发中“多平台切换、多接口适配、多密钥管理”的痛点。详情👉访问阿里云百炼 CLI 页面 或
详情👉访问阿里云百炼大模型服务平台页面 了解

相较于传统的API调用与Web控制台操作,百炼CLI具备三大核心优势:
- 全能力统一入口:将文本生成、图像生成/编辑、视频生成/编辑、语音合成/识别、视觉理解、多模态对话、知识检索、联网搜索、记忆管理、本地文件处理等10+类AI能力,统一封装为
bl(短别名)或bailian(全名)命令前缀,无需切换工具即可调用所有能力。 - Agent原生兼容:专为AI Agent设计,原生支持Claude Code、Qoder、OpenClaw、Hermes Agent、Qwen Code等主流AI Agent框架,一行命令即可让Agent自动接入百炼全能力。
- 轻量化高效调用:无需复杂的SDK集成与代码编写,通过简单的命令行参数即可完成复杂AI任务,支持脚本化、自动化批量处理,大幅提升开发与运维效率。
二、技术架构:插件化+全模态+Agent友好
百炼CLI采用插件化架构设计,底层基于Node.js开发(要求≥18.17.0),跨平台兼容Windows、macOS、Linux系统。其技术架构可分为三层:
- 核心命令层:提供
bl/bailian基础命令,负责鉴权、配置管理、版本校验与插件调度。 - 能力插件层:将百炼平台的各类AI能力封装为独立插件(如
text、image、video、voice、omni等),每个插件对应一类AI能力,支持动态安装与卸载。 - 平台对接层:通过统一的API网关与阿里云百炼平台对接,支持150+大模型调用、知识库检索、联网搜索、记忆管理等核心能力,并提供结构化输出,便于Agent解析与自动化处理。
该架构的核心特点是模块化、可扩展、Agent友好:
- 模块化:各能力插件独立开发、独立部署,便于快速迭代与功能扩展。
- 可扩展:支持自定义插件开发,用户可根据需求扩展专属AI能力。
- Agent友好:所有命令输出均为结构化格式(JSON/文本),支持命令行参数传递与结果捕获,完美适配AI Agent的自动化调用需求。
三、安装与配置:30秒快速上手
百炼CLI的安装与配置流程极简,仅需三步即可完成,支持手动安装与AI Agent自动安装两种方式。详情👉访问阿里云百炼 CLI 页面 或
详情👉访问阿里云百炼大模型服务平台页面 了解

1. 环境准备
百炼CLI仅依赖Node.js环境,要求版本≥18.17.0(推荐22.x LTS)。
# 检查Node.js与npm版本
node -v
npm -v
# 若版本不足,升级Node.js(macOS/Linux)
sudo npm install -g n
sudo n lts
2. 安装CLI与Skills(核心步骤)
通过npm全局安装百炼CLI,并安装配套的Skills插件(包含所有AI能力)。
# 一键安装CLI与所有Skills(推荐)
npm install -g bailian-cli && npx skills add modelstudioai/skills --all -g
# 校验安装结果
bl --version
# 查看所有可用命令
bl --help
3. 鉴权配置(API Key)
从阿里云百炼控制台获取API Key(路径:百炼控制台→API密钥管理),完成鉴权配置。
# 方式一:交互式配置(新手推荐)
bl config
# 方式二:命令行快速配置(脚本/自动化场景)
bl auth login --api-key sk-你的百炼API密钥
# 校验鉴权状态
bl auth status
# 输出JSON格式状态(便于Agent解析)
bl auth status --output json
配置完成后,所有信息将自动保存至~/.bailian/config.toml(Linux/macOS)或%USERPROFILE%\.bailian\config.toml(Windows),无需重复配置。
四、核心命令详解:全模态能力一键调用
百炼CLI提供丰富的命令集,覆盖文本、图像、视频、语音、多模态、知识、工具等全场景AI能力。以下为核心命令详解与实战示例:
1. 文本能力(bl text)
文本对话、代码生成、内容创作等基础文本能力。
# 基础文本对话(默认模型:qwen3.7-max)
bl text chat --message "介绍阿里云百炼CLI的核心功能"
# 代码生成(指定模型:qwen3.8-max-preview)
bl text chat --model qwen3.8-max-preview --message "用Python写一个快速排序算法" --temperature 0.1
# 长文本生成(指定最大Tokens)
bl text chat --message "写一篇关于AI Agent发展趋势的深度文章" --max-tokens 8192
2. 图像能力(bl image)
图像生成、编辑、理解等视觉能力。
# 图像生成(生成4张赛博朋克城市图片,保存至./out目录)
bl image generate --prompt "A cyberpunk city at night, neon lights, rainy" --n 4 --out-dir ./out/
# 图像编辑(基于参考图编辑)
bl image edit --image ./input.jpg --prompt "将图片中的天空改为星空,添加流星效果"
# 图像理解(分析图片内容)
bl image understand --image ./product.jpg --prompt "分析这张产品图片的卖点与设计亮点"
3. 视频能力(bl video)
视频生成、编辑、参考生成等视频能力。
# 文本生成视频(保存为sunset.mp4)
bl video generate --prompt "Ocean waves at sunset, slow motion, 4K" --download sunset.mp4
# 图像生成视频(基于参考图生成)
bl video generate --image ./landscape.jpg --prompt "让图片中的风景动起来,添加流水与飞鸟效果" --duration 10
# 视频编辑(剪辑与特效)
bl video edit --video ./input.mp4 --prompt "剪辑视频前10秒,添加背景音乐与字幕"
4. 语音能力(bl voice)
语音合成(TTS)、语音识别(ASR)等音频能力。
# 语音合成(生成hello.mp3,指定音色)
bl voice tts --text "你好,欢迎使用阿里云百炼CLI" --voice "cosyvoice-zh-female-01" --out hello.mp3
# 语音识别(识别会议音频,输出文本)
bl voice asr --url ./meeting.mp3 --language zh --format text
# 多语种语音合成
bl voice tts --text "Hello, welcome to Alibaba Cloud Bailian CLI" --voice "cosyvoice-en-male-01" --out hello_en.mp3
5. 多模态能力(bl omni)
全模态对话,支持文本、图像、音频、视频混合输入。
# 多模态对话(文本+图像输入)
bl omni --message "分析这张图片并生成对应的产品描述" --image ./product.jpg
# 多模态对话(文本+音频输入)
bl omni --message "总结这段音频的核心内容" --audio ./speech.mp3
6. 知识与工具能力(bl search/bl kb/bl memory)
联网搜索、知识库检索、记忆管理等工具能力。
# 联网搜索(AI总结搜索结果)
bl search --query "阿里云百炼CLI最新功能" --summary
# 知识库检索(查询企业知识库)
bl kb query --name "企业产品知识库" --query "百炼CLI的安装方法"
# 记忆管理(保存与查询长期记忆)
bl memory save --key "cli-install" --value "npm install -g bailian-cli"
bl memory query --key "cli-install"
7. 其他核心命令
# 查看所有可用模型
bl model list
# 查看命令帮助
bl <command> --help
# 例:bl text chat --help
# 版本更新
npm update -g bailian-cli
五、实战应用:从简单任务到复杂工作流
百炼CLI的强大之处在于其实战性与自动化能力,可快速落地各类AI应用场景。
1. 电商素材自动化生成
# 生成6张亚马逊黑色T恤主图
bl image generate --prompt "Pure black summer men's T-shirt, Amazon main image, white background, high detail" --n 6 --out-dir ./t-shirt-images/
# 生成产品描述与卖点
bl text chat --message "基于生成的T恤图片,撰写亚马逊产品标题、五点描述与A+页面内容" --max-tokens 4096 > product_description.md
# 生成产品宣传视频
bl video generate --image ./t-shirt-images/1.jpg --prompt "Dynamic product display, add text overlay with product features" --duration 15 --download t-shirt-video.mp4
2. 会议内容自动化处理
# 识别会议音频
bl voice asr --url ./meeting.mp3 --language zh --format text > meeting_transcript.txt
# 总结会议内容与行动项
bl text chat --message "总结这份会议纪要,提取核心决策、行动项与责任人" --file ./meeting_transcript.txt > meeting_summary.md
# 生成会议录音转写与总结播客
bl voice tts --text "$(cat meeting_summary.md)" --voice "cosyvoice-zh-male-01" --out meeting_summary_podcast.mp3
3. 代码项目自动化辅助
# 生成项目README文档
bl text chat --message "基于Python项目代码,生成完整的README.md文档,包含安装、配置、使用示例" --file ./main.py > README.md
# 代码审查与优化建议
bl text chat --model qwen3.8-max-preview --message "审查这段Python代码,找出Bug并提供优化方案" --file ./app.py > code_review.md
# 生成单元测试代码
bl text chat --message "为这段代码生成完整的单元测试用例" --file ./app.py > test_app.py
六、AI Agent集成:一行命令,全能力接入
百炼CLI专为AI Agent设计,原生支持主流Agent框架,无需复杂配置即可让Agent自动调用百炼全能力。
1. Claude Code集成
# 安装Claude Code
npm install -g @anthropic-ai/claude-code
# 配置Claude Code使用百炼Coding Plan
mkdir -p ~/.claude
nano ~/.claude/settings.json
# 写入配置(替换YOUR_API_KEY为Coding Plan密钥)
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.7-max"
}
}
# 启动Claude Code,即可自动调用百炼CLI能力
claude
2. OpenClaw/Hermes Agent集成
# 安装OpenClaw
npm install -g openclaw
# 配置OpenClaw使用百炼CLI
openclaw config set bailian.apiKey sk-你的百炼API密钥
openclaw config set bailian.model qwen3.8-max-preview
# 启动OpenClaw,自动集成百炼全能力
openclaw
3. 自定义Agent集成(Python示例)
import subprocess
import json
def call_bailian_cli(command):
"""调用百炼CLI并返回结果"""
result = subprocess.run(command, shell=True, capture_output=True, text=True)
if result.returncode == 0:
return result.stdout.strip()
else:
raise Exception(f"CLI调用失败: {result.stderr.strip()}")
# 示例:调用文本对话
response = call_bailian_cli('bl text chat --message "用Python调用百炼CLI" --output json')
print(json.loads(response))
# 示例:调用图像生成
call_bailian_cli('bl image generate --prompt "AI Agent logo" --out-dir ./agent-logo/')
七、优势总结与选型建议
1. 核心优势
- 全能力统一:10+类AI能力、150+模型,一个命令入口,无需切换工具。
- Agent原生:完美适配主流AI Agent框架,一行命令即可集成全能力。
- 跨平台兼容:支持Windows、macOS、Linux,开箱即用。
- 轻量化高效:命令行调用,支持脚本化、自动化批量处理,开发效率提升50%+。
- 持续更新:与百炼平台能力同步更新,持续新增AI能力与模型支持。
2. 选型建议
- 优先使用百炼CLI的场景:
- AI Agent开发与集成,需要快速接入多模态AI能力。
- 自动化任务编排,需要批量处理文本、图像、视频、语音等任务。
- 开发者快速调试AI功能,无需编写复杂SDK代码。
- 企业级AI应用开发,需要统一的AI能力调用入口。
- 替代方案:简单文本对话场景,可使用Web控制台;复杂应用开发,可结合SDK与CLI混合使用。
八、结语
阿里云百炼CLI的发布,标志着AI能力调用进入命令行统一化、Agent原生化、全模态一体化的新时代。它不再是单一的文本对话工具,而是一个集文本、图像、视频、语音、知识、工具于一体的全能AI命令行中枢。对于开发者而言,它简化了AI能力的调用与集成流程,让AI开发更高效、更便捷;对于AI Agent而言,它提供了统一的能力入口,让Agent能够“动手”处理各类复杂任务,从“思考”迈向“行动”。
随着百炼平台能力的持续迭代,百炼CLI也将不断更新,支持更多AI能力与模型,成为连接开发者、Agent与AI世界的核心桥梁。无论是个人开发者还是企业团队,尽早掌握并应用百炼CLI,都将在AI开发与应用的浪潮中抢占先机,释放AI的无限潜能。