阿里云百炼 CLI – 阿里云开源的 AI Agent 命令行工具

1. 阿里云百炼 CLI 是什么

阿里云百炼 CLI 是阿里云开源的 AI Agent 命令行工具，专为智能体（Agent）场景设计。开发者通过一行命令即可让 Agent 自动调用阿里云百炼平台上的 150+ 多模态模型、10+ 应用及知识库、记忆、联网搜索等全套能力。该工具原生兼容 Claude Code、Qoder、OpenClaw 等主流 Agent 框架，支持文本、图像、视频、语音等全模态任务调用与结构化输出，实现从单点模型调用到多能力协同编排的完整工作流。

技术定位与领域： 阿里云百炼 CLI 属于云原生 AI 开发工具领域，定位为云平台 AI 能力的命令行入口与 Agent 编排层。它并非传统意义上的模型推理引擎，而是面向智能体应用开发者的“能力聚合器”，将阿里云百炼平台上的模型、应用、数据服务通过统一 CLI 接口暴露给 Agent 框架，大幅降低多模态、多能力协同的开发复杂度。

研发背景： 该工具由阿里云百炼团队开发，依托阿里云在大模型服务（MaaS）领域的技术积累。随着 Claude Code、Qoder 等 Agent 框架的兴起，开发者需要一种标准化方式将云平台能力集成到 Agent 中。阿里云百炼 CLI 正是在这一背景下诞生，旨在解决传统 API 调用方式中“多模型切换复杂、能力编排困难、鉴权流程繁琐”等痛点。

核心价值： 阿里云百炼 CLI 的核心价值在于“极简集成”与“全模态覆盖”。开发者无需手动配置多个 API、管理密钥或编写复杂的调用逻辑，只需一行命令即可让 Agent 获得阿里云百炼的全部能力。这极大降低了多模态 AI 应用的开发门槛，尤其适合需要快速原型验证或构建复杂工作流的场景。

技术特点： 该工具采用“指令驱动 + 自动鉴权”架构，Agent 通过自然语言指令即可触发模型调用、知识库检索、记忆读写等操作。同时，它提供结构化返回结果（JSON Schema），便于 Agent 解析和链式调用，实现从“单点能力”到“端到端任务”的自动化编排。

2. 主要功能

• 全模态模型调用： 支持一键调用阿里云百炼平台 150+ 模型，覆盖文本生成（如 Qwen3.7-Max）、视觉理解（Qwen3-VL-Plus）、语音合成（CosyVoice V3 Flash）、图像生成（HappyHorse 1.0）、视频生成等。开发者无需区分模型类型，统一通过 CLI 参数指定，Agent 自动完成路由与结果解析。

• 企业级数据与应用服务： 提供知识库检索（RAG）、记忆库持久化存储、工作流调用和智能体调用等高级服务。开发者可让 Agent 在对话中实时查询企业知识库、跨会话保持上下文记忆，或触发预定义的工作流模板，实现业务逻辑的自动化执行。

• 内置 Agent 工具能力： 工具层包含联网搜索（实时获取网络信息）、临时文件上传（生成 48 小时有效 URL，用于图像/视频输入）、模型额度查询（监控 API 使用量）以及自动 API 文档集成。这些工具可直接被 Agent 调用，无需额外开发。

• 主流 Agent 框架原生兼容： 专门针对 Claude Code、Qoder、Qwen Code、OpenClaw、Hermes Agent 等主流 AI Agent 框架进行适配。开发者只需在 Agent 配置文件中添加一行命令，即可将阿里云百炼 CLI 注册为工具，实现“即插即用”。

• 复杂能力编排： 支持将模型调用、应用服务、知识库检索、记忆读写、联网搜索和文件处理等能力组合成完整任务流。例如，Agent 可以：读取本地图片 → 调用视觉理解模型识别内容 → 检索知识库获取背景信息 → 调用图像生成模型输出新素材 → 最后通过语音合成生成解说音频。

• 结构化输出与链式调用： 所有 API 返回结果均采用标准 JSON Schema 格式，包含类型标记、元数据和错误码。Agent 可自动解析并决定下一步操作，实现多步骤自动化链式调用，减少人工干预。

3. 如何使用

1. 环境要求： 任何支持 Python 3.8+ 的操作系统（Linux、macOS、Windows），建议网络环境能访问阿里云百炼服务。无需 GPU 或高性能计算资源，CLI 本身为轻量级客户端，所有模型推理在云端完成。

2. 安装 CLI： 在 Agent 工具中输入以下指令，让 Agent 自动读取安装脚本并执行：

| curl -fsSL https://bailian.aliyun.com/cli/install.sh |

或手动下载二进制包解压至系统 PATH 目录。安装完成后运行 `bailian --version` 验证。

