通义千问 Qwen (Archive)

Archived original-language source from the legacy CrabClaw docs. This page is intentionally not machine-translated.

通义千问是阿里云推出的大模型系列，涵盖通用对话、代码生成和视觉理解等能力。Qwen3.5-Max-Preview 是最新旗舰预览模型，在推理和代码生成方面大幅提升。Qwen 还提供免费层 OAuth 流程（每天 2000 次请求，受 Qwen 速率限制约束）。

模型概览

模型	类型	上下文窗口	特点
`qwen3.5-max-preview`	旗舰预览	128K	最新旗舰，推理与代码双强
`qwen-coder-plus`	代码生成	128K	代码专精，多语言支持
`qwen-max`	通用对话	32K	综合能力强，长文理解
`qwen-plus`	均衡	128K	性价比高，日常任务
`qwen-turbo`	快速	128K	响应快，轻量任务
`qwen-vl-max`	视觉	32K	多模态视觉理解

方式 A：阿里云 DashScope API Key

适用场景： 直接 API 访问，按量计费。

从阿里云 DashScope 获取 API Key。

CLI 设置

bash

crabclaw onboard --auth-choice qwen-api-key
# 或非交互模式
crabclaw onboard --qwen-api-key "$DASHSCOPE_API_KEY"
crabclaw onboard --auth-choice qwen-api-key
# 或非交互模式
crabclaw onboard --qwen-api-key "$DASHSCOPE_API_KEY"

配置示例

json5

{
  env: { DASHSCOPE_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "qwen/qwen3.5-max-preview" } } },
  models: {
    mode: "merge",
    providers: {
      qwen: {
        baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1",
        apiKey: "${DASHSCOPE_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "qwen3.5-max-preview",
            name: "Qwen3.5 Max Preview",
            reasoning: true,
            input: ["text"],
            contextWindow: 131072,
            maxTokens: 8192,
          },
          {
            id: "qwen-coder-plus",
            name: "Qwen Coder Plus",
            reasoning: false,
            input: ["text"],
            contextWindow: 131072,
            maxTokens: 8192,
          },
          {
            id: "qwen-max",
            name: "Qwen Max",
            reasoning: false,
            input: ["text"],
            contextWindow: 32768,
            maxTokens: 8192,
          },
          {
            id: "qwen-plus",
            name: "Qwen Plus",
            reasoning: false,
            input: ["text"],
            contextWindow: 131072,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}
{
  env: { DASHSCOPE_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "qwen/qwen3.5-max-preview" } } },
  models: {
    mode: "merge",
    providers: {
      qwen: {
        baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1",
        apiKey: "${DASHSCOPE_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "qwen3.5-max-preview",
            name: "Qwen3.5 Max Preview",
            reasoning: true,
            input: ["text"],
            contextWindow: 131072,
            maxTokens: 8192,
          },
          {
            id: "qwen-coder-plus",
            name: "Qwen Coder Plus",
            reasoning: false,
            input: ["text"],
            contextWindow: 131072,
            maxTokens: 8192,
          },
          {
            id: "qwen-max",
            name: "Qwen Max",
            reasoning: false,
            input: ["text"],
            contextWindow: 32768,
            maxTokens: 8192,
          },
          {
            id: "qwen-plus",
            name: "Qwen Plus",
            reasoning: false,
            input: ["text"],
            contextWindow: 131072,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

方式 B：Qwen Portal OAuth（免费层）

适用场景： 通过 OAuth 免费使用 Qwen Coder 和 Qwen Vision 模型。

启用插件

bash

crabclaw plugins enable qwen-portal-auth
crabclaw plugins enable qwen-portal-auth

启用后重启 Gateway。

认证

bash

crabclaw models auth login --provider qwen-portal --set-default
crabclaw models auth login --provider qwen-portal --set-default

这将运行 Qwen 设备码 OAuth 流程，并将供应商条目写入 models.json（加上 qwen 别名用于快速切换）。

Portal 模型 ID

qwen-portal/coder-model
qwen-portal/vision-model

切换模型：

bash

crabclaw models set qwen-portal/coder-model
crabclaw models set qwen-portal/coder-model

复用 Qwen Code CLI 登录

如果你已通过 Qwen Code CLI 登录，Crab Claw（蟹爪）会在加载认证存储时从 ~/.qwen/oauth_creds.json 同步凭据。你仍需要一个 models.providers.qwen-portal 条目（使用上面的登录命令创建）。

注意事项

模型引用格式为 qwen/<model>（DashScope）或 qwen-portal/<model>（OAuth）。
DashScope API 兼容 OpenAI 格式，使用 openai-completions API 类型。
Qwen3.5-Max-Preview 为预览版，功能可能变化。
Token 自动刷新；如果刷新失败或访问被撤销，请重新运行登录命令。
默认 Portal Base URL：https://portal.qwen.ai/v1（如果 Qwen 提供了不同端点，可通过 models.providers.qwen-portal.baseUrl 覆盖）。
参见模型供应商了解供应商规则。