1. 先定位 CLI 動作 endpointQwen-UI-Agent 的 Base URL 不在 prompt 里排查 Qwen-UI-Agent 的 CLI 動作時最容易誤判的一層是看到 GUI 截圖正常、模型也能輸出動作就以為 CLI 動作的 endpoint 在 shell adapter 里。TaoToken 官網(wǎng)https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentqwen_ui_agent_cli_intro可以完成注冊、創(chuàng)建 Key 和控制臺管理但真正決定 CLI 動作請求發(fā)到哪里的是模型推理客戶端的 Base URL。Qwen-UI-Agent 把圖形界面動作和命令行動作放在同一個決策循環(huán)里模型先讀取屏幕狀態(tài)、任務歷史和可用動作空間再返回結構化 action其中 GUI 動作可能是點擊、輸入、滾動、長按CLI 動作可能是列目錄、下載文件、運行分析腳本、生成表格或批量檢查輸出。很多接入問題不是模型不會做而是請求還沒有到達正確的推理 endpoint。把鏈路拆開看會更清楚Qwen-UI-Agent 運行時收集屏幕狀態(tài)、任務歷史和工具描述。運行時把上下文發(fā)給 OpenAI 兼容的模型 endpoint。模型返回 JSON 動作里面可能同時包含 GUI action 和 CLI action。動作路由器再決定哪些交給圖形執(zhí)行器哪些交給本地 shell 執(zhí)行器。CLI 執(zhí)行器在沙箱或工作目錄中執(zhí)行命令并把 stdout、stderr、exit code 寫回軌跡。所以本文的視角不是改 prompt而是從 CLI 動作 endpoint 反推到 Base URL 層。你需要把推理請求統(tǒng)一指到https://taotoken.net/apiKey 統(tǒng)一使用占位符YOUR_API_KEY這樣.env、curl 驗證、Qwen-UI-Agent runner、Claude Code、Codex、CC Switch 才不會各寫一套地址。最常見的錯誤是GUI 動作偶爾能跑CLI 動作頻繁失敗日志里卻只看到“動作解析失敗”或“命令未執(zhí)行”。實際根因可能是 Base URL 仍指向舊供應商或者路徑被拼成了錯誤的/v1層級。先定位 endpoint再談動作空間排障速度會快很多。2. Qwen-UI-Agent 的 GUICLI 混合動作空間endpoint 實際發(fā)生在模型推理層Qwen-UI-Agent 這類 GUI Agent 的關鍵變化是把“看屏幕”和“敲命令”放進同一套動作表示里。屏幕負責處理沒有開放 API 的頁面、應用和彈窗CLI 負責處理可腳本化、可復現(xiàn)、可批量執(zhí)行的部分。例如一個桌面調研任務里GUI 可能負責打開瀏覽器、定位財報頁面、翻頁、截圖核對CLI 可能負責下載文件、解壓、跑 Python 分析、生成 Excel/PPT/Word再讓 GUI 檢查版式是否異常。這個混合動作空間有一個容易忽略的事實CLI 動作不是模型直接連 shell。模型本身不執(zhí)行命令它只輸出動作意圖。真正執(zhí)行命令的是本地或受控環(huán)境里的 runner。也就是說CLI 動作 endpoint 的第一跳是模型推理 API第二跳才是本地命令執(zhí)行器。第一跳寫錯后面全部白搭?？梢杂靡粋€簡化日志理解[agent] taskdesktop_research [agent] observationscreenhistory [agent] inference.base_urlhttps://taotoken.net/api [agent] inference.endpointhttps://taotoken.net/api/v1/chat/completions [agent] modelYOUR_MODEL_ID [agent] response.actions3 [agent] action[0].typegui [agent] action[1].typecli [agent] action[2].typecli [cli] workdir/tmp/qwen-ui-agent-workspace [cli] dry_runtrue如果inference.base_url不是https://taotoken.net/api那么response.actions很可能為空或者返回的是自然語言說明而不是可路由動作。此時你去改 CLI 執(zhí)行器沒有意義。正確順序是先確認 OpenAI 兼容客戶端的base_url。再確認 API Key 是否能通過鑒權。再確認模型 ID 是否可用。再確認動作 schema 是否被約束為 JSON。最后才開啟 CLI 執(zhí)行并優(yōu)先使用 dry run。很多長程任務會輸出批量動作例如一次決策里同時給出“列目錄、讀取 CSV 前幾行、統(tǒng)計行數(shù)、生成中間文件”。批量動作能減少往返次數(shù)但也放大了 Base URL 錯誤的影響一旦推理 endpoint 不對整批 CLI 動作都不會進入執(zhí)行器。因此本文后面會用 curl 請求和 CLI 動作日志做對照讓每一層都可驗證。3. 去 TaoToken 創(chuàng)建 Key把控制臺步驟收斂成 .env 片段上一節(jié)確認了 Base URL 層的重要性。接下來把 Key 和地址寫進項目配置。TaoToken 官網(wǎng)https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentqwen_ui_agent_key_console提供控制臺入口注冊、登錄、創(chuàng)建 API Key 都在官網(wǎng)完成。建議不要把 Key 寫進腳本、Notebook 或 Git 倉庫而是放進項目根目錄的.env并確認.gitignore已忽略它。創(chuàng)建 Key 的流程可以收斂為打開 TaoToken 官網(wǎng)完成賬號登錄。進入控制臺創(chuàng)建 API Key。Key 只在創(chuàng)建時完整顯示復制后保存到密碼管理器。在模型對話或模型列表里確認可用模型 ID不要憑記憶猜模型名。回到 Qwen-UI-Agent 項目根目錄寫入.env。下面是一個可復制的.env片段。不同 runner 的變量名可能不同請把左側變量映射到你實際讀取的環(huán)境變量名但地址和 Key 的值保持統(tǒng)一# Qwen-UI-Agent 推理側OpenAI 兼容變量 OPENAI_API_KEYYOUR_API_KEY OPENAI_BASE_URLhttps://taotoken.net/api OPENAI_MODELYOUR_MODEL_ID # 如果 runner 使用自定義前綴可同步維護這一組 TAOTOKEN_API_KEYYOUR_API_KEY TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_MODELYOUR_MODEL_ID # CLI 動作執(zhí)行側先 dry run避免誤操作 AGENT_CLI_ENABLEDtrue AGENT_CLI_DRY_RUNtrue AGENT_CLI_TIMEOUT_SECONDS60 AGENT_CLI_WORKDIR/tmp/qwen-ui-agent-workspace這里有兩個原則。第一Base URL 寫https://taotoken.net/api不要帶 UTM 參數(shù)。UTM 只用于官網(wǎng)頁面歸因不用于 API 請求。第二CLI 動作默認dry_runtrue先看日志里準備執(zhí)行什么命令再決定是否放開真實執(zhí)行。對于支付、刪除、隱私授權、生產數(shù)據(jù)庫寫入等敏感動作模型側和 runner 側都應該要求人工確認。本文里的 SQL 和命令都建議由讀者在本地或隔離環(huán)境執(zhí)行不要讓 Agent 在無人監(jiān)督下直連生產庫。如果項目使用 Python OpenAI SDK映射方式如下import os from openai import OpenAI client OpenAI( api_keyos.environ[OPENAI_API_KEY], base_urlos.environ[OPENAI_BASE_URL], ) resp client.chat.completions.create( modelos.environ[OPENAI_MODEL], messages[ {role: system, content: 只輸出 JSON 動作不要輸出 Markdown。}, {role: user, content: 返回一個安全的 cli 動作列出當前工作目錄。}, ], temperature0, response_format{type: json_object}, ) print(resp.choices[0].message.content)如果 SDK 報 404不要先改模型名。先檢查OPENAI_BASE_URL是否被寫成了帶/v1的地址以及 OpenAI SDK 自己會拼接什么路徑。對于手寫 curl使用完整的 OpenAI 兼容路徑對于 SDKBase URL 層保持https://taotoken.net/api。兩者不是一回事但來源必須一致。4. 用 curl 驗證 CLI 動作 endpoint請求體與動作日志一一對照在啟動 Qwen-UI-Agent 之前先用 curl 做一次最小推理請求。這個請求不執(zhí)行任何 CLI 命令只驗證模型 endpoint 是否能返回結構化動作。把YOUR_API_KEY和YOUR_MODEL_ID替換成真實值后在本地終端執(zhí)行curl -sS https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d { model: YOUR_MODEL_ID, temperature: 0, messages: [ { role: system, content: 你是 Qwen-UI-Agent 的推理側。只輸出 JSON不要 Markdown。動作字段 type 只能是 gui 或 cli。cli 動作必須包含 cmd并且不得包含刪除、支付、生產庫寫入。 }, { role: user, content: 在桌面 Google Growth Analysis 文件夾中檢查是否有 CSV讀取前 3 行并返回一個 batched cli 動作。不要真正執(zhí)行寫操作。 } ], response_format: {type: json_object} }期望返回的content是一段 JSON 字符串而不是解釋性 Markdown。示例{ actions: [ { type: cli, cmd: ls -la \$HOME/Desktop/Google Growth Analysis\, batch: true }, { type: cli, cmd: head -n 3 \$HOME/Desktop/Google Growth Analysis\/*.csv, batch: true } ] }拿到這個響應后再啟動 Qwen-UI-Agent觀察日志里是否出現(xiàn)同一批動作。對照關系如下# 請求側 POST https://taotoken.net/api/v1/chat/completions Authorization: Bearer YOUR_API_KEY modelYOUR_MODEL_ID response_formatjson_object # 日志側 [agent] inference.base_urlhttps://taotoken.net/api [agent] inference.endpointhttps://taotoken.net/api/v1/chat/completions [agent] modelYOUR_MODEL_ID [agent] action_plan.count2 [agent] action[0].typecli [agent] action[0].cmdls -la \$HOME/Desktop/Google Growth Analysis\ [agent] action[0].batchtrue [agent] action[1].typecli [agent] action[1].cmdhead -n 3 \$HOME/Desktop/Google Growth Analysis\/*.csv [agent] action[1].batchtrue [cli] dry_runtrue [cli] exit_code0如果 curl 能返回動作但 Qwen-UI-Agent 日志里沒有action_plan說明 runner 讀取的不是同一套環(huán)境變量或者它的配置文件覆蓋了.env。如果 curl 返回 401檢查Authorization頭、Key 是否復制完整、是否有多余空格。如果 curl 返回 404檢查路徑是不是/v1/chat/completions以及 Base URL 是否寫成https://taotoken.net/api。如果 curl 返回自然語言而不是 JSON先把 system prompt 收緊再檢查response_format。5. 報錯對照401、404、timeout、動作空、命令被攔截分別改哪里把常見報錯按“先改 endpoint再改動作再改安全策略”的順序排查可以避免亂改配置?，F(xiàn)象優(yōu)先檢查處理方式401 UnauthorizedKey 是否有效、Header 是否完整到 TaoToken 官網(wǎng)控制臺重新創(chuàng)建 Key不要復用舊值404 Not FoundBase URL 與請求路徑Base URL 用https://taotoken.net/apicurl 用/v1/chat/completions403 或安全拒絕是否觸發(fā)敏感操作檢查命令是否涉及支付、刪除、隱私、生產庫寫入timeout長程任務上下文過大、截圖過多拆分任務、減少歷史、提高超時、批量動作分批執(zhí)行響應不是 JSONsystem prompt 約束不足明確“只輸出 JSON”加response_formataction_plan 為空runner 讀取了舊環(huán)境變量打印運行時環(huán)境確認沒有舊供應商配置覆蓋CLI 動作不執(zhí)行dry run 開啟或安全策略攔截先看[cli] dry_run和[security]日志再決定是否放開批量動作部分失敗工作目錄、權限、路徑不存在檢查AGENT_CLI_WORKDIR讓命令使用絕對路徑或受控變量其中 401 和 404 最值得先說。401 通常不是模型問題而是 Key 或鑒權頭問題。404 通常不是模型沒有能力而是 endpoint 拼接錯誤。TaoToken 官網(wǎng)https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentqwen_ui_agent_error_map里可以重新進入控制臺核對 Key 和模型信息。記住API 請求不要帶utm_source、utm_content這類參數(shù)Base URL 保持干凈。另外長程任務里經(jīng)常出現(xiàn)“GUI 正常、CLI 超時”。這往往是因為 CLI 動作輸出被完整塞回上下文導致下一輪推理過長?？梢韵拗?stdout 行數(shù)、把大文件寫入工作目錄、只把摘要和文件路徑返回給模型。批量動作也不要無限擴張一次返回過多命令會增加誤執(zhí)行風險。對于數(shù)據(jù)庫類命令建議在本地只讀副本執(zhí)行SQL 由讀者手動運行不要讓 Agent 直連生產庫。6. Claude Code、Codex、CC Switch 分別怎么填不要串環(huán)境變量很多讀者會在同一臺機器上同時用 Claude Code、Codex 和 CC Switch結果把 Claude Code 的ANTHROPIC_*環(huán)境變量復制到 Codex 配置里導致 Codex 讀不到 Key。這里要明確分開。Claude Code 使用settings.json和ANTHROPIC_*變量。示例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: YOUR_MODEL_ID } }如果你的 Claude Code 版本還讀取ANTHROPIC_API_KEY可以單獨映射但不要同時寫入多個互相沖突的值。Claude Code 的配置只服務 Claude Code不要把這一組變量直接塞給 Codex。Codex 使用config.toml不要用ANTHROPIC_*。示例model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat然后在 shell 中導出export TAOTOKEN_API_KEYYOUR_API_KEYCodex 讀取的是TAOTOKEN_API_KEY不是ANTHROPIC_AUTH_TOKEN。如果你把ANTHROPIC_*寫進 Codex 的 provider配置看起來有值實際鑒權仍然失敗。CC Switch 可以理解為多套配置的切換器。它維護的核心三件套是供應商標識例如taotokenBase URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEYCC Switch 負責切換配置不負責 Qwen-UI-Agent 的動作路由也不負責 CLI 安全策略。切換完成后仍然要回到 Qwen-UI-Agent 的.env里確認OPENAI_BASE_URL或TAOTOKEN_BASE_URL沒有被舊配置覆蓋。一個實用做法是啟動前打印非敏感變量env | grep -E OPENAI_BASE_URL|TAOTOKEN_BASE_URL|ANTHROPIC_BASE_URL | sort只打印地址不要打印 Key。確認 Qwen-UI-Agent 讀到的 Base URL 是https://taotoken.net/api。7. 把 Base URL 固化到 Qwen-UI-Agent 啟動鏈路本地命令與日志檢查前面把 Key、Base URL、curl、CLI 動作日志和不同工具配置都拆開了。最后一節(jié)把流程固化成可重復的啟動檢查。TaoToken 官網(wǎng)https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentqwen_ui_agent_checklist可以作為控制臺入口但每次啟動前建議按下面順序執(zhí)行。第一進入項目根目錄加載.envset -a source .env set a第二做一次無副作用連通性檢查。把YOUR_API_KEY和YOUR_MODEL_ID替換后執(zhí)行curl -sS https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d { model: YOUR_MODEL_ID, messages: [ {role: user, content: 只回復 ok} ], max_tokens: 8 }如果這一步失敗不要繼續(xù)啟動 Qwen-UI-Agent。先修 Key、Base URL 或模型 ID。第三以 dry run 方式啟動 Qwen-UI-Agent。下面命令中的入口名稱請?zhí)鎿Q成你本地倉庫實際使用的入口# your_entrypoint 換成你的 Qwen-UI-Agent 啟動入口 your_entrypoint --config ./configs/runtime.yaml --dry-run-cli 21 | tee logs/agent_runtime.log第四另開終端檢查日志grep -E inference\.(base_url|endpoint)|action\[[0-9]\]\.typecli|cli\.dry_run|security logs/agent_runtime.log期望看到[agent] inference.base_urlhttps://taotoken.net/api [agent] inference.endpointhttps://taotoken.net/api/v1/chat/completions [agent] action[0].typecli [agent] action[0].batchtrue [cli] dry_runtrue如果你看到的是api.openai.com、舊供應商域名或空 endpoint說明環(huán)境變量被覆蓋。檢查順序是shell 當前環(huán)境、項目.env、runner 配置文件、CC Switch 當前配置。不要一次改五個地方一次只改一層改完重新跑 grep。第五確認 CLI 動作安全邊界。開啟真實執(zhí)行前先問三個問題命令是否只讀是否影響生產數(shù)據(jù)是否需要人工確認支付、刪除、隱私授權、數(shù)據(jù)庫寫入這類動作必須停在確認環(huán)節(jié)。Qwen-UI-Agent 的價值是 GUI 與 CLI 協(xié)同但協(xié)同的前提是可控。把 Base URL 固定到https://taotoken.net/api把 Key 放進YOUR_API_KEY占位環(huán)境把 CLI 動作先跑 dry run然后再逐步放開權限。8. 按順序完成 TaoToken 鏈路再跑 Qwen-UI-Agent如果你已經(jīng)跟著把.env、curl 和 CLI 動作日志對齊最后只需要按推薦路徑完成 TaoToken 鏈路先用模型對話驗證模型 ID 和 endpoint 是否可用https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentqwen_ui_agent_model_chat需要穩(wěn)定跑 CLI 動作、長程任務或批量動作時查看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentqwen_ui_agent_coding_plan創(chuàng)建并管理 API Key確認 Key 不泄露、不進 Githttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentqwen_ui_agent_api_keys如果你同時使用 Claude Code按官方文檔配置settings.json與ANTHROPIC_*https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentqwen_ui_agent_claude_code_doc回到本文的主線Qwen-UI-Agent 的 CLI 動作 endpoint 不在 prompt 里也不在 shell adapter 的第一行而在模型推理客戶端的 Base URL。把 Base URL 寫成https://taotoken.net/apiKey 用YOUR_API_KEY先用 curl 驗證/v1/chat/completions再用 CLI 動作日志對照inference.base_url、inference.endpoint、action_plan和dry_run。這條鏈路對齊后GUICLI 混合動作空間才真正可復現(xiàn)、可排障、可安全擴展。