Keural Duo
Tác nhân thường trú trên máy tính của bạn: cài đặt, trò chuyện, tác vụ định kỳ, Telegram, sử dụng máy tính và Mate & Morph.
Duo là một tác nhân luôn chạy được ứng dụng máy tính cài trên máy này (hoặc trên DGX Spark đã kết nối). Duo hoạt động trong một sandbox biệt lập, bạn trò chuyện với Duo qua mục Duo ở thanh bên hoặc qua Telegram, và Duo chạy các tác vụ định kỳ đã đăng ký. Duo dựa trên NVIDIA NemoClaw và OpenClaw.
Duo chỉ có trên ứng dụng máy tính.
Cài đặt
Trong Cài đặt → Duo → Môi trường chạy, chọn một mô hình rồi nhấn Cài đặt ở dòng nơi bạn muốn chạy. Nếu chưa chọn mô hình hoặc thiếu dung lượng đĩa, nút Cài đặt sẽ bị vô hiệu hóa.
Nơi chạy và yêu cầu
| Nơi chạy | Yêu cầu |
|---|---|
| Thiết bị này (macOS) | Mac chip Apple, RAM từ 16 GB trở lên. Môi trường container do ứng dụng tự cài đặt, nên không cần Docker Desktop, Homebrew hay mật khẩu quản trị viên. |
| Thiết bị này (Windows) | WSL 2. Lần đầu, nhấn Chuẩn bị Windows để cài các thành phần cần thiết. Có thể được yêu cầu khởi động lại PC hoặc cho phép quyền quản trị viên. Nếu ảo hóa đang tắt, hãy bật trong BIOS. |
| Thiết bị từ xa (DGX Spark) | Kết nối Spark và chạy trước một mô hình trên đó. Nếu tường lửa của Spark đang bật, nhập một lần mật khẩu tài khoản Spark để mở hai cổng (mật khẩu không được lưu). |
Cần ít nhất 20 GB dung lượng đĩa, khuyến nghị 40 GB trở lên. Nếu không đủ, nút Cài đặt bị khóa và hiển thị "Cần {need} GB · còn trống {free} GB".
Mô hình
| Lựa chọn | Mô tả |
|---|---|
| Mô hình của thiết bị này | Dùng mô hình đang chạy trong số mô hình cục bộ đã tải. Hiển thị là "{name} · cùng mô hình với chat". |
| DGX Spark | Mô hình đang chạy trên Spark đã kết nối. |
| Đám mây | Mô hình Duo có trong gói của bạn. Cần đăng nhập để hiển thị. |
| Gateway | Dùng mô hình từ máy chủ đã kết nối trong Cài đặt → Mô hình → Gateway. Cần địa chỉ và API key của máy chủ đó. |
Sau khi cài, đổi mô hình ở dòng Mô hình. Trong cùng một loại, việc đổi diễn ra ngay với "Đổi". Khi đổi loại giữa cục bộ, đám mây và gateway, bạn cần cài lại. Cài lại vẫn giữ nguyên tác vụ định kỳ. Để chuyển Duo sang nơi chạy khác, hãy xóa trước rồi cài ở nơi mới.
Các bước cài đặt
Các bước chạy theo thứ tự: kiểm tra thiết bị này → chuẩn bị môi trường container → cài NemoClaw → khởi động mô hình (với đám mây và gateway là chuẩn bị quyền truy cập mô hình) → tạo sandbox → thiết lập Duo → kiểm tra hoạt động. Bước hiện tại hiển thị trên nút và thẻ tiến trình. Nếu lâu, hiển thị "Việc này lâu hơn bình thường nhưng vẫn đang chạy. Hãy giữ ứng dụng mở." Không đóng ứng dụng.
Nếu cài đặt dừng lại, hãy xác định nguyên nhân theo thông báo trên màn hình trong mục Khi không cài đặt được.
Duo của tài khoản hoặc không gian làm việc khác
Mỗi thiết bị chỉ có một Duo, và Duo thuộc về tài khoản và không gian làm việc đã cài đặt nó. Nếu đăng nhập bằng tài khoản khác hoặc chuyển sang không gian làm việc khác, Duo trong Cài đặt hiển thị "Chưa cài đặt", còn Duo ở thanh bên và Mate & Morph bị ẩn. Ở trạng thái này, nhấn Cài đặt sẽ hiện hộp xác nhận cho biết Duo đó cùng các cuộc trò chuyện và tác vụ định kỳ của nó sẽ bị xóa. Nhấn Cài đặt mới để xóa Duo hiện có và tạo Duo mới. Khi bạn quay lại tài khoản hoặc không gian làm việc ban đầu, Duo đó sẽ hiện lại.
Nếu còn Duo đã cài đặt trước đó, ứng dụng sẽ dọn dẹp mà không hỏi, rồi tiếp tục cài đặt. Nếu dọn dẹp thất bại, quá trình dừng với thông báo "Không xóa được Duo trước đó. Hãy cài lại."
Khi không cài đặt được
Nếu cài đặt dừng lại, Cài đặt → Duo sẽ hiển thị thông báo lỗi. Kiểm tra cả mã trong ngoặc đơn ở cuối thông báo (nếu có). Sau khi xử lý nguyên nhân, nhấn Cài đặt lần nữa.
| Thông báo trên màn hình | Nguyên nhân | Cách xử lý |
|---|---|---|
Đã dừng cài đặt: không đủ dung lượng ổ đĩa. Hãy bảo đảm còn trống ít nhất {need} GB rồi thử lại | Ổ đĩa chứa thư mục cá nhân còn trống dưới 20 GB. | Giải phóng ít nhất 20 GB (khuyến nghị 40 GB). |
| Không thể chuẩn bị môi trường chạy container. Hãy kiểm tra kết nối và thử lại | Không tải được các tệp cài đặt. Tường lửa hoặc proxy của công ty thường là nguyên nhân. | Kiểm tra kết nối internet. Nếu dùng mạng công ty, hãy nhờ bộ phận IT cho phép các địa chỉ trong mục Nơi tải về. |
| Không xóa được Duo trước đó. Hãy cài lại. | Không dọn được Duo cũ còn sót lại trên thiết bị này. | Thoát hẳn ứng dụng, mở lại và nhấn Cài đặt. Nếu vẫn lỗi, xem thông báo tương tự trên tab macOS. |
| Có Duo của tài khoản hoặc không gian làm việc khác. | Duo trên thiết bị này thuộc về tài khoản hoặc không gian làm việc khác. | Nhấn Cài mới để xóa Duo đó và cài đặt. Để tiếp tục dùng Duo đó, hãy đăng nhập vào tài khoản hoặc không gian làm việc ban đầu. |
| Gói của bạn không bao gồm mô hình đám mây cho Duo. | Gói của không gian làm việc hiện tại không bao gồm Duo đám mây. | Đổi mô hình sang Mô hình của thiết bị này, DGX Spark hoặc gateway, hoặc kiểm tra gói của bạn. |
| Đăng nhập để dùng mô hình đám mây. | Bạn đã đăng xuất. | Đăng nhập rồi cài đặt lại. |
| Mô hình của Duo chưa chạy. Hãy khởi động rồi áp dụng lại. | Mô hình trên thiết bị này chưa chạy. | Chạy mô hình trong Cài đặt → Mô hình, rồi cài đặt. |
| Việc này lâu hơn bình thường nhưng vẫn đang chạy. Hãy giữ ứng dụng mở. | Lần cài đặt đầu tiên phải tải nhiều dữ liệu nên mất thời gian. | Giữ ứng dụng mở và chờ. Trên laptop, hãy ngăn máy chuyển sang chế độ ngủ. |
Nếu vẫn không giải quyết được, liên hệ hỗ trợ trong Cài đặt → Hỗ trợ. Ghi kèm thông báo trên màn hình, mã trong ngoặc đơn và loại thiết bị (macOS, Windows hoặc Spark).
Màn hình Cài đặt → Duo
| Mục | Nội dung |
|---|---|
| Trạng thái | "Đang chạy trên {nơi}" · Đã dừng · Đang khởi động · Chưa cài đặt · Không có máy chủ (khi thiếu kết nối Spark) |
| Môi trường chạy | Chọn mô hình; Cài đặt, Khởi động, Dừng và Xóa ở các dòng Thiết bị này / Thiết bị từ xa; ID sandbox và phiên bản NemoClaw |
| Ứng dụng chat | Kết nối Telegram |
| Kết nối | GitHub, tìm kiếm web |
| Sử dụng máy tính | Quyền, thư mục được đọc, quy tắc trước khi hành động, ứng dụng luôn được phép, Mate & Morph |
| Bộ nhớ hội thoại | Mức sử dụng ngữ cảnh, nén hội thoại, hội thoại mới |
| Tính năng mới (Windows) | Kết nối máy Windows, thư mục chia sẻ, kiểm tra quyền truy cập ứng dụng, tác vụ gần đây |
Khi đang chạy thao tác dài (cài đặt, đổi mô hình, áp dụng thay đổi ở ứng dụng chat hoặc xóa), các mục khác bị khóa. Hộp xác nhận của hệ điều hành chỉ xuất hiện khi bật sử dụng máy tính hoặc mở rộng quy tắc của nó.
Trò chuyện
Nhấn Duo ở thanh bên. (Không hiển thị ở chế độ Code.) Tin nhắn gửi khi kết nối bị gián đoạn sẽ hiển thị "{n} đang chờ gửi" và được chuyển khi kết nối trở lại. Gửi /new sẽ hỏi bạn có muốn bắt đầu hội thoại mới không.
Khi bật Thông tin Duo ở phía trên, bảng bên hiển thị các thẻ sau.
| Thẻ | Nội dung |
|---|---|
| Hiện tại | Tác vụ đang làm hoặc đang chờ, thời gian đã trôi qua và các công cụ đã dùng |
| Cài đặt Duo đã thay đổi | Chỉ hiển thị khi cài đặt sandbox khác với lần Keural xác nhận gần nhất. Hiển thị các mục đã thay đổi (ứng dụng chat và ai được trò chuyện với Duo · công cụ và quyền · dịch vụ đã kết nối · kết nối mô hình · khác). Nếu bạn là người thay đổi, nhấn Chấp nhận thay đổi. |
| Sandbox | Sẵn sàng hoặc lỗi, mô hình phản hồi bình thường hoặc không phản hồi, có dùng GPU (CUDA) hay không, dung lượng |
| Mô hình | Tên mô hình, vị trí (Thiết bị này · DGX Spark · Đám mây), mức sử dụng ngữ cảnh |
| Tác vụ định kỳ | Xem Tác vụ định kỳ bên dưới |
| Kết nối · Telegram | Tóm tắt kết nối. Nhấn để chuyển thẳng tới phần Cài đặt. |
| Tệp làm việc | Các tệp Duo đã tạo trong thư mục làm việc của sandbox |
Nhấn Tác vụ nền để xem danh sách subagent mà Duo đang chạy.
Bộ nhớ hội thoại
Trong Cài đặt → Duo → Bộ nhớ hội thoại, bạn xem "Ngữ cảnh đang dùng" theo số token và tỷ lệ phần trăm. Dùng Nén để rút gọn hội thoại, hoặc Bắt đầu mới để mở hội thoại mới. Hội thoại hiện tại được lưu lại. Nếu Duo đang làm việc, hãy thực hiện sau khi công việc kết thúc. Khi hiển thị "Hội thoại quá dài đối với mô hình nên Duo không trả lời được. Vui lòng thử lại sau ít phút.", hãy nén hội thoại hoặc bắt đầu hội thoại mới.
Tác vụ định kỳ
Nói với Duo điều gì đó như "Mỗi sáng 9 giờ, hãy …", ứng dụng sẽ hiển thị thẻ Tạo tác vụ định kỳ này? (Công việc · Lịch · Nơi chạy). Nhấn Tạo tác vụ để đăng ký. Khi sửa hoặc xóa, bạn cũng xác nhận bằng thẻ tương tự.
| Mục | Chi tiết |
|---|---|
| Lịch | Một lần (tối đa 365 ngày sau) · hằng ngày · ngày trong tuần · hằng tuần · mỗi N phút (từ 5 đến 1.440 phút) |
| Nơi nhận | Cuộc trò chuyện Duo trong ứng dụng Keural, hoặc Gửi qua Telegram |
| Giới hạn | 10 tác vụ đang bật, tổng 50 tác vụ |
| Hết hạn | Mặc định 7 ngày, tối đa 30 ngày. Sau đó hiển thị "Đã hết hạn" |
| Bỏ lỡ | Nếu ứng dụng đã đóng và tác vụ trễ hơn 10 phút so với giờ dự kiến, tác vụ không chạy và ghi nhận là "Bỏ lỡ" |
| Lỗi | Sau 3 lần lỗi liên tiếp, hiển thị "Tạm dừng do lỗi" |
Trên thẻ Tác vụ định kỳ của bảng thông tin Duo, bạn bật và tắt tác vụ. Ở Xem thêm, chọn Chạy ngay hoặc Xóa. Mỗi dòng hiển thị lần chạy tiếp theo và trạng thái (Đã gửi · Bỏ lỡ · Lỗi · Tạm dừng · Hết hạn). Kết quả tác vụ được gửi vào cuộc trò chuyện Duo hoặc Telegram, đồng thời hiển thị thông báo trên máy tính (Chạy ngay không có thông báo). Tác vụ định kỳ chỉ chạy khi ứng dụng đang mở.
Ứng dụng chat (Telegram)
Làm theo các bước trong Cài đặt → Duo → Ứng dụng chat → Telegram → Kết nối.
- Trong Telegram, mở @BotFather, gửi
/newbot, rồi đặt tên và tên người dùng cho bot. - Dán token bot mà BotFather đã cấp và nhấn Xác minh. Giữ kín token, vì token bị lộ thì ai cũng điều khiển được bot.
- Quét mã QR bằng điện thoại để mở bot, rồi nhấn Bắt đầu. Nếu không có phản hồi, gửi cho bot mã hiển thị trên màn hình.
- Khi thấy "Chỉ
{name}có thể nhắn tin riêng với Duo.", nhấn Thêm, rồi nhấn Áp dụng.
Khi áp dụng, Duo khởi động lại (hội thoại và tệp được giữ nguyên). Sau đó, tin nhắn gửi từ điện thoại sẽ hiển thị trong hội thoại Duo với nhãn "Gửi từ Telegram". Chỉ một người đã kết nối mới có thể trò chuyện riêng với Duo. Để ngắt kết nối, nhấn Ngắt kết nối rồi Áp dụng. Khi đã kết nối Telegram, phê duyệt tác vụ định kỳ cũng được gửi qua Telegram.
Một token bot chỉ dùng được cho một thiết bị (Duo) của một tài khoản. Để kết nối với thiết bị khác, hãy ngắt kết nối trên thiết bị hiện tại, rồi đăng ký lại token.
Phê duyệt hành động trong ứng dụng chỉ thực hiện trong cửa sổ ứng dụng Keural, kể cả với các cuộc trò chuyện bắt đầu từ Telegram.
Kết nối
Thiết lập trong Cài đặt → Duo → Kết nối.
| Dịch vụ | Cách thực hiện |
|---|---|
| GitHub | Dán Personal access token rồi xác minh, hoặc nhấn Tiếp tục với GitHub CLI để dùng đăng nhập gh của máy tính này. Nếu chưa có CLI, liên kết cài đặt sẽ hiển thị. Nếu chưa đăng nhập, cửa sổ đăng nhập sẽ mở. Khi kết nối hoặc thay đổi kết nối, Duo khởi động lại. |
| Tìm kiếm web | Duo dùng phương thức đã chọn trong Cài đặt → Chung → Tìm kiếm web (Tìm nhanh · Tìm Keural · Tavily, Brave hoặc SearXNG của dịch vụ tìm kiếm riêng). Phải bật Sử dụng máy tính. |
Sử dụng máy tính
Bật Cài đặt → Duo → Sử dụng máy tính → Cho phép Duo sử dụng máy tính này. Khi bật, Duo có thể dùng các ứng dụng trên máy này, đọc các thư mục bạn chỉ định và tạo tác vụ định kỳ. Khi bật, Duo khởi động lại trong khoảng một phút.
| Mục | Chi tiết |
|---|---|
| Quyền macOS | Trợ năng (nhấp và nhập) và Ghi màn hình (xem màn hình). Nếu chưa được cấp, nhấn Mở Cài đặt Hệ thống. |
| Thư mục Duo được đọc | Duo chỉ đọc các thư mục bạn thêm bằng Thêm thư mục. Không thể thêm thư mục quá rộng như toàn bộ thư mục người dùng hay thư mục hệ thống. |
| Trước khi Duo hành động | Luôn hỏi (mặc định) · Hành động không cần hỏi · Tự tôi làm. Khi chuyển sang Hành động không cần hỏi, bạn được xác nhận thêm một lần. |
| Ứng dụng luôn được phép | Danh sách ứng dụng bạn đã chọn Luôn cho phép trong cửa sổ phê duyệt. Nhấn × trên dòng tương ứng để gỡ. |
Ngay cả với Hành động không cần hỏi hoặc Luôn cho phép, các bước nhạy cảm như gửi, xóa, ghi đè, thanh toán, nộp, đăng nhập, đăng tải và hủy, cùng các phím như Enter, Backspace và ⌘Q, vẫn luôn hỏi trước.
Khi Duo chờ phê duyệt, dòng "Duo đang chờ phê duyệt" hiển thị phía trên ô nhập. Nhấn Xác nhận để mở cửa sổ phê duyệt. Trong cửa sổ có các lựa chọn Từ chối · Cho phép một lần · Luôn cho phép. Việc phê duyệt chỉ thực hiện được trong cửa sổ này.
Duo chỉ mở liên kết trong kết quả tìm kiếm mà không cần phê duyệt. Với địa chỉ do Duo tự nhập hoặc thay đổi, cửa sổ phê duyệt sẽ hiển thị đầy đủ địa chỉ và hỏi trước.
Mate & Morph
Mate & Morph là nhân vật trên màn hình của Duo. Bật Cài đặt → Duo → Sử dụng máy tính → Mate & Morph → Hiển thị trên màn hình nền, rồi chọn Nhân vật (Mate · Morph · Cả hai) và Kích thước (Nhỏ · Vừa · Lớn).
- Nhân vật chỉ hiển thị khi Duo đang chạy và hội thoại đã sẵn sàng. Nó bị ẩn nếu bạn chuyển sang tài khoản hoặc không gian làm việc khác, hoặc nếu gói của bạn không cho dùng Duo.
- Nhấp một lần vào nhân vật sẽ mở ô nhập để bạn nói chuyện ngay; nhấp đúp sẽ mở ứng dụng. Bên cạnh nhân vật hiển thị trạng thái (Đang chờ · Đang làm · Xong · Bị chặn · Cần bạn trả lời · Đang chờ phê duyệt) và lý do của lần trả lời gần nhất bị lỗi.
- Menu chuột phải: Ẩn · Đánh dấu đã đọc · Mở Duo · Cài đặt Duo. Menu thanh menu (khay) cũng có Hiện/Ẩn Mate & Morph.
Windows
Duo trên Windows chạy trong một bản phân phối WSL, hỗ trợ trò chuyện, tác vụ định kỳ, Telegram, phê duyệt, Mate & Morph và sử dụng máy tính giống như trên macOS. Một số ứng dụng và cửa sổ bảo mật, như ô mật khẩu, UAC và terminal, Duo không thao tác. Các phần này do bạn tự thao tác.
Trong Cài đặt → Duo → Tính năng mới (máy tính Windows), kiểm tra kết nối Duo, Thư mục chia sẻ (Duo chỉ đọc thư mục bạn chọn), Truy cập ứng dụng và Tác vụ gần đây. Trên Windows, bạn còn có thể dùng Cài đặt phần mềm (chỉ với đúng ID gói) và Kết nối Wi‑Fi (chỉ với hồ sơ đã lưu). Gửi, xóa, ghi đè, cài đặt và thay đổi mạng luôn hỏi trước.
Xóa
Trong Cài đặt → Duo → Môi trường chạy, nhấn Xóa ở dòng nơi Duo đã cài, rồi nhấn Xóa trong hộp xác nhận "Xóa Keural Duo khỏi thiết bị này?". Sandbox, lịch sử hội thoại, tác vụ định kỳ và tệp làm việc sẽ bị xóa. Trên macOS, máy ảo container riêng của Duo cũng bị xóa. Duo trên DGX Spark chỉ xóa được khi Spark đang kết nối.
Thông báo thường gặp
| Thông báo | Ý nghĩa |
|---|---|
| Duo chưa chạy | Trong Cài đặt → Duo, nhấn Khởi động. |
| Cần ứng dụng máy tính phiên bản mới nhất | Cập nhật ứng dụng. |
| Mô hình chưa chạy. Hãy khởi động mô hình rồi áp dụng lại. | Mô hình cục bộ hoặc mô hình Spark đang tắt. Khởi động mô hình trước. |
| Mất kết nối với mô hình. Kiểm tra bạn đã đăng nhập chưa. | Quyền truy cập mô hình đám mây của Duo đã mất. Đăng nhập lại. |
| Gói của không gian làm việc này không cho dùng Duo. | Gói không cho phép dùng Duo với mô hình đám mây. Chuyển sang mô hình cục bộ hoặc kiểm tra gói. |
| Có Duo của tài khoản hoặc không gian làm việc khác. | Cài đặt sẽ xóa Duo đó. Khi chuyển về tài khoản hoặc không gian làm việc ban đầu, Duo đó sẽ dùng lại được. |
| Không xóa được Duo cũ. Vui lòng cài đặt lại. | Không dọn được Duo đã cài trước đó. Nhấn Cài đặt lại. |
Chi tiết kỹ thuật cho bộ phận IT
Yêu cầu
| Nơi chạy | Tiêu chuẩn |
|---|---|
| macOS | Chip Apple (arm64), RAM từ 16 GB trở lên. Máy ảo của Duo (Colima, vz) dùng 4 CPU, 9 GiB RAM và 40 GiB đĩa (chỉ chiếm dung lượng thực tế cần dùng). |
| Windows | WSL 2 (kernel 5.15 trở lên), x64 hoặc ARM64. Cài bản phân phối Ubuntu 24.04 với tên Keural-Duo và dùng Podman rootless bên trong. Không cần Docker Desktop. |
| DGX Spark | Docker đang chạy, còn trống 20 GB đĩa và ít nhất 8 GB RAM khả dụng |
| Chung | Ít nhất 20 GB trống trên ổ đĩa chứa thư mục người dùng (khuyến nghị 40 GB) |
Trên Windows, khi cài đặt, hệ thống ghi networkingMode=nat vào mục [wsl2] của %USERPROFILE%\.wslconfig. Máy dùng mạng phản chiếu (mirrored) sẽ không cài được Duo.
Vị trí cài đặt
| Nơi chạy | Đường dẫn |
|---|---|
| Môi trường chạy macOS | ~/.keural-runtime/ (Colima, Lima, CLI Docker, nhật ký) |
| Tự khởi động macOS | ~/Library/LaunchAgents/kr.mkd.keural-duo-colima.plist, kr.mkd.keural-duo-gateway.plist, kr.mkd.keural-duo-sweeper.plist |
| CLI NemoClaw | ~/.local/bin/nemoclaw |
| Windows | Bản phân phối WSL Keural-Duo |
| Bản ghi của ứng dụng | Trong thư mục dữ liệu ứng dụng: keural-duo@<máy chủ>.json, keural-duo-routines@<máy chủ>.json, keural-duo-rules@<máy chủ>.json |
| Nhật ký | ~/.keural/logs/, ~/.keural-runtime/colima.log và gateway.log, keural-duo-install.log trong thư mục dữ liệu ứng dụng |
Nơi tải về
Cho phép các địa chỉ sau trên tường lửa hoặc proxy. Tệp tải về có phiên bản cố định và được xác minh bằng SHA-256.
| Địa chỉ | Nội dung tải về |
|---|---|
github.com | Colima v0.10.3, Lima v2.2.1, buildx v0.38.2 (macOS), công cụ Podman (Windows) |
download.docker.com | CLI Docker 29.9.3 (macOS) |
www.nvidia.com | Script cài đặt NemoClaw (v0.0.134) |
ghcr.io | Image sandbox OpenClaw |
api.telegram.org | Kết nối Telegram |
Máy chủ Keural (api.keural.ai, v.v.) | Mô hình đám mây, đăng nhập |
Nếu dùng tìm kiếm web hoặc kết nối GitHub, cũng cần cho phép api.tavily.com, api.search.brave.com, api.github.com và api.githubcopilot.com.
Mạng và cổng
| Nơi | Cổng | Công dụng |
|---|---|---|
| macOS | 127.0.0.1:8080 | Gateway OpenShell |
| macOS · Windows | 127.0.0.1:8766 | Máy chủ mô hình của thiết bị này (trên Windows là relay trong WSL). Nếu bị chiếm, dùng 8768 |
| DGX Spark | Một cổng trống trong khoảng 18080 đến 18099 | Gateway riêng cho Spark |
| DGX Spark | 18081 | Relay từ sandbox tới mô hình Spark (8000) |
| DGX Spark | 22 | Kết nối SSH của ứng dụng |
Nếu tường lửa ufw trên Spark đang bật, trong lúc cài đặt sẽ mở hai cổng (gateway và relay). Lúc này, nhập một lần mật khẩu tài khoản Spark.
Sandbox không truy cập Internet trực tiếp. Ứng dụng xử lý tìm kiếm web và đọc trang, còn GitHub được kết nối ở chế độ chỉ đọc.
Địa chỉ mô hình
| Mô hình | Địa chỉ sandbox gọi tới |
|---|---|
| Mô hình của thiết bị này | http://localhost:<cổng>/v1. Mô hình mặc định qwen3-8-27b, ngữ cảnh 262.144 |
| Mô hình DGX Spark | Qua relay của Spark tới 127.0.0.1:8000/v1 trên Spark |
| Mô hình đám mây | /core/v1/bot/v1 của máy chủ Keural. Dùng token cấp riêng cho mỗi Duo. |
| Gateway | Địa chỉ máy chủ đã kết nối trong Cài đặt → Mô hình → Gateway |
Địa chỉ gateway có thể là bất kỳ nếu dùng https. Nếu dùng http, chỉ chấp nhận IP nội bộ hoặc tên nội bộ (.local, .lan, .internal, .intranet, .home.arpa, và tên không có dấu chấm). Không chấp nhận localhost và địa chỉ có user:pass@.
Telegram
- Token bot lấy bằng
/newbottrong BotFather. Định dạng làsố:chữ và số. - Khi mã kết nối được tạo, trong 10 phút hãy mở bot trên điện thoại, và trong 5 phút hãy gửi tin nhắn đầu tiên. Tài khoản gửi tin nhắn đầu tiên sẽ được cho phép.
- Duo không trả lời trong hội thoại nhóm.
Tác vụ định kỳ
| Mục | Giá trị |
|---|---|
| Kiểm tra | Tìm tác vụ cần chạy mỗi 30 giây. |
| Bỏ lỡ | Nếu trễ hơn 10 phút so với giờ dự kiến, tác vụ không chạy và được ghi là bỏ lỡ. |
| Tạm dừng | Dừng sau 3 lần lỗi liên tiếp. |
| Khoảng lặp lại | 5 đến 1.440 phút |
| Chạy một lần | Tối đa 365 ngày sau |
| Hết hạn | Mặc định 7 ngày, tối đa 30 ngày |
| Giới hạn | 10 tác vụ đang bật, tổng 50 tác vụ |
| Múi giờ | Múi giờ của máy tính đã tạo tác vụ |
Quy tắc thêm thư mục
Các thư mục sau không thể thêm.
| Loại | Thư mục |
|---|---|
| Chung | Thư mục gốc của ổ đĩa, chính thư mục người dùng và các thư mục cha của nó |
| Bên trong thư mục người dùng | .ssh, .aws, .gnupg, .kube, .docker, .config, Library, .Trash, AppData |
| macOS | /System, /Library, /usr, /bin, /sbin, /etc, /var, /private, /dev, /Volumes, /Applications, /opt, /cores |
| Windows | Windows, Program Files, Program Files (x86), ProgramData |
Quyền sử dụng máy tính
| Hệ điều hành | Quyền cần có |
|---|---|
| macOS | Trong Cài đặt Hệ thống → Quyền riêng tư & Bảo mật: Trợ năng và Ghi màn hình |
| Windows | Không cần quyền bổ sung; dùng Windows UI Automation. |
Các nút như gửi, xóa, thanh toán, mua, nộp, đăng nhập, chuyển tiền, đăng tải và hủy, cùng các phím như Enter, Delete, đóng cửa sổ hoặc thoát ứng dụng, được coi là bước nhạy cảm và luôn yêu cầu xác nhận.
Những gì bị xóa khi gỡ
Khi nhấn Xóa, sandbox, lịch sử hội thoại Duo, tác vụ định kỳ, kết nối Telegram, GitHub và tìm kiếm, cùng token mô hình đám mây sẽ bị xóa. Nếu trên thiết bị này không còn Duo nào khác, macOS cũng xóa ~/.keural-runtime/ và các mục tự khởi động. Cài đặt Mate & Morph và bản ghi kết nối Spark được giữ lại.