Keural Duo

Duo 是桌面應用程式在這台電腦（或已連接的 DGX Spark）上安裝的常駐代理程式。它在隔離的沙箱中運作，可從側邊欄的 Duo 或 Telegram 與它對話，並執行你設定的例行工作。以 NVIDIA NemoClaw 與 OpenClaw 為基礎。

安裝複製錨點連結

在 設定 → Duo → 執行環境 中選擇模型，然後按下要執行位置那一列的 安裝。未選擇模型或磁碟空間不足時，安裝按鈕會停用。

執行位置與需求複製錨點連結

安裝需要 20GB 以上磁碟空間，建議 40GB 以上。空間不足時，安裝按鈕會鎖定，並顯示「需要 {need} GB · 剩餘 {free} GB」。

模型複製錨點連結

安裝之後，仍可在 模型 列更換模型。同一類型之間選擇「切換」即可立即更換。在本機、雲端、閘道之間更換類型時，需要重新安裝。重新安裝不會刪除例行工作。若要變更執行位置，請先刪除，再安裝到其他位置。

安裝步驟複製錨點連結

安裝依序進行：確認這台裝置 → 準備容器執行環境 → 安裝 NemoClaw → 啟動模型（雲端或閘道則準備模型使用權限）→ 建立沙箱 → 設定 Duo → 確認運作。目前步驟會顯示在按鈕文字與進度卡片中。出現「耗時稍長，請保持應用程式開啟。」時，請勿關閉應用程式。

安裝停止時，請在安裝失敗時根據畫面提示查找原因。

其他帳號或工作區的 Duo複製錨點連結

Duo 每台裝置只有一個，並屬於安裝時所用的帳號與工作區。若你以其他帳號登入或切換到其他工作區，設定中的 Duo 會顯示為「未安裝」，側邊欄的 Duo 與 Mate & Morph 也會隱藏。在此狀態下按下 安裝，會出現確認視窗，表示既有的 Duo 及其對話與例行工作將被刪除。按下 重新安裝 後，既有的 Duo 會被刪除並重新建立。回到原本的帳號或工作區時，既有的 Duo 會再次顯示。

若先前安裝的 Duo 仍存在，會先自動清理再進行安裝。清理失敗時，會停在「無法刪除先前的 Duo。請重新安裝。」

安裝失敗時複製錨點連結

安裝停止時，設定 → Duo 會顯示錯誤訊息。請一併確認訊息後括號中的代碼。解決原因後，再次點選安裝。

仍無法解決時，請在設定 → 支援中聯絡支援。請一併提供畫面提示、括號中的代碼與裝置類型（macOS、Windows 或 Spark）。

設定 → Duo 畫面複製錨點連結

安裝、切換模型、套用聊天應用程式設定、刪除等較長的工作進行期間，其他區域會被鎖定。只有在開啟電腦使用或放寬規則時，才會出現作業系統的確認視窗。

對話複製錨點連結

按下側邊欄的 Duo（程式碼模式下不會顯示）。連線中斷期間傳送的訊息會顯示為「{n} 則等待傳送」，連線恢復後會送達。在輸入框中傳送 /new，會詢問是否開始新對話。

開啟上方的 Duo 資訊 後，側邊面板會顯示以下卡片。

按下 背景工作 按鈕，可查看 Duo 執行中的子代理程式清單。

對話記憶複製錨點連結

在 設定 → Duo → 對話記憶 中，可以用權杖數與百分比確認「目前使用的內容」。按下 壓縮 可縮減對話，按下 新建 可開啟新對話。現有對話會保留。若 Duo 正在工作，需等工作結束後再操作。若顯示「對話過長，模型無法處理，因此 Duo 無法回答。」，請壓縮或開始新對話。

例行工作複製錨點連結

你可以對 Duo 說「每天早上 9 點……」之類的話，此時會顯示 要建立此例行工作嗎？ 卡片（工作、排程、執行位置）。按下 建立例行工作 即可登錄。修改或刪除時，也會以同一張卡片確認。

在 Duo 資訊面板的 例行工作 卡片中可以開啟或關閉。按下 更多 可執行 立即執行 或 刪除。每一列會顯示下次執行時間與狀態（已傳送 · 已錯過 · 失敗 · 已暫停 · 已到期）。例行工作的結果會傳送到 Duo 對話或 Telegram，並顯示桌面通知（立即執行 不會發出通知）。例行工作只會在應用程式開啟時執行。

聊天應用程式（Telegram）複製錨點連結

在 設定 → Duo → 聊天應用程式 → Telegram → 連線 中依照指示操作。

1. 在 Telegram 中開啟 @BotFather，傳送 /newbot，然後設定機器人的名稱與使用者名稱。
2. 貼上 BotFather 提供的 機器人權杖，然後按下 確認。權杖若外洩，任何人都能控制這個機器人，因此請勿公開。
3. 以手機掃描 QR code 開啟機器人，然後按下 開始。若沒有回應，請將畫面上的代碼傳送給機器人。
4. 出現「只有 {名稱} 可以用私訊與機器人對話」時，請依序按下 新增、套用。

套用後 Duo 會重新啟動（對話與檔案保持不變）。之後從手機傳送的訊息會在 Duo 對話中以「來自 Telegram」顯示。只有連線的那一位可以用私訊與機器人對話。若要解除，請按下 中斷連線，然後按下 套用。連接 Telegram 後，例行工作的核准也會透過 Telegram 接收。

一組機器人權杖只能在一個帳號的一台裝置（Duo）上使用。要連接其他裝置，請先在原裝置解除連接，再重新登錄權杖。

