設定與工具

在終端機管理 CLI 鑑權設定、切換 Profile、瀏覽模型市場、上傳檔案以及使用其他通用工具。

任意命令追加 --help 可查看完整參數說明，例如 bl config show --help。所有接受檔案 URL 的參數也接受本機路徑——CLI 會自動上傳到暫存空間（有效期限 48 小時），無需手動托管為 URL。本文命令明細以 bl 2.2.1 為基準核實。

鑑權管理

使用 API Key、控制台瀏覽器登入或 OpenAPI AK/SK 進行認證（多種憑證可共存）。無需鑑權。語法

bl auth login --api-key <key> | --console | --open-api --access-key-id <id> --access-key-secret <secret>

參數	類型	必填	說明
`--api-key <key>`	string	否	要驗證並儲存的模型 API Key
`--base-url <url>`	string	否	與 --api-key 一併驗證並儲存的模型 API Base URL
`--console`	switch	否	透過瀏覽器登入（預設中國站；國際站使用 --console-site international）。需要時會建立普通 API Key；訂閱方案必須使用 --api-key 登入
`--console-site <site>`	string	否	控制台網站：domestic、international
`--open-api`	switch	否	儲存阿里雲 OpenAPI AK/SK 憑證
`--access-key-id <id>`	string	否	要儲存的阿里雲 Access Key ID
`--access-key-secret <secret>`	string	否	要儲存的阿里雲 Access Key Secret

範例：透過瀏覽器登入並建立 API Key

bl auth login --console

bl auth status

顯示目前認證狀態。無需鑑權。語法

bl auth status

該命令僅支援全域參數。範例：以 JSON 輸出目前認證狀態

bl auth status --output json

bl auth logout

清除已儲存的憑證；完整退出還會清除模型 Base URL。無需鑑權。語法

bl auth logout [--console | --open-api] [--dry-run]

參數	類型	必填	說明
`--console`	switch	否	僅清除控制台 access_token，保留 api_key
`--open-api`	switch	否	僅清除 OpenAPI AK/SK/STS 憑證，保留其他憑證

範例：僅清除控制台憑證

bl auth logout --console

bl auth generate-access-token

使用 OpenAPI AK/SK 產生 CLI Access Token。無需鑑權。語法

bl auth generate-access-token --access-key-id <id> --access-key-secret <secret> --security-token <token>

參數	類型	必填	說明
`--access-key-id <id>`	string	是	阿里雲 Access Key ID
`--access-key-secret <secret>`	string	是	阿里雲 Access Key Secret
`--security-token <token>`	string	否	要儲存的阿里雲 STS Security Token（可選）

範例：使用 AK/SK 產生 CLI 存取令牌

bl auth generate-access-token --access-key-id LTAIxxxxx --access-key-secret xxxxx --security-token <token>

設定管理

bl config set

設定設定項目。無需鑑權。語法

bl config set --key <key> --value <value>

參數	類型	必填	說明
`--key <key>`	string	是	設定項目名稱（language、base_url、output、output_dir、timeout、watermark、api_key、api_key_capabilities、access_token、access_key_id、access_key_secret、security_token、default_*_model、workspace_id）
`--value <value>`	string	是	要設定的值

範例：設定語言為中文

bl config set --key language --value zh-CN

bl config show

顯示目前設定。無需鑑權。語法

bl config show

該命令僅支援全域參數。範例：以 JSON 輸出目前設定

bl config show --output json

bl config list

列出設定 Profile 並顯示目前激活項目。無需鑑權。語法

bl config list

該命令僅支援全域參數。範例：以 JSON 輸出設定概覽

bl config list --output json

bl config use

設定目前激活的設定 Profile。無需鑑權。語法

bl config use --name <name>

參數	類型	必填	說明
`--name <name>`	string	是	已有 Profile 名稱，或 default

範例：切換至指定設定檔

bl config use --name token-plan

bl config ui

開啟用於管理設定 Profile 的本機 Web UI。無需鑑權。語法

bl config ui [--port <port>] [--no-open]

參數	類型	必填	說明
`--port <port>`	number	否	監聽埠（預設：隨機可用埠）
`--no-open`	switch	否	不自動開啟瀏覽器

範例：啟動本機設定管理介面

bl config ui --port 8787

bl config agent

設定程式化 Agent 使用 DashScope API。無需鑑權。語法