3. **获取 API Key：** 登录阿里云百炼控制台（[https://bailian.console.aliyun.com](https://bailian.console.aliyun.com)），在“API Key 管理”页面创建个人密钥。注意：密钥需妥善保管，建议使用环境变量方式注入。

4. **完成鉴权：** 向 Agent 提供 API Key，让 Agent 自动执行鉴权配置。例如在 Claude Code 中运行：
```bash
export BAILIAN_API_KEY="your-api-key"
bailian auth

鉴权成功后，CLI 会绑定账户并显示可用模型列表。

5. 开始使用： 直接在 Agent 中输入自然语言指令，如“生成一张电商主图，风格为北欧简约，尺寸 800x800”。Agent 会自动调用阿里云百炼 CLI 的图像生成模型，并将结果返回。对于复杂任务，可编写多步指令链，如“先读取本地商品图，然后调用视觉理解模型提取特征，最后生成 3 张不同背景的营销图”。

6. 最佳实践： 建议将常用能力封装为 Agent 的“技能”或“工具”，通过配置文件持久化。例如在 Claude Code 的 .claude/settings.json 中注册 bailian 作为工具，后续对话中直接引用。注意监控 API 额度，避免超出免费配额。

4. 优缺点分析

5. 同类工具对比

选型建议： 如果你的核心需求是快速集成多模态能力（如图像生成、语音合成、视频编辑）到 Agent 工作流中，阿里云百炼 CLI 是最佳选择，因为它提供了最丰富的模型库和一站式编排能力。对于以代码开发为主的场景，Claude Code 和 Qoder 在编程任务上表现更优，但若需要结合多模态能力，可通过阿里云百炼 CLI 作为补充工具。对于需要高度自定义 Agent 框架的团队，OpenClaw 提供了更灵活的工具注册机制，但需要自行配置模型接入层。

6. 编辑点评

阿里云百炼 CLI 在技术创新性上值得肯定：它并非简单地将 API 封装为命令行，而是针对 Agent 场景设计了“指令驱动 + 结构化输出 + 自动鉴权”的架构，使得 Agent 能够以自然语言方式调用复杂的云平台能力。这种设计思路借鉴了 MCP（Model Context Protocol）的理念，但更侧重于阿里云生态的深度整合。从实用价值来看，该工具显著降低了多模态 AI 应用的开发门槛——以往需要数天才能完成的“模型选择-API 对接-鉴权配置-结果解析”流程，现在只需一行命令即可完成。尤其对于电商营销、内容生产、智能客服等需要频繁切换模型的场景，效率提升非常明显。

适用人群方面，该工具主要面向 AI Agent 开发者、全栈工程师以及需要快速验证多模态 AI 能力的产品经理。对于纯算法研究人员，其价值相对有限，因为底层模型不可定制。未来发展潜力很大：随着阿里云百炼平台持续增加新模型和服务，CLI 工具将成为阿里云 AI 能力的“超级入口”，甚至可能演变为 Agent 操作系统的核心组件。不过，当前社区生态尚在早期，文档和示例的丰富度有待提升。

7. 应用场景

• 电商营销自动化： Agent 读取本地商品图，自动调用阿里云百炼 CLI 的图像生成与编辑模型，输出多视角电商主图、白底图、场景图等营销素材。整个过程无需人工干预，可批量处理，大幅降低设计成本。

• 多模态内容生产： 输入自然语言指令（如“生成一个关于太空探索的 3 分钟短视频”），Agent 自动编排文本生成（脚本）、图像生成（分镜图）、视频生成（合成）、语音合成（配音）等能力，完成专业级内容交付。适用于自媒体、教育、广告等行业。

• 企业智能客服： 结合知识库检索、跨会话记忆与联网搜索，构建具备业务上下文理解的企业级智能助手。Agent 可实时查询内部知识库、调用记忆模块保存用户偏好，并在需要时联网搜索最新信息，提供精准回答。

• 复杂工作流编排： 将模型、应用、知识库、记忆、文件处理等能力组合成自动化任务流。例如：用户上传合同图片 → Agent 调用 OCR 模型提取文字 → 调用知识库检索条款 → 调用文本生成模型撰写摘要 → 最后通过语音合成生成播报音频。适用于法务、审计、金融等场景。

8. 常见问题 FAQ

Q：阿里云百炼 CLI 是否支持离线使用？
A：不支持。所有模型推理和数据服务均在阿里云百炼云端执行，CLI 仅作为客户端发送请求。如需离线使用，可考虑阿里云百炼的本地部署方案（如百炼专有版），但 CLI 工具本身不提供该能力。

Q：安装时提示“curl: command not found”，怎么办？
A：请先安装 curl（Linux/macOS 通常自带，Windows 需手动安装或使用 PowerShell 的 Invoke-WebRequest）。也可直接访问 https://bailian.aliyun.com/cli/install.sh 下载脚本，或从 GitHub 仓库获取二进制包手动安装。

Q：如何查看当前可用的模型列表？
A：鉴权成功后，运行 bailian models list 即可查看所有可调用的模型及其 ID。部分模型可能需要额外申请权限，请参考阿里云百炼控制台的“模型管理”页面。

Q：API Key 如何安全地传递给 Agent？
A：建议使用环境变量方式注入，例如在启动 Agent 前执行 export BAILIAN_API_KEY="your-key"。避免在对话中直接输入密钥，也切勿将密钥硬编码在配置文件中。对于 Claude Code，可在 .claude/settings.json 中通过 env 字段设置。

Q：生成的图片或视频文件如何获取？
A：CLI 返回的结果中包含文件 URL（有效期 48 小时），Agent 可自动下载或直接使用该 URL 进行后续处理。如需持久化存储，可调用阿里云 OSS 等对象存储服务。

Q：是否支持自定义模型部署？
A：不支持通过 CLI 直接调用用户自部署的模型。阿里云百炼 CLI 仅调用百炼平台上的官方模型。如需使用自定义模型，需先通过百炼控制台进行模型部署，然后通过 CLI 调用该部署的 API 端点。

9. 项目地址

• 项目官网与安装指南： https://bailian.console.aliyun.com/cli
• GitHub 仓库（获取源码和详细文档）： https://github.com/aliyun/bailian-cli
• 阿里云百炼控制台（申请 API Key）： https://bailian.console.aliyun.com