【2026 最新】Open WebUI 桌面教學：Open Terminal、cptr 怎麼選？六步上手與人工接手

你在聊天旁邊看到一個桌面，AI 的滑鼠真的動了。但它改的是你筆電的檔案、伺服器的資料，還是另一個容器？這篇 Open WebUI 桌面教學先把執行位置說清楚，再帶你安排一次「AI 操作、你接手、AI 再讀回」的小練習。

專為第一次接觸桌面 Agent 的讀者寫：前半不用程式背景；動手段落需要已安裝 Docker Compose、可管理的 Open WebUI，以及支援工具呼叫與圖片輸入的模型。以下依 2026 年 11 月 8 日查閱的官方文件整理，是可照做的操作指南；本次未啟動桌面或模型推論，不提供成功率或速度成績。

先說結論：看哪裡、做哪裡、存哪裡，分開回答

桌面 Agent＝模型看畫面＋執行環境做動作＋人核對產物。把它想成遠端協作：你在視訊室下指令，工作桌可能在另一棟樓。聊天介面在哪裡，不代表檔案就在哪裡。

Open WebUI 管對話與權限；Open Terminal 提供可操作的環境；Computer／cptr把指定機器的工作區帶進瀏覽器。第一次練習，本文選獨立 Docker 環境與假資料，並先開逐次批准。Computer gateway 的無人值守路徑不適用同一套逐次批准假設。

一、Open WebUI 桌面教學：先認清三個角色

① Open WebUI：「指揮台」。你選模型、送訊息、設定使用者與工具權限。模型像遠端同事，介面則是會議室。想先理解模型與執行層如何分工，可以讀 Agent Harness 入門。

② Open Terminal：「實際工作桌」。它提供檔案、命令與電腦操作環境。依 官方安裝文件，Docker 模式在容器裡工作；直接裝到主機則以該使用者權限執行。相同產品名稱，邊界可以相差很大。

③ Open WebUI Computer：「把既有工作站打開」。官方 選型文件把它定位為個人工作站與 Agent runtime。檔案、既有工具和執行中的服務留在 Computer 所在主機；若採 Docker 安裝，則由掛載資料夾限定可見範圍。

還有兩個容易混淆的名稱：聊天旁的 Desktop 分頁是操作畫面；Open WebUI Desktop 是另一個安裝型應用程式。Desktop 版本紀錄與 Open WebUI 網頁版本分開編號，不能把「裝了 Desktop app」直接當成已連好 Open Terminal。

二、Open Terminal 還是 cptr？先問工作原本在哪裡

想在聊天裡處理一份新上傳資料、做一份可下載產物，先選 Open WebUI＋Open Terminal；想延續某台工作站已存在的專案、終端機和登入狀態，再評估 Computer。這是工作位置的選擇，不是模型能力排行榜。

決策順序很簡單：只需要問答與知識 → 從 Open WebUI 開始；需要一張獨立工作桌 → 加 Open Terminal；必須接續既有主機狀態 → 評估 Computer。三者可以並用，不必把其中一個當成另兩個的替代品。

若要把 Computer 接回聊天，官方 gateway 教學使用 Settings → Admin → Connections 的 OpenAI-compatible 連線，Base URL 結尾為 /v1，工作區出現在模型選單的 cptr/<workspace>。這與下一節的 Open Terminal 專用整合入口不同。

這條 gateway 會以完整工具批准執行，Open WebUI 無法逐動作暫停要求確認。知識庫、工具、提示與使用者也不是自動同步到 Computer。若你的首要需求是「每一步看過才准做」，先完成下方 Open Terminal 路徑；不要只因 cptr 出現在模型選單，就套用同一種安全預期。

三、Open WebUI 桌面教學首跑：六步準備一張練習桌

① 怕碰到自己的檔案？先開新的練習環境

先用 docker compose version 確認已具備 Compose。以下是依官方 WebUI 映像名稱與 Terminal Compose 範例縮小公開連接埠的新環境配置；已有正式站的人先備份資料與資料庫，另外建練習資料夾，不要直接覆蓋原設定。0.13 涉及資料庫遷移，回退需要備份。

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    ports:
      - "127.0.0.1:3000:8080"
    volumes:
      - webui-practice:/app/backend/data
  open-terminal:
    image: ghcr.io/open-webui/open-terminal:latest
    volumes:
      - terminal-practice:/home/user
    environment:
      OPEN_TERMINAL_API_KEY: "REPLACE_WITH_YOUR_RANDOM_KEY"