bl config agent --agent <name> (--base-url <url> | --region <region>) (--api-key <key> | --key <encoded>) --model <model>

參數	類型	必填	說明
`--agent <name>`	string	是	目標 Agent：claude-code, qwen-code, opencode, openclaw, hermes, codex
`--base-url <url>`	string	否	API Base URL
`--region <region>`	string	否	模型服務地域（例如 cn-beijing、ap-southeast-1）；將轉換為 --base-url。僅用於 Token Plan
`--api-key <key>`	string	否	API Key
`--key <encoded>`	string	否	來自 Web 控制台的混淆 API Key（以 "o1_" 開頭）；將解碼為 --api-key
`--model <model>`	string	是	預設模型名稱
`--context-window <tokens>`	number	否	僅 OpenClaw：模型上下文窗口 Token 數（預設：256000）
`--wire-api <api>`	string	否	僅 Codex：通訊協定（預設：responses）。"chat" 僅適用於舊版 Codex <= 0.80.0

範例：設定 Agent 使用 DashScope API

bl config agent --agent claude-code --base-url https://dashscope.aliyuncs.com/apps/anthropic --api-key sk-xxxxx --model qwen3-max

通用工具

bl file upload

將本機檔案上傳至 DashScope 臨時儲存（保留 48 小時）。需要 API Key 鑑權。語法

bl file upload --file <path> --model <model>

參數	類型	必填	說明
`--file <path>`	string	是	要上傳的本機檔案（圖片、影片或音訊）
`--model <model>`	string	是	目標模型名稱（檔案將與該模型綁定）

範例：上傳圖片檔案並綁定模型

bl file upload --file photo.jpg --model qwen3-vl-plus

bl model list

檢視阿里雲百煉模型市場中的模型系列，或檢視模型詳細資訊。無需鑑權。語法

bl model list [--model <model>] [--page <n>] [--page-size <n>] [--provider <p>] [--capability <c>] [--feature <f>] [--input-modality <m>] [--output-modality <m>] [--include-deprecated] [--enrich]

參數	類型	必填	說明
`--model <model>`	string	否	顯示指定模型系列的完整詳情（切換至詳情模式）
`--page <n>`	number	否	頁碼（預設：1）
`--page-size <n>`	number	否	每頁結果數（預設：10）
`--provider <p>`	array	否	按提供者篩選（可重複，例如 --provider alibaba --provider deepseek）
`--capability <c>`	array	否	按能力代碼篩選（TG、Reasoning、VU、IG、VG、TTS、ASR 等）
`--feature <f>`	array	否	按特性篩選（function-calling、web-search、structured-outputs 等）
`--context-window <w>`	array	否	按上下文窗口範圍篩選
`--input-modality <m>`	array	否	限定輸入模態（可重複：Text、Image、Video、Audio）
`--output-modality <m>`	array	否	限定輸出模態（可重複：Text、Image、Video、Audio）
`--include-deprecated`	switch	否	包含已下線的模型（預設隱藏）
`--enrich`	switch	否	同時取得主幹模型的輸入參數 Schema（predictConfig，僅詳情模式）

範例：篩選阿里雲提供的模型

bl model list --provider alibaba

模型目錄和 --enrich 使用的參數 Schema Endpoint 均為公開介面，無需登入控制台。
浏覽模式會隱藏已下線的模型，可用 --include-deprecated 包含它們；詳情模式（--model）始終列出全部版本並標註狀態。

根據你的使用情境推薦最佳模型（意圖分析 → 候選召回 → LLM 排序）。需要 API Key 鑑權。語法

bl advisor recommend --message <text> [flags]

參數	類型	必填	說明
`--message <text>`	string	是	描述你的需求

範例：根據需求預覽模型推薦結果

bl advisor recommend --message "我需要一个能够理解图片的聊天机器人"

bl pipeline run

執行 Pipeline 工作流程定義。無需鑑權。語法

bl pipeline run --file <path> [flags]

參數	類型	必填	說明
`--file <path>`	string	是	Pipeline 定義檔案（YAML/JSON）
`--input <json>`	string	否	內聯 JSON 格式的執行時輸入
`--input-file <path>`	string	否	來自 JSON 檔案的執行時輸入
`--concurrency <n>`	number	否	最大平行步驟數（預設：1）
`--events <format>`	string	否	輸出生命週期事件：jsonl
`--step-timeout <seconds>`	number	否	預設步驟超時時間，單位為秒

範例：執行指定工作流定義並傳入輸入參數

