零基础教程：5分钟在星图平台部署Qwen3-VL:30B多模态大模型

韦臻

284人浏览 · 2026-02-15 00:07:04

韦臻 · 2026-02-15 00:07:04 发布

零基础教程：5分钟在星图平台部署Qwen3-VL:30B多模态大模型

你是不是也想拥有一个能“看懂”图片、还能和你“聊天”的智能助手？比如，你发一张商品图，它能告诉你这是什么、有什么特点；你发一张表格截图，它能帮你分析数据；甚至你发一张风景照，它能给你写一段优美的描述。

今天，我就带你从零开始，在CSDN星图平台上，用5分钟时间部署目前最强的多模态大模型之一——Qwen3-VL:30B。这可不是普通的聊天机器人，它能同时处理文字和图片，理解能力超强。更重要的是，我们会把它变成一个私有化的智能助手，完全掌握在自己手里。

整个过程就像搭积木一样简单，不需要你懂复杂的服务器配置，也不需要你写很多代码。跟着我的步骤，一步步来，保证你能成功。

1. 准备工作：选择正确的“积木”

1.1 找到Qwen3-VL:30B镜像

首先，我们需要找到最核心的“积木”——Qwen3-VL:30B模型。这个模型有300亿参数，是目前多模态领域的第一梯队选手。

登录CSDN星图平台后，进入镜像市场。这里就像一个大超市，摆满了各种AI模型。我们直接搜索“Qwen3-vl:30b”，就能快速找到目标。

搜索Qwen3-VL镜像

为什么选这个版本？因为它支持图文对话、图表分析、文档理解等多种功能，而且30B的规模保证了回答的质量和深度。对于大多数应用场景来说，这个版本是性价比最高的选择。

1.30B模型对硬件要求不低，需要48GB显存。不过别担心，星图平台已经为我们准备好了合适的配置。创建实例时，直接使用平台推荐的默认配置就行，它会自动匹配48GB显存的GPU。

选择实例配置

点击启动后，等待几分钟，你的专属AI服务器就准备好了。这个过程是全自动的，你只需要喝杯咖啡等待就行。

1.3 测试模型是否正常工作

实例启动后，我们得先确认一下这个“积木”是不是好的。星图平台很贴心，已经预装了Ollama管理界面，我们可以直接通过Web界面和模型对话。

在控制台找到“Ollama控制台”的快捷入口，点击进入：

进入Ollama控制台

在Web界面里，你可以随便问几个问题，比如“你好，介绍一下你自己”，看看模型能不能正常回答：

测试对话

如果能看到正常的回复，说明模型部署成功了。不过，我们还需要确认API接口也能正常调用，因为后续的智能助手需要通过API来访问模型。

在本地电脑上运行下面这个Python脚本（记得把base_url换成你服务器的实际地址）：

from openai import OpenAI

# 注意：这里的地址需要替换成你实际的服务器地址
# 格式是：https://你的服务器地址-11434.web.gpu.csdn.net/v1
client = OpenAI(
    base_url="https://gpu-pod697b0f1855ba5839425df6ea-11434.web.gpu.csdn.net/v1",
    api_key="ollama"  # Ollama的默认API密钥
)

try:
    response = client.chat.completions.create(
        model="qwen3-vl:30b",
        messages=[{"role": "user", "content": "你好，你是谁？"}]
    )
    print("模型回复：", response.choices[0].message.content)
except Exception as e:
    print(f"连接失败，请检查：{e}")

如果运行后能看到模型的自我介绍，恭喜你！基础环境已经全部就绪了。

2. 搭建智能助手框架：安装Clawdbot

现在我们的核心模型已经准备好了，接下来需要给它装上一个“大脑外壳”，让它能更好地和我们交互。这个外壳就是Clawdbot——一个专门为AI助手设计的框架。

2.1 一键安装Clawdbot

Clawdbot的安装非常简单，因为星图平台已经预装了Node.js环境。我们只需要一条命令：

npm i -g clawdbot

安装Clawdbot

这条命令会在全局安装Clawdbot，安装过程大概需要1-2分钟。完成后，你就可以在任何目录下使用clawdbot命令了。

2.2 初始化配置向导

安装完成后，我们需要进行初始配置。别担心，Clawdbot提供了一个很友好的向导模式：

clawdbot onboard

运行这个命令后，你会看到一个交互式的配置界面。对于第一次使用的朋友，我建议大部分选项都先选择默认值或者跳过，后续我们可以在Web界面里慢慢调整。

向导会问你几个问题：

选择部署模式：选“本地模式”就行
是否启用高级功能：先跳过
配置存储路径：用默认的/root/.clawdbot

跟着提示一步步走，大概2-3分钟就能完成初始化。这个过程主要是创建一些必要的配置文件和目录结构。

2.3 启动管理网关

配置完成后，我们就可以启动Clawdbot的管理界面了：

clawdbot gateway

这个命令会启动一个Web管理界面，默认端口是18789。怎么访问呢？很简单，把你之前访问Ollama的地址，把端口号从11434改成18789就行。

比如你原来的地址是：

https://gpu-pod697b0f1855ba5839425df6ea-11434.web.gpu.csdn.net/

那么Clawdbot的管理地址就是：

https://gpu-pod697b0f1855ba5839425df6ea-18789.web.gpu.csdn.net/

在浏览器里打开这个地址，你应该能看到Clawdbot的控制台登录页面。

3. 解决访问问题：网络和安全配置

第一次访问Clawdbot控制台时，你可能会遇到页面空白或者无法访问的情况。别着急，这是正常的，因为默认配置只允许本地访问。我们需要做一点小小的调整。

3.1 修改监听配置

问题的原因是Clawdbot默认只监听本机地址（127.0.0.1），而我们需要让它监听所有网络接口，这样才能从公网访问。

打开配置文件进行编辑：

vim ~/.clawdbot/clawdbot.json

找到gateway这个部分，修改几个关键配置：

"gateway": {
    "mode": "local",
    "bind": "lan",  // 把这里从"loopback"改成"lan"
    "port": 18789,
    "auth": {
      "mode": "token",
      "token": "csdn"  // 设置一个访问令牌，比如"csdn"
    },
    "trustedProxies": ["0.0.0.0/0"],  // 添加这一行，信任所有代理
    "controlUi": {
      "enabled": true,
      "allowInsecureAuth": true
    }
}

主要改三个地方：

bind从loopback改成lan：让服务监听所有网络接口
设置一个token：这是后续登录管理界面的密码
添加trustedProxies：允许通过代理访问

修改后保存文件，然后重启Clawdbot服务（按Ctrl+C停止，再重新运行clawdbot gateway）。

3.2 登录管理界面

重启后刷新浏览器页面，这次应该能看到登录界面了。系统会提示你输入Token，就输入刚才在配置文件里设置的“csdn”。

输入Token登录

登录成功后，你会看到Clawdbot的管理面板。这里有很多功能模块，但今天我们主要关注两个：模型配置和聊天测试。

4. 核心连接：让Clawdbot使用我们的Qwen3-VL模型

现在到了最关键的一步——把Clawdbot和我们部署的Qwen3-VL:30B模型连接起来。这样Clawdbot就能用这个强大的多模态模型来回答问题了。

4.1 配置模型供应源

我们需要告诉Clawdbot，去哪里找我们的Qwen3-VL模型。再次编辑配置文件：

vim ~/.clawdbot/clawdbot.json

在配置文件中找到models.providers部分，添加一个新的供应源：

"models": {
    "providers": {
      "my-ollama": {  // 这是我们自定义的供应源名称
        "baseUrl": "http://127.0.0.1:11434/v1",  // Ollama的本地地址
        "apiKey": "ollama",  // Ollama的默认API密钥
        "api": "openai-completions",  // 使用OpenAI兼容的API格式
        "models": [
          {
            "id": "qwen3-vl:30b",  // 模型ID
            "name": "Local Qwen3 30B",  // 显示名称
            "contextWindow": 32000  // 上下文长度
          }
        ]
      }
    }
  }

这个配置告诉Clawdbot：有一个叫my-ollama的模型供应源，地址是本地的11434端口，里面有一个Qwen3-VL:30B模型可用。

4.2 设置默认模型

光有供应源还不够，我们还需要告诉Clawdbot默认使用哪个模型。在配置文件中找到agents.defaults部分：

"agents": {
  "defaults": {
    "model": {
      "primary": "my-ollama/qwen3-vl:30b"  // 使用我们刚添加的模型
    }
  }
}

这样配置后，Clawdbot就会默认使用我们的Qwen3-VL:30B模型来处理所有请求。

4.3 完整配置文件参考

如果你不想手动修改这么多地方，可以直接用下面的完整配置覆盖你的clawdbot.json文件：

{
  "meta": {
    "lastTouchedVersion": "2026.1.24-3",
    "lastTouchedAt": "2026-01-29T09:43:42.012Z"
  },
  "wizard": {
    "lastRunAt": "2026-01-29T09:43:41.997Z",
    "lastRunVersion": "2026.1.24-3",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "auth": {
    "profiles": {
      "qwen-portal:default": {
        "provider": "qwen-portal",
        "mode": "oauth"
      }
    }
  },
  "models": {
    "providers": {
      "my-ollama": {
        "baseUrl": "http://127.0.0.1:11434/v1",
        "apiKey": "ollama",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3-vl:30b",
            "name": "Local Qwen3 32B",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 32000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "my-ollama/qwen3-vl:30b"
      },
      "models": {
        "my-ollama/qwen3-vl:30b": {
          "alias": "qwen"
        }
      },
      "workspace": "/root/clawd",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "enabled": true,
      "allowInsecureAuth": true
    },
    "auth": {
      "mode": "token",
      "token": "csdn"
    },
    "trustedProxies": ["0.0.0.0/0"],
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "skills": {
    "install": {
      "nodeManager": "npm"
    }
  },
  "plugins": {
    "entries": {
      "qwen-portal-auth": {
        "enabled": true
      }
    }
  },
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "session-memory": {
          "enabled": true
        }
      }
    }
  }
}

保存配置文件后，需要重启Clawdbot服务让配置生效。