本教程带你走通 阿里云百炼 → CLI → Skills → AI Agent 的完整链路。

⏱️ 预计用时：15–25 分钟 🚀 在 Workshop 现场？请直接查看 Workshop 手册 →

阿里云百炼平台（Aliyun Model Studio / DashScope）
        ↑ 提供 AI 模型 API（文本/图像/视频/语音/向量等）
        │
阿里云百炼 CLI（命令 bl）
        ↑ 命令行工具，每条命令即 AI Agent 的结构化工具调用
        │
你的 AI Agent 环境
   • 终端：直接 bl 调用
   • Cursor / Qwen Code / Claude Desktop / Windsurf / Cline / Trae：作为工具
   • OpenWork（开源桌面 Agent）：开箱即用
        ↑ 加载
        │
Skills（可复用的 AI 能力模块）
   • 官方 first-party：bailian-cli、bailian-docs-llm-wiki、spark-video
   • 精选社区：canvas-design、frontend-design、marketing-writer 等

各组件职责：

• 阿里云百炼：模型 API 服务平台（DashScope）
• 阿里云百炼 CLI（bl）：把模型能力封装成结构化命令
• AI Agent 环境：调用 bl 的载体——可以是任意支持 shell 或 MCP 的 Agent
• OpenWork：开源桌面 Agent，已内置 CLI 与 Skills 体系
• Skills：把多步工作流打包成可复用的能力模块

前往阿里云百炼平台，使用阿里云账号登录（无账号需先注册）。

[获取 API Key →]({{ site.bailian_apikey_url }})

1. 点击「创建 API Key」
2. 给 Key 取个名称（如 my-cli-key）
3. 复制并妥善保存（仅创建时可见完整值）

阿里云百炼为新用户提供免费 token 额度，足够本教程与日常探索。安装 CLI 后可用 bl usage free 实时查询余量。

[阿里云百炼 CLI 控制台 →]({{ site.bailian_cli_url }})

阿里云百炼 CLI 是为 AI Agent 而生的——任何支持 shell 命令或 MCP 工具的 Agent 都能直接使用它。挑选适合你的方式：

npm install -g bailian-cli
bl --version

需要 Node.js >= 22.12

无需额外配置——只要 Agent 能执行 shell，就能调用 bl。

OpenWork 是阿里云百炼团队开源的桌面 Agent，已内置 CLI、Skills 体系与对话界面，下载安装即用：

前往 GitHub Releases →

• macOS：下载 .dmg，拖入「应用程序」
• Windows：下载 .exe，按提示安装
• Linux：下载 .AppImage 或 .deb

bl auth login --console

会自动弹浏览器完成授权，登录后可使用控制台相关能力（bl app list 等）。

bl auth login --api-key sk-xxxxx

export DASHSCOPE_API_KEY=sk-xxxxx

bl text chat --message "你好，介绍一下你自己"

正常回复说明已连接成功。

Skills 是阿里云百炼团队验证过的 AI 能力模块，让 Agent 能完成更复杂的工作流。

把这段话粘进你的 Agent：

请帮我安装阿里云百炼的 AI Skills：
1. 检查 Node.js 是否已安装（>= 18），未安装则自动安装
2. 执行：npx skills add modelstudioai/skills
3. 安装完成后告诉我"Bailian Skills installed"，并列出已安装的 Skills 与可用功能

# 核心 bailian-cli skill
npx skills add modelstudioai/cli --all -g

# 精选扩展 skills
npx skills add modelstudioai/skills

完整列表 → 精选 Skills

现在你已经具备完整的 CLI + Skills 环境。挑一个场景试试：

bl text chat --message "解释一下 RAG 是什么"

bl omni --message "描述这张图" --image ./photo.jpg

bl image generate --prompt "一只穿宇航服的猫，赛博朋克风格" --out-dir ./images/

bl video generate --image ./cat.png --prompt "让猫动起来" --download cat.mp4

直接对你的 Agent 说：

> 帮我设计一张以「自由 + 蝴蝶」为主题的视觉海报
   [Agent 自动激活 canvas-design skill 完成创作]

> 给我做一支 30 秒的产品广告视频，产品图：./product.jpg，卖点是"轻便、续航长"
   [Agent 自动激活 spark-video skill 完成出片]

bl usage free --model qwen3-max

bl advisor recommend --message "我需要做一个能看图回答的对话机器人"

• 精选 Skills 列表 →
• 阿里云百炼 CLI 完整文档 →
• 使用案例 Showcase →
• OpenWork（开源桌面 Agent）→

• FAQ 常见问题 →
• DashScope API 错误码 →

• 分享你的使用案例 → Showcase →
• 贡献你的 Skill → Skills 贡献指南
• 提 Issue / PR → GitHub Org

本教程持续迭代中。在 GitHub 上编辑此页 →