bl pipeline run --file workflow.yaml --input '{"brief":"你好"}'

bl pipeline validate

驗證 Pipeline 定義但不執行。無需鑑權。語法

bl pipeline validate --file <path>

參數	類型	必填	說明
`--file <path>`	string	是	Pipeline 定義檔案（YAML/JSON）

範例：預覽工作流定義驗證結果

bl pipeline validate --file workflow.yaml

bl plugin install

安裝或升級白名單內的 Command Pack。無需鑑權。語法

bl plugin install --package <name[@version]>

參數	類型	必填	說明
`--package <name[@version]>`	string	是	白名單內的 Command Pack 包名，以及可選的版本或 Tag

範例：安裝指定 Command Pack 包

bl plugin install --package @ali/bailian-plugin-agent

bl plugin list

列出已安裝的 Command Pack 及其載入狀態。無需鑑權。語法

bl plugin list

該命令僅支援全域參數。範例：輸出已安裝插件的 JSON 列表

bl plugin list --output json

bl plugin remove

移除已安裝的 Command Pack。無需鑑權。語法

bl plugin remove --name <package>

參數	類型	必填	說明
`--name <package>`	string	是	白名單內的 Command Pack 包名

範例：移除指定 Command Pack 插件

bl plugin remove --name @ali/bailian-plugin-agent

bl plugin link

連結白名單內的本機 Command Pack 以進行開發。無需鑑權。語法

bl plugin link --path <directory>

參數	類型	必填	說明
`--path <directory>`	string	是	本機 Command Pack 包目錄

範例：連結本機 Command Pack 以進行開發

bl plugin link --path ../bailian-plugin-agent

bl workspace init

初始化阿里雲百煉 Workspace 並啟用後付費服務。無需鑑權。語法

bl workspace init --access-key-id <id> --access-key-secret <secret> [--security-token <token>]

參數	類型	必填	說明
`--access-key-id <id>`	string	否	阿里雲 Access Key ID
`--access-key-secret <secret>`	string	否	阿里雲 Access Key Secret
`--security-token <token>`	string	否	阿里雲 STS Security Token（可選）

範例：使用密鑰初始化阿里雲百煉 Workspace

bl workspace init --access-key-id LTAIxxxxx --access-key-secret xxxxx

bl workspace list

列出全部 Workspace。語法

bl workspace list [flags]

參數	類型	必填	說明
`--list <n>`	string	否	限制結果數量

範例：預覽前 5 個 Workspace 列表

bl workspace list --list 5

bl console call

透過 CLI Gateway 呼叫阿里雲百煉控制台 API。語法

bl console call --api <api> --data <json> [flags]

參數	類型	必填	說明
`--api <api>`	string	是	API 名稱（例如 zeldaEasy.broadscope-bailian.memory-library.getLibraries）
`--data <json>`	string	是	JSON 字串格式的請求資料

範例：呼叫阿里雲百煉控制台 API 並傳入請求資料

bl console call --api zeldaEasy.bailian-commerce.freeTrial.queryFreeTierQuota --data '{"queryFreeTierQuotaRequest":{"models":["qwen3-max"]}}'

bl update

將 CLI 更新至最新版本或指定版本。無需鑑權。語法

bl update [--to <version>]

參數	類型	必填	說明
`--to <version>`	string	否	安裝指定版本，而非最新版本

範例：確認執行 CLI 版本更新至 0.1.14

bl update --to 0.1.14

執行 bl --help 可檢視全部命令分組。

​鑑權管理

​bl auth login

​bl auth status

​bl auth logout

​bl auth generate-access-token

​設定管理

​bl config set

​bl config show

​bl config list

​bl config use

​bl config ui

​bl config agent

​通用工具

​bl file upload

​bl model list

​bl advisor recommend

​bl pipeline run

​bl pipeline validate

​bl plugin install

​bl plugin list

​bl plugin remove

​bl plugin link

​bl workspace init

​bl workspace list

​bl console call

​bl update

鑑權管理

bl auth login

bl auth status

bl auth logout

bl auth generate-access-token

設定管理

bl config set

bl config show

bl config list

bl config use

bl config ui

bl config agent

通用工具

bl file upload

bl model list

bl advisor recommend

bl pipeline run

bl pipeline validate

bl plugin install

bl plugin list

bl plugin remove

bl plugin link

bl workspace init

bl workspace list

bl console call

bl update