Configuración y herramientas

Administre la autenticación de la CLI, cambie entre perfiles, navegue por el mercado de modelos, cargue archivos y use herramientas generales desde la terminal.

Agregue --help a cualquier comando para obtener detalles completos de los parámetros, por ejemplo: bl config show --help. Cada parámetro que acepta una URL de archivo también acepta una ruta local: la CLI lo carga automáticamente en almacenamiento temporal (válido durante 48 horas), por lo que nunca necesita hospedar archivos como URLs usted mismo. Los detalles de los comandos de esta página están verificados con bl 2.8.0. Las opciones globales pueden ir antes de la ruta completa del comando, por ejemplo bl --config token-plan auth status; las opciones específicas del comando y las credenciales deben seguir a la ruta.

Autenticación

Autentíquese con clave de API, inicio de sesión mediante navegador del consola o OpenAPI AK/SK (los credenciales pueden coexistir). No se requiere autenticación. Uso

bl auth login --api-key <key> | --console [--no-browser | --token-stdin --console-region <region>] | --open-api --access-key-id <id> --access-key-secret <secret>

Parámetro	Tipo	Obligatorio	Descripción
`--api-key <key>`	string	No	Clave de API del modelo para validar y almacenar
`--base-url <url>`	string	No	URL base de la API del modelo para validar y almacenar junto con --api-key
`--console`	switch	No	Iniciar sesión mediante navegador (China por defecto; use --console-site internacional para el sitio internacional). Crea una clave de API ordinaria si es necesario; los planes de suscripción requieren --api-key
`--no-browser`	switch	no	Con `--console`, muestra la URL de inicio de sesión sin abrir un navegador
`--token-stdin`	switch	no	Con `--console`, lee y valida un token de acceso de consola desde stdin; requiere `--console-region` y no abre navegador ni servidor local
`--console-region <region>`	string	no	Región de la pasarela de consola (por ejemplo, cn-beijing, ap-southeast-1)
`--console-site <site>`	string	No	Sitio del consola: doméstico, internacional
`--open-api`	switch	No	Almacenar credenciales de Alibaba Cloud OpenAPI AK/SK
`--access-key-id <id>`	string	No	ID de clave de acceso de Alibaba Cloud para almacenar
`--access-key-secret <secret>`	string	No	Secreto de clave de acceso de Alibaba Cloud para almacenar

Ejemplo: Autenticarse mediante inicio de sesión del navegador para el consola

bl auth login --console --console-site international

Si no se puede abrir un navegador, usa bl auth login --console --console-site international --no-browser para mostrar la URL de inicio de sesión, o importa un token de acceso desde stdin con --token-stdin.
El AK/SK de OpenAPI se resuelve como un grupo completo en este orden: parámetros del comando, BAILIAN_ACCESS_KEY_ID / BAILIAN_ACCESS_KEY_SECRET, configuración de Bailian y, por último, ALIBABA_CLOUD_ACCESS_KEY_ID / ALIBABA_CLOUD_ACCESS_KEY_SECRET. Los campos no se combinan entre fuentes. Los tokens STS provienen de la misma fuente: BAILIAN_SECURITY_TOKEN, la clave de configuración security_token o ALIBABA_CLOUD_SECURITY_TOKEN.
Los comandos de negocio de la consola no aceptan flags temporales de AK/SK. Si el token de consola falta o ha caducado, la CLI obtiene uno automáticamente con el AK/SK disponible, con como máximo un intercambio por solicitud.

bl auth status

Muestre el estado actual de autenticación. No se requiere autenticación. Uso

bl auth status

Este comando solo admite opciones globales. Ejemplo: Mostrar el estado de autenticación con salida JSON

bl auth status --output json

bl auth logout

Elimine las credenciales almacenadas; el cierre de sesión completo también elimina la URL base del modelo. No se requiere autenticación. Uso

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

Parámetro	Tipo	Obligatorio	Descripción
`--console`	switch	No	Solo elimine el access_token del consola, mantenga intacta la api_key
`--open-api`	switch	No	Solo elimine las credenciales de OpenAPI AK/SK/STS, mantenga intactas otras credenciales

Ejemplo: Eliminar solo el access_token del consola

bl auth logout --console

bl auth generate-access-token

Genere un token de acceso de la CLI usando AK/SK de OpenAPI. No se requiere autenticación. Uso

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

Parámetro	Tipo	Obligatorio	Descripción
`--access-key-id <id>`	string	Sí	ID de clave de acceso de Alibaba Cloud
`--access-key-secret <secret>`	string	Sí	Secreto de clave de acceso de Alibaba Cloud
`--security-token <token>`	string	No	Token de seguridad de STS de Alibaba Cloud para almacenar (opcional)

Ejemplo: Generar un token de acceso de la CLI con AK/SK y token STS opcional

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

Configuración

bl config set

Establezca un valor de configuración. No se requiere autenticación. Uso

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

Parámetro	Tipo	Obligatorio	Descripción
`--key <key>`	string	Sí	Clave de configuración (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	Sí	Valor a establecer

Ejemplo: Establecer la clave de configuración language en zh-CN

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

bl config show

Muestre la configuración actual. No se requiere autenticación. Uso

bl config show

Este comando solo admite opciones globales. Ejemplo: Mostrar la configuración actual con salida JSON

bl config show --output json

Muestra las fuentes efectivas de la API Key y la Base URL y avisa cuando la solicitud usa valores de fuentes de configuración diferentes.

bl config list

Muestre los perfiles de configuración y muestre el perfil activo. No se requiere autenticación. Uso

bl config list

Este comando solo admite opciones globales. Ejemplo: Listar perfiles de configuración con el perfil activo en salida JSON

bl config list --output json

bl config use

Establezca el perfil de configuración activo. No se requiere autenticación. Uso

bl config use --name <name>

Parámetro	Tipo	Obligatorio	Descripción
`--name <name>`	string	Sí	Nombre de perfil existente, o default

Ejemplo: Establecer el perfil de configuración activo como token-plan

bl config use --name token-plan

bl config ui

Abra una interfaz web local para gestionar perfiles de configuración. No se requiere autenticación. Uso

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

Parámetro	Tipo	Obligatorio	Descripción
`--port <port>`	number	No	Puerto en el que escuchar (predeterminado: puerto libre aleatorio)
`--no-open`	switch	No	No abra el navegador automáticamente

Ejemplo: Abrir la interfaz web de gestión de configuración en el puerto 8787

bl config ui --port 8787

bl config agent

Configura un agente de codificación para usar la API DashScope. No se requiere autenticación. Uso

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

Parámetro	Tipo	Obligatorio	Descripción
`--agent <name>`	string	Sí	Agente objetivo: claude-code, qwen-code, opencode, openclaw, hermes, codex, pi
`--base-url <url>`	string	No	URL base de la API
`--region <region>`	string	No	Región de Model Studio (por ejemplo, cn-beijing, ap-southeast-1); convertida en --base-url. Solo para Plan de Tokens
`--api-key <key>`	string	No	Clave de API
`--key <encoded>`	string	No	Clave de API obfuscada desde la consola web (comienza con "o1_"); decodificada en --api-key
`--model <model>`	string	Sí	Nombre del modelo predeterminado
`--context-window <tokens>`	number	No	Solo OpenClaw: tamaño de ventana de contexto del modelo en tokens (predeterminado: 256000)
`--wire-api <api>`	string	No	Solo Codex: protocolo de cableado (predeterminado: responses). "chat" solo funciona con Codex heredado <= 0.80.0

Ejemplo: Configurar el agente de codificación para usar la API DashScope con configuraciones especificadas

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

Salida y diagnóstico

El formato de salida predeterminado es text. Cambie a JSON con --output json, DASHSCOPE_OUTPUT=json o la clave de configuración output.

El modo JSON devuelve el resultado de negocio completo en stdout. Los avisos, diagnósticos y errores se escriben por separado en stderr como JSONL, para que scripts y agentes los analicen de forma independiente.
El modo quiet solo oculta el progreso y los mensajes de proceso, y conserva los resultados completos, los avisos y los errores. Defina DASHSCOPE_QUIET=1 para activar quiet. Los scripts que extraían ID, rutas o respuestas de quiet deben leer los campos JSON.
--introspect imprime el esquema de comando legible por máquina (JSON) y sale, para que los agentes puedan descubrir comandos y parámetros.
El inicio de sesión interactivo, la interfaz de configuración local y los flujos de eventos de Pipeline usan salida text. Para obtener JSON en la salida de audio en streaming, especifique un archivo con --out.

Herramientas generales

bl file upload

Carga un archivo local al almacenamiento temporal de DashScope (48 h). Requiere autenticación con clave de API. Uso

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

Parámetro	Tipo	Obligatorio	Descripción
`--file <path>`	string	Sí	Archivo local a cargar (imagen, video, audio)
`--model <model>`	string	Sí	Nombre del modelo objetivo (el archivo está vinculado a este modelo)

Ejemplo: Cargar photo.jpg al almacenamiento de DashScope vinculado al modelo qwen3-vl-plus

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

El servicio de carga se selecciona según el Endpoint del modelo activo. Las cargas temporales oficiales solo admiten las regiones de Pekín y Singapur; las regiones no admitidas y Token Plan fallan explícitamente.
Un proxy de carga personalizado especificado explícitamente ya no se rechaza según el tipo de clave.
Las cargas de archivos locales al OSS temporal siguen --timeout.

bl model list

Explora familias de modelos o muestra información detallada de modelos en el mercado de modelos Bailian. No se requiere autenticación. Uso

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]

Parámetro	Tipo	Obligatorio	Descripción
`--model <model>`	string	No	Muestra detalles completos de una familia de modelos específica (activa el modo detallado)
`--page <n>`	number	No	Número de página (predeterminado: 1)
`--page-size <n>`	number	No	Resultados por página (predeterminado: 10)
`--provider <p>`	array	No	Filtra por proveedor (repetible, por ejemplo: --provider alibaba --provider deepseek)
`--capability <c>`	array	No	Filtra por código de capacidad (TG, Reasoning, VU, IG, VG, TTS, ASR, …)
`--feature <f>`	array	No	Filtra por funcionalidad (function-calling, web-search, structured-outputs, …)
`--context-window <w>`	array	No	Filtra por rango de ventana de contexto
`--input-modality <m>`	array	No	Requiere una modalidad de entrada (repetible: Texto, Imagen, Video, Audio)
`--output-modality <m>`	array	No	Requiere una modalidad de salida (repetible: Texto, Imagen, Video, Audio)
`--include-deprecated`	switch	No	Incluir modelos que ya están fuera de línea (ocultos por defecto)
`--enrich`	switch	No	También obtener el esquema de parámetros de entrada (predictConfig) para modelos principales (solo en modo detallado)

Ejemplo: Listar modelos proporcionados por alibaba

bl model list --provider alibaba

Ambos el catálogo y los puntos finales de esquema de parámetros --enrich son públicos; no se necesita inicio de sesión en la consola.
El modo de navegación oculta los modelos que ya están fuera de línea; use --include-deprecated para incluirlos. El modo detallado (--model) siempre lista cada versión y marca su estado.

bl model search

Busca en el catálogo de modelos por palabra clave, ordenado por relevancia. No requiere autenticación. Uso

bl model search --keyword <kw> [--limit <n>] [--provider <p>...] [--capability <c>...] [--feature <f>...] [--context-window <w>...] [--input-modality <m>...] [--output-modality <m>...] [--include-deprecated]

Parámetro	Tipo	Obligatorio	Descripción
`--keyword <kw>`	string	Sí	Palabra clave que se compara con el ID, nombre, capacidades, características y descripción del modelo
`--limit <n>`	number	No	Número máximo de resultados (por defecto: 20)
`--provider <p>`	array	No	Filtrar por proveedor (repetible, por ejemplo --provider alibaba --provider deepseek)
`--capability <c>`	array	No	Filtrar por código de capacidad (TG, Reasoning, VU, IG, VG, TTS, ASR, etc.)
`--feature <f>`	array	No	Filtrar por característica (function-calling, web-search, structured-outputs, etc.)
`--context-window <w>`	array	No	Filtrar por rango de ventana de contexto
`--input-modality <m>`	array	No	Exigir una modalidad de entrada (Text, Image, Video, Audio)
`--output-modality <m>`	array	No	Exigir una modalidad de salida (Text, Image, Video, Audio)
`--include-deprecated`	switch	No	Incluir modelos que ya están fuera de línea

Ejemplo：Buscar modelos cuyo nombre contenga qwen

bl model search --keyword qwen

La búsqueda recorre todo el catálogo, pero oculta los modelos fuera de línea de forma predeterminada; usa --include-deprecated para incluirlos.
La API del catálogo de modelos es pública; no se necesita iniciar sesión en la consola.

bl model code

Muestra un ejemplo de SDK listo para usar para llamar a un modelo. No requiere autenticación. Uso

bl model code --model <model> [--sdk <sdk>] [--api <style>] [--lang <lang>]

Parámetro	Tipo	Obligatorio	Descripción
`--model <model>`	string	Sí	Modelo para el que generar un ejemplo
`--sdk <sdk>`	string	No	Tipo de SDK: openai (por defecto) o dashscope
`--api <style>`	string	No	Estilo de API: completions (por defecto) o responses
`--lang <lang>`	string	No	Lenguaje del fragmento (por defecto: python); pasa un valor no compatible para ver las opciones

Ejemplo：Generar un ejemplo de Python para qwen-max

bl model code --model qwen-max

Ejemplo：Generar un ejemplo de curl para qwen-max

bl model code --model qwen-max --lang curl

La salida de texto es solo el fragmento, por lo que se puede redirigir a un archivo; usa --output json para obtener el fragmento y sus metadatos.
La URL base del ejemplo contiene un marcador [workspace-id]. Reemplázalo, o define BAILIAN_WORKSPACE_ID y usa el endpoint de DashScope.
Las combinaciones disponibles se publican por modelo; pasa un valor desconocido para ver la lista.
--api acepta completions o responses; se ignora cuando el SDK solo admite un estilo.

Recomienda los mejores modelos para su caso de uso (análisis de intención → recuperación de candidatos → clasificación de LLM). Requiere autenticación con clave de API. Uso

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

Parámetro	Tipo	Obligatorio	Descripción
`--message <text>`	string	Sí	Describa sus requisitos
`--top <n>`	number	no	Número de recomendaciones (predeterminado: 3)
`--model <model>`	string	no	LLM usado en todas las etapas: agente, intención, puntuación y explicación (predeterminado: qwen-flash-2025-07-28)
`--no-agent`	switch	no	Omite el bucle del agente y ejecuta directamente el motor determinista
`--trace`	switch	no	Escribe el rastro completo de enrutamiento y rendimiento en stderr
`--think`	switch	no	Muestra el proceso de decisión del motor en stderr
`--no-thinking`	switch	no	Parámetro de compatibilidad obsoleto, sin efecto; las llamadas de recomendación siempre desactivan el modo de pensamiento

Ejemplo: Recomendar los mejores modelos para un requerimiento de chatbot de comprensión visual

bl advisor recommend --message "I need a visual-understanding chatbot"

Ejemplo: Omitir la aclaración del Agent y ejecutar el motor de recomendación directamente

bl advisor recommend --message "Crear una transmisión en vivo de humano digital" --no-agent

El flujo de recomendación es análisis de intención → enrutamiento → recuperación de candidatos → puntuación → clasificación. Las terminales interactivas admiten aclaraciones del agente y recomendaciones de varios pasos, conservando la estructura JSON del resultado.
--trace y --think solo escriben en stderr y no cambian el resultado de la recomendación en stdout.

bl pipeline run

Ejecuta una definición de flujo de trabajo de pipeline. No se requiere autenticación. Uso

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

Parámetro	Tipo	Obligatorio	Descripción
`--file <path>`	string	Sí	Archivo de definición de pipeline (YAML/JSON)
`--input <json>`	string	No	Entrada en tiempo de ejecución como JSON incrustado
`--input-file <path>`	string	No	Entrada en tiempo de ejecución desde un archivo JSON
`--concurrency <n>`	number	No	Máximo número de pasos en paralelo (predeterminado: 1)
`--events <format>`	string	No	Emitir eventos de ciclo de vida: jsonl
`--step-timeout <seconds>`	number	No	Tiempo de espera predeterminado por paso en segundos

Ejemplo: Ejecutar flujo de trabajo de pipeline desde workflow.yaml con entrada {'brief':'hello'}

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

--events jsonl usa el modo de salida de texto. Los flujos de eventos de Pipeline no se pueden mezclar con otros formatos de salida.

bl pipeline validate

Valida una definición de pipeline sin ejecutarla. No se requiere autenticación. Uso

bl pipeline validate --file <path>

Parámetro	Tipo	Obligatorio	Descripción
`--file <path>`	string	Sí	Archivo de definición de pipeline (YAML/JSON)

Ejemplo: Validar definición de pipeline desde archivo

bl pipeline validate --file workflow.yaml

bl plugin install

Instala o actualiza un paquete de Comandos permitido. No se requiere autenticación. Uso

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

Parámetro	Tipo	Obligatorio	Descripción
`--package <name[@version]>`	string	Sí	Nombre del paquete de Comandos permitidos y versión o etiqueta opcional

Ejemplo: Instalar paquete de Comandos permitidos

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

bl plugin list

Lista los paquetes de Comandos instalados y su estado de carga. No se requiere autenticación. Uso

bl plugin list

Este comando solo admite opciones globales. Ejemplo: Listar paquetes de Comandos instalados con salida en formato JSON

bl plugin list --output json

bl plugin remove

Elimina un paquete de Comandos instalado. No se requiere autenticación. Uso

bl plugin remove --name <package>

Parámetro	Tipo	Obligatorio	Descripción
`--name <package>`	string	Sí	Nombre del paquete de Comandos permitidos

Ejemplo: Eliminar paquete de Comandos instalado por nombre

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

bl plugin link

Vincule un paquete de comandos local permitido para desarrollo. No se requiere autenticación. Uso

bl plugin link --path <directory>

Parámetro	Tipo	Obligatorio	Descripción
`--path <directory>`	string	Sí	Directorio del paquete de comandos local

Ejemplo: Vincular paquete de comandos local para desarrollo

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

bl workspace init

Inicialice el entorno de Bailian y active servicios de facturación postpago. No se requiere autenticación. Uso

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

Parámetro	Tipo	Obligatorio	Descripción
`--access-key-id <id>`	string	No	ID de clave de acceso de Alibaba Cloud
`--access-key-secret <secret>`	string	No	Secreto de clave de acceso de Alibaba Cloud
`--security-token <token>`	string	No	Token de seguridad STS de Alibaba Cloud (opcional)

Ejemplo: Inicializar entorno con claves de acceso

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

bl workspace list

Liste todos los entornos. Uso

bl workspace list [flags]

Parámetro	Tipo	Obligatorio	Descripción
`--list <n>`	string	No	Limitar el número de resultados

Ejemplo: Listar entornos con límite

bl workspace list --list 5

bl console call

Llame a una API de consola de Bailian a través de la puerta de enlace CLI. Uso

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

Parámetro	Tipo	Obligatorio	Descripción
`--api <api>`	string	Sí	Nombre de la API (por ejemplo, zeldaEasy.broadscope-bailian.memory-library.getLibraries)
`--data <json>`	string	Sí	Datos de solicitud como cadena JSON

Ejemplo: Llamar a la API de consola de Bailian con datos

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

bl update

Actualice la CLI a la versión más reciente o a una versión especificada. No se requiere autenticación. Uso

bl update [--to <version>]

Parámetro	Tipo	Obligatorio	Descripción
`--to <version>`	string	No	Instalar esta versión exacta en lugar de la más reciente

Ejemplo: Actualizar CLI a versión específica

bl update --to 0.1.14

bl update devuelve un código de salida distinto de cero si la actualización falla o no se puede determinar la última versión.

Ejecute bl --help para ver todos los grupos de comandos.

​Autenticación

​bl auth login

​bl auth status

​bl auth logout

​bl auth generate-access-token

​Configuración

​bl config set

​bl config show

​bl config list

​bl config use

​bl config ui

​bl config agent

​Salida y diagnóstico

​Herramientas generales

​bl file upload

​bl model list

​bl model search

​bl model code

​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