應用程式操作的核准，即使對話是從 Telegram 開始的，也只能在 Keural 應用程式視窗中進行。

連線複製錨點連結

請在 設定 → Duo → 連線 中設定。

電腦使用複製錨點連結

在 設定 → Duo → 電腦使用 → 允許 Duo 使用這台電腦 開啟後，Duo 可以操作這台電腦上的應用程式、讀取你指定的資料夾，並建立例行工作。開啟時 Duo 會重新啟動約一分鐘。

即使是 不詢問直接執行 或 一律允許，傳送、刪除、覆寫、付款、提交、登入、發布、取消等敏感步驟，以及 Enter、Backspace、⌘Q 等按鍵，仍會先詢問。

Duo 等待核准時，輸入框上方會顯示「Duo 正在等待核准」。按下 確認 開啟核准視窗，並從 拒絕 · 僅允許一次 · 一律允許 中選擇。核准只能在此視窗中進行。

Duo 只會不經核准開啟搜尋結果中的連結。Duo 自行輸入或變更的位址，核准視窗會顯示完整位址並詢問。

Mate & Morph複製錨點連結

這是 Duo 的桌面角色。在 設定 → Duo → 電腦使用 → Mate & Morph → 在桌面上顯示 開啟後，它會出現在畫面上。接著選擇 角色（Mate · Morph · 兩者）與 大小（小 · 中 · 大）。

• 只有在 Duo 執行中且對話已準備好時才會顯示。切換到其他帳號或工作區，或方案不允許使用 Duo 時，會隱藏。
• 按一下角色會開啟輸入框，可以直接與它對話；快速按兩下則會開啟應用程式。角色旁會顯示狀態（待命中 · 工作中 · 已完成 · 受阻 · 需要輸入 · 正在等待核准），以及最後一次回答失敗的原因。
• 右鍵選單：隱藏 · 標示為已讀 · 開啟 Duo · Duo 設定。選單列（系統匣）選單中也有 顯示／隱藏 Mate & Morph。

Windows複製錨點連結

Windows 版的 Duo 在 WSL 發行版中執行，對話、例行工作、Telegram、核准、Mate & Morph 與電腦使用的支援方式與 macOS 相同。應用程式操作使用 Windows UI 自動化，因此部分應用程式，以及密碼輸入欄、UAC、終端機等安全視窗，Duo 不會操作，而是交由你自行處理。

在 設定 → Duo → 新功能（Windows 電腦）中，可以確認 Duo 連線、共用資料夾（Duo 只會讀取你選擇的資料夾）、應用程式存取，以及 最近工作。在 Windows 上，除了應用程式操作，還可以進行 軟體安裝（僅限正確的套件 ID）與 Wi‑Fi 連線（已儲存的設定檔）。傳送、刪除、覆寫、安裝與網路變更，都會先詢問。

刪除複製錨點連結

在 設定 → Duo → 執行環境 中，按下已安裝位置那一列的 刪除，然後在確認視窗中按下 刪除。沙箱、對話紀錄、例行工作與工作檔案都會被刪除。在 macOS 上，Duo 專用的容器 VM 也會被刪除。DGX Spark 上的 Duo 需在 Spark 連線時才能刪除。

常見提示複製錨點連結

IT 管理人員詳細資訊複製錨點連結

需求複製錨點連結

在 Windows 上，安裝時會在 %USERPROFILE%\.wslconfig 的 [wsl2] 中使用 networkingMode=nat。使用鏡像網路（mirrored）的電腦無法安裝。

安裝位置複製錨點連結

下載來源複製錨點連結

請在防火牆或 Proxy 中允許以下位址。下載的檔案為固定版本，並以 SHA-256 驗證。

若使用網路搜尋或 GitHub 連線，也需允許 api.tavily.com、api.search.brave.com、api.github.com、api.githubcopilot.com。

網路與連接埠複製錨點連結

若 Spark 上開啟了 ufw 防火牆，安裝過程中會開啟閘道與中繼兩個連接埠。此時需要輸入一次 Spark 帳號密碼。

沙箱不會直接連到網際網路。網路搜尋與網頁讀取由應用程式處理，GitHub 以唯讀方式連線。

模型位址複製錨點連結

閘道位址若使用 https，任何位址都可以；若使用 http，則只接受私人 IP 或內部名稱（.local、.lan、.internal、.intranet、.home.arpa，或不含點的名稱）。包含 localhost 或 user:pass@ 的位址不接受。

Telegram複製錨點連結

• 機器人權杖透過 BotFather 的 /newbot 取得，格式為 數字:英數字。
• 連線代碼產生後，請在 10 分鐘內以手機開啟機器人，並在 5 分鐘內傳送第一則訊息。傳送第一則訊息的帳號會被允許。
• 群組對話不會回覆。

例行工作限制複製錨點連結

新增資料夾的規則複製錨點連結

以下資料夾無法新增。

電腦使用權限複製錨點連結

傳送、刪除、付款、購買、提交、登入、轉帳、發布、取消等按鈕，以及 Enter、Delete、關閉視窗、結束應用程式等按鍵，都會視為敏感步驟，每次確認。

解除安裝時會刪除的內容複製錨點連結

按下 刪除 會刪除沙箱、Duo 對話紀錄、例行工作、Telegram、GitHub 與搜尋連線，以及雲端模型權杖。若這台裝置上沒有其他 Duo，macOS 還會刪除 ~/.keural-runtime/ 與自動啟動項目。Mate & Morph 設定與 Spark 連線紀錄會保留。