volumes:
  webui-practice:
  terminal-practice:

存成 compose.yaml，把示範金鑰換成自己的高強度隨機值，再執行 docker compose up -d 與 docker compose ps。此例讓兩個服務共用 Compose 網路，Terminal 不另公開主機連接埠。這份配置沒有另外加入聊天模型服務；使用前還要設定可用的推論端點。

本機開啟 http://localhost:3000 完成管理員設定，記下兩個元件版本。WebUI 的 main 與 Terminal 的 latest 都會隨發布移動；本篇介面以 Open WebUI 0.13 為基準。使用標準完整 Terminal 映像，官方列出的 slim、alpine 是精簡環境，桌面練習不選它們。公開連接埠的原理可對照 Docker 官方說明；此例只供本機進入 WebUI，沒有替你配置遠端存取。

② 怕連錯地方？從 Admin 的 Open Terminal 專區加入

依序進入 Settings → Admin → Integrations → Open Terminal → ＋。本例 URL 填 http://open-terminal:8000，API key 填上一節的值，Auth Type 用 Bearer。同一 Compose 網路以服務名稱尋址；localhost 在容器內指向該容器自己。

不要填到名稱相近的 Personal Integrations 或 External Tools。官方連線指南建議使用管理員連線，讓金鑰保留在伺服器端。先只授權自己；儲存後檢查連線開關確實開啟。官方發布文章與連線指南對初始開關描述不同，直接核對你這一版畫面比假設預設值可靠。

③ 怕模型只會說、不會做？確認工具與圖片兩項能力

依官方 0.13 操作指南，選一個同時支援 tool calling（工具呼叫）和image input（圖片輸入）的模型，再確認工具模式為 Native。前者讓模型提出可執行動作，後者讓它讀回截圖。能回答文字問題，還不足以證明它能走完桌面迴圈。

管理員在 Settings → Admin → Interface 啟用 Tool Permissions，聊天輸入框的 ＋ 選 Ask for approval。先發一個建立假檔的工具請求，確認真的停在批准處，再開始桌面操作。這是本次工作流的驗收點，不用模型口頭承諾代替。

④ 怕看到別張桌？在新聊天選 Terminal，再開 Desktop

新開聊天，從輸入框的 Terminal 選單選這個連線，再按聊天上方 Tabs → ＋ → Desktop。選連線像選遠端辦公室；開分頁才是打開窗戶。看見桌面後，記下正在使用的 Terminal 與模型，後續檔案都在同一連線裡驗收。

⑤ 怕不知道結果對不對？先放三列假 CSV

在選定 Terminal 的 Files 分頁建立 practice 資料夾與 dates-demo.csv，內容如下。若透過文字編輯器儲存，確認檔名不是額外多了 .txt；檔案在 Terminal 內，不會自動出現在你筆電的下載資料夾。

id,date
DEMO-001,2026-11-01
DEMO-002,2026/11/02
DEMO-003,not-a-date

先把答案寫在自己的筆記：三筆資料中，連字號日期、斜線日期與非日期字串各一筆。這是在檢查字串外形，尚未定義正式匯入規則，不必讓 AI 擅自「修好」來源。

⑥ 怕它繞過桌面？把動作與交件寫明白

送出以下任務，逐次看過工具請求再批准：請在 Desktop 用檔案管理員找到 practice/dates-demo.csv，雙擊以試算表開啟。先描述三列 date 的外形，不更改 CSV。把三類各幾筆寫到同資料夾 handoff.txt，列出完整路徑，完成後停止。若先跳出 CSV 匯入視窗，你先確認逗號分隔與欄位，再批准繼續。

驗收看三份證據：Desktop 真的打開資料、工具呼叫有執行紀錄、Files 裡能開到 handoff.txt 且三個計數皆為 1。聊天說「好了」只是通知；打得開的檔案才是交件。

四、卡住怎麼接手？先停、再改、再讓它讀回

看到重複點錯時，先停止聊天的繼續生成，等目前動作穩定後再操作，避免人與 AI 搶滑鼠。你在 Desktop 完成需要手動處理的視窗，再到 Files 打開 handoff.txt，加入 human_note=已核對三列，請保留原始 CSV 並儲存。

接著發：重新讀取 practice/handoff.txt 與最新桌面截圖。先逐字回報 human_note，再檢查三類計數；不要修改原始 CSV。若找不到檔案，列出目前目錄並停止，不要另建同名替代檔。能讀回你的修改，才確認人與模型接續的是同一份狀態。

最後下載 CSV 與 handoff 到自己的電腦，打開核對；再用 docker compose restart open-terminal 重啟同一服務，查看檔案仍在。具名 volume 對應的是 /home/user；不要執行會刪 volume 的清理指令來測留存。重啟、重建與刪除儲存空間是三種不同動作，可延伸閱讀 Docker volume 文件。

五、四種常見卡點：沿著證據找，不要一直重試

點擊偏掉：先讓模型取得最新截圖，記錄像素寬高，再說明座標是該張圖的實際像素，而非自訂的 0～1000 刻度。若截圖為 W×H，座標以該尺寸檢查；縮放或切換視窗後重新截圖。不要沿用上一張圖的位置。

桌面沒有反應：先看工具呼叫是否真的發出，再查 Native 模式、模型圖片能力、Terminal 選擇與連線開關。若透過 shell 啟動的程式沒出現在 Desktop，改要求從桌面圖示或檔案管理員操作；官方 walkthrough 特別提醒 shell 程序可能沒有接到顯示環境。

檔案找不到：要求列出目前目錄、完整路徑及檔名，確認 Files 與 Desktop 選的是同一 Terminal，再查是否存到 /home/user 掛載範圍內。設定文件指出，file-browser root 是介面提示，並不限制 shell 或檔案 API；把資料夾藏起來，不等於撤回存取權。

畫面會動，卻做錯事：把任務縮成「開一個檔案、讀一列、停止」，保留截圖與工具結果。社群展示 Windows 小畫家，是作者自行改成 Windows 11 VM 的版本，並非標準 Docker 映像預設；也不能用一次展示推算你的模型成功率。練習記錄可借用 人工審查驗收的做法，把批准與正確完成分開記。

六、截圖、帳戶與成本，分成三筆帳

截圖的目的地取決於選用模型。使用本機推論路徑與雲端供應商路徑，資料出口不同；若另接搜尋、外部工具或紀錄服務，還得另外盤點。不要只看 Open WebUI 架在自己電腦，就推論整條流程都沒出網。需要查保留政策時，可接著讀 模型路由與保留設定驗收。

帳戶權限取決於執行環境。首跑只放假資料，不掛家目錄、憑證資料夾或 Docker socket，也不登入付款與主要郵件帳號。同一 Open Terminal 連線會共享檔案與程序；Computer 的 安全模型也明列登入者共享可達的檔案與 shell 邊界，使用者帳號不是彼此隔離的容器。

成本來自硬體、儲存與模型用量。桌面一輪可能包含截圖、推理、工具和再觀察，不能拿一次文字問答估完整任務。先記一個小任務用了幾輪、是否重試、檔案是否合格，再決定擴大；本文不填尚未取得的耗時與費用。

常見問題：八個先講答案的判斷

1. Open WebUI 有桌面分頁，就會操作我的筆電嗎？

不一定。Docker Open Terminal 操作容器環境；主機直接安裝則是另一個權限邊界。先查連線後端。

2. 用本機模型，截圖就一定留在本機嗎？

要看整條連線。確認推論端點確實在本機，並逐一盤點外部工具、轉送與紀錄服務。

3. cptr 是 Open Terminal 的另一個名字嗎？

不是。它是 Computer 的命令與 workspace gateway 名稱脈絡；三者角色依工作位置選擇。

4. Ask for approval 可以替 Computer gateway 擋每一步嗎？

不能。官方文件明列 gateway 為無人值守、完整工具批准路徑；需要逐步介入時先用本文的 Terminal 練習。

5. 本機小模型支援工具，就一定會點對嗎？

不一定。工具格式、圖片理解、座標和多輪恢復都要另外驗收。先做一列資料的短任務。

6. 重啟容器，檔案會留嗎？

本例在具名 volume 的 /home/user 內驗收留存；存到其他路徑或刪除 volume，要另行處理。先下載一份核對。

7. 看到 Windows 展示，可以直接照這份 Docker 範例開 Windows 嗎？

不可以這樣推論。標準完整映像提供 Linux 桌面；該社群作者的 Windows 11 是自行改版。

8. 我可以遠端用手機接回 Computer 嗎？

可以規劃遠端存取。官方文件提供 Tailscale 等路徑；這會開放一台有 shell 能力的主機，先依安全模型限定誰能登入。本文本機 Compose 不包含該配置。

給新手的三個重點

先畫位置：模型、聊天介面與執行環境各在哪裡。再做接手：停下後改一行，要求模型重新讀回。最後驗交件：完整路徑、正確內容與可下載副本，三者一起確認。