Skip to main content

Agregar capacidades de comprensión visual

Algunos modelos compatibles con Token Plan (qwen3.8-max, qwen3.7-plus, etc.) admiten nativamente la comprensión visual y pueden procesar entradas de imagen directamente. Para modelos solo de texto como glm-5.2 y deepseek-v4-pro, puede agregar capacidades visuales configurando una Skill local.

Ejecutar la Skill de comprensión de imágenes consume Créditos del Token Plan. No se aplican cargos adicionales.

Requisitos previos

  1. Se ha suscrito al Token Plan (Personal o Team).
  2. Ha completado la configuración de integración en una herramienta de IA y puede chatear normalmente. Para más detalles, consulte Clientes y Herramientas de Desarrollo.

Soporte de visión

Para saber si cada modelo admite la comprensión visual, consulte las tablas de modelos compatibles en Resumen de Token Plan Personal Edition y Resumen de Token Plan Team Edition.

Método 1: Usar un modelo de visión directamente (recomendado)

qwen3.7-plus y otros modelos tienen capacidades de comprensión visual. Si necesita procesar imágenes con frecuencia, cambiar a uno de estos modelos es el enfoque más sencillo y recomendado.

Herramienta

Cómo cambiar de modelo

Claude Code

/model qwen3.8-max o /model qwen3.8-flash o /model qwen3.7-plus

OpenCode

/models luego busque y seleccione qwen3.8-max o qwen3.8-flash o qwen3.7-plus

Qwen Code

/model luego seleccione qwen3.8-max o qwen3.8-flash o qwen3.7-plus

Para obtener más información sobre cómo cambiar modelos en otras herramientas de codificación, consulte Clientes y Herramientas de Desarrollo. Después de cambiar, puede hacer referencia a rutas de imágenes directamente en su conversación, o arrastrar y soltar/pegar imágenes.

Método 2: Agregar capacidades visuales mediante Skill o Agent

Si necesita usar modelos solo de texto como glm-5.2 o deepseek-v4-pro para el procesamiento de imágenes, puede configurar una Skill o un Agent para habilitar capacidades visuales.
  • Claude Code
  • OpenCode
  1. Agregar la Skill Cree una carpeta .claude en el directorio de su proyecto, luego cree un directorio skills/image-analyzer dentro de ella: 
mkdir -p .claude/skills/image-analyzer
Cree un archivo SKILL.md en ese directorio con el siguiente contenido:
---
name: image-analyzer
description: Helps models without vision capabilities understand images. Use this skill when you need to analyze image content, extract information, text, or UI elements from images, or understand screenshots, charts, architecture diagrams, or any visual content. Simply pass in the image path to get a description.
model: qwen3.7-plus
---
qwen3.7-plus has visual understanding capabilities. Use qwen3.7-plus directly for image understanding.
La estructura de directorios resultante es la siguiente:
.claude/
└── skills/
    └── image-analyzer/
        └── SKILL.md
  1. Comenzar
    1. Ejecute claude en el directorio de su proyecto para iniciar Claude Code, luego ejecute /model deepseek-v4-pro para cambiar al modelo deepseek-v4-pro.
    2. Descargue alibabacloud.png al directorio de su proyecto, luego pregunte: Load image-analyzer skill and describe the information displayed at the alibabacloud.png banner location. Recibirá una respuesta similar a la siguiente: alibabacloud.png es una captura de pantalla de la página principal de Alibaba Cloud. El título del área del banner es Coding Plan now supports Qwen3.5, y el texto indica que Alibaba Cloud Model Studio admite modelos como Qwen3.5, Kimi-k2.5 y GLM-4.7, con los nuevos clientes obteniendo el primer mes por solo 7.9 yuanes. La página proporciona puntos de entrada de Subscribe now y Online consultation.

FAQ

Causa: OpenCode no habilita las capacidades de visión de un modelo de forma predeterminada. Debe declarar explícitamente el parámetro modalities en el archivo de configuración.Solución: Agregue un campo modalities a la definición del modelo en su archivo de configuración de OpenCode y establezca input en ["text", "image"], como se muestra a continuación:
Reemplace sk-sp-xxx con su API Key del Token Plan. 
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "bailian-token-plan": {
      "npm": "@ai-sdk/anthropic",
      "name": "Model Studio Token Plan",
      "options": {
        "baseURL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "apiKey": "sk-sp-xxx"
      },
      "models": {
        "qwen3.7-plus": {
          "name": "Qwen3.6 Plus",
          "modalities": {
            "input": [
              "text",
              "image"
            ],
            "output": [
              "text"
            ]
          },
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 1024
            }
          }
        },
        "qwen3.8-flash": {
          "name": "Qwen3.8 Flash",
          "modalities": {
            "input": [
              "text",
              "image"
            ],
            "output": [
              "text"
            ]
          },
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 1024
            }
          }
        },
        "qwen3.8-max": {
          "name": "Kimi K2.5",
          "modalities": {
            "input": [
              "text",
              "image"
            ],
            "output": [
              "text"
            ]
          },
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 1024
            }
          }
        }
      }
    }
  }
}
Causa: OpenClaw requiere el campo input en el archivo de configuración para determinar si un modelo admite capacidades de visión.Solución:
  1. En el archivo de configuración ~/.openclaw/openclaw.json, asegúrese de que la definición del modelo incluya el campo "input": ["text", "image"].
{
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.7-plus",
            "name": "qwen3.7-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 1000000,
            "maxTokens": 65536
          },
          {
            "id": "qwen3.8-flash",
            "name": "qwen3.8-flash",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 1000000,
            "maxTokens": 65536
          },
          {
            "id": "qwen3.8-max",
            "name": "qwen3.8-max",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 262144,
            "maxTokens": 32768
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.7-plus"
      },
      "models": {
        "bailian/qwen3.7-plus": {},
        "bailian/qwen3.8-flash": {},
        "bailian/qwen3.8-max": {}
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}
  1. Después de modificar la configuración, debe borrar la caché de modelos de OpenClaw y reiniciar. De lo contrario, la configuración anterior permanecerá vigente.
rm ~/.openclaw/agents/main/agent/models.json
openclaw gateway restart