跳到內容

Qwen 接入指南:免費爽玩 Coder 與 Vision 模型

我最近在處理一些前端組件的重構,發現 Qwen Coder 的表現真的很有料,重點是它竟然有免費額度。以前我老是為了省那一點點 API 費用,在那邊手動複製貼上到網頁端,真的有夠累。

後來我直接把 Qwen 整合進我的工作流,發現它提供的 OAuth 流程非常大方,每天 2,000 次請求對個人開發者來說根本用不完。如果你也想省下這筆開銷,照著下面的步驟做,幾分鐘就能搞定。

  • 已經安裝好的 OpenClaw 環境
  • 一個可以登入 portal.qwen.ai 的帳號

只要五分鐘,你就能把 Qwen 的模型跑起來:

  1. 啟用插件 在你的終端機輸入這行指令:

    Terminal window
    openclaw plugins enable qwen-portal-auth
  2. 重啟 Gateway 啟用插件後,記得重啟你的 Gateway 才會生效。

  3. 完成驗證 執行下面的指令,這會啟動 Qwen 的 device-code 流程,你會看到一個連結,點進去登入後就完成了:

    Terminal window
    openclaw models auth login --provider qwen-portal --set-default

    這步會自動把設定寫入你的 models.json,並幫你設好 qwen 這個縮寫。

  4. 切換模型 看你想寫扣還是看圖,直接切換:

    Terminal window
    openclaw models set qwen-portal/coder-model

目前你可以直接調用這兩個主要模型:

  • qwen-portal/coder-model:專門處理程式碼相關任務。
  • qwen-portal/vision-model:處理圖片辨識與分析。

如果你之前已經有用過 Qwen Code CLI 登入過,OpenClaw 很聰明,它會自動從 ~/.qwen/oauth_creds.json 同步你的憑證,省去重複登入的麻煩。

  • Token 刷新失敗:雖然系統會自動 refresh,但如果你的權限被撤銷或過期太久,最快的方法就是重新執行一次 login 指令。
  • 連線問題:預設的 API Base URL 是 https://portal.qwen.ai/v1。如果 Qwen 之後改了網址,你可以在 models.providers.qwen-portal.baseUrl 手動覆蓋它。

如果你在設定過程中卡住了,可以去問問 AI Setup Assistant,它能幫你快速排查。

OpenClaw

OpenClaw Expert

還是卡住了?

如果這篇文件沒有解決你的情境,直接問 OpenClaw Expert,拿到可執行步驟。