Mọi thứ bạn cần để giữ máy tính luôn trong tầm tay.

Màn hình chính có một ô cho mỗi trợ lý Gateway báo về, trợ lý bạn dùng gần nhất đứng đầu. Quá ba thì phần còn lại nằm trong Thêm trợ lý. Khi có hơn một trợ lý sẵn sàng, Phiên mới sẽ hỏi bạn chọn cái nào.

Khi một phiên — kể cả phiên của trợ lý con — cần bạn điền biểu mẫu, mọi điện thoại đã ghép nối nhận một thông báo rằng trợ lý đang chờ bạn. Yêu cầu cấp quyền vẫn được thông báo như trước.

Gateway thấy trợ lý nhưng chưa có thông tin xác thực cho nó. Ô sẽ mở hướng dẫn với đúng lệnh cần chạy trên máy chủ — với T3 Code là t3 pair.

Trợ lý dùng giao thức mới hơn những gì Gateway này biết. Cập nhật Gateway trên máy đó bằng cách chạy lại lệnh cài đặt.

Trợ lý không có trên máy chủ, hoặc chưa chạy. Ô cho biết trường hợp nào và mở hướng dẫn khởi động viết riêng cho trợ lý đó.

Gateway trước 0.13 không có multi_agent, nên ứng dụng ở chế độ một trợ lý với OpenCode và báo cho bạn khi một tính năng cần Gateway mới hơn.

Ứng dụng tự động hỏi Gateway về các tính năng được hỗ trợ thay vì phán đoán qua số phiên bản, và ẩn đi các tính năng chưa có thay vì báo lỗi. Do đó, Gateway phiên bản cũ vẫn là một terminal hoàn hảo: bạn chỉ không thấy các bề mặt giao diện mới hơn chứ không mất kết nối. Tính năng cộng tác agent là tính năng duy nhất có yêu cầu backend riêng — yêu cầu kết nối Herdr 0.9.0 trở lên trong phiên đó, và phiên tmux không hỗ trợ tính năng này. Khi thiếu tính năng, ứng dụng sẽ thông báo rõ cần nâng cấp thành phần nào thay vì âm thầm ẩn tùy chọn.

Chạy lại lệnh cài đặt tương tự. Trình cài đặt sẽ ghi đè tệp nhị phân tại chỗ, giữ nguyên danh tính máy chủ, địa chỉ và cấu hình của bạn, đồng thời các điện thoại đã ghép nối vẫn giữ nguyên kết nối. Nếu bạn đã cài đặt dịch vụ, hãy chạy lại service install một lần nữa sau đó: tệp unit chứa các quy tắc về vòng đời tiến trình con, và việc làm mới này giúp việc khởi động lại Gateway không làm ngắt các phiên terminal của bạn.

Lỗi "Could not reach the gateway" nghĩa là địa chỉ trong mã QR không phản hồi từ vị trí mạng của điện thoại. Kiểm tra lệnh muqun-gateway status trên máy tính, sau đó kiểm tra xem điện thoại có thể truy cập địa chỉ đó không — chung mạng Wi-Fi hoặc tốt nhất là chung tailnet Tailscale. Gateway chỉ lắng nghe loopback sẽ không thể truy cập từ thiết bị khác; hãy xuất bản địa chỉ thật bằng phím u trong trình quản lý, hoặc ghép nối thông qua máy chủ SSH đã lưu.

Mã xác nhận gồm 8 ký tự, có hiệu lực trong 5 phút và bị vô hiệu hóa sau 8 lần nhập sai. Nhấn phím p trong trình quản lý để tạo mã QR và mã mới. Bảng ký tự không sử dụng 0, 1, I, L hoặc O, nên ký tự trông giống chúng sẽ là một ký tự khác.

Chấm tròn đặc có nghĩa ứng dụng đã thăm dò và nhận được phản hồi: ONLINE (Trực tuyến) hoặc OFFLINE (Ngoại tuyến khi không có phản hồi). Vòng tròn rỗng hiển thị NOT CONNECTED có nghĩa là ứng dụng chưa thăm dò — đây không phải lỗi, và việc chạm mở máy chủ sẽ kích hoạt kết nối.

Token của thiết bị này trên Gateway đã không còn — bị thu hồi từ trình quản lý hoặc bị mất khi thư mục trạng thái Gateway được tạo lại. Tiến hành ghép nối lại máy chủ; các thiết lập khác trên điện thoại không bị ảnh hưởng.

Màn hình agent hiển thị "OpenCode service offline" và yêu cầu bạn chạy opencode serve --service trên máy chủ. Hãy chạy lệnh đó rồi nhấn Kiểm tra lại (Check again). Nếu dịch vụ đã chạy mà vẫn không tìm thấy, nguyên nhân thường do Gateway tìm sai tệp nhị phân: hãy thiết lập opencode.binary trong config.json với đường dẫn đầy đủ và khởi động lại Gateway.

Trạng thái "Set up on the host" nghĩa là nhà cung cấp đó chưa được cấu hình trong OpenCode — hãy cấu hình trên máy tính và mở lại bộ chọn. Thông báo "No free models on this host" chỉ ra rằng bộ lọc Chỉ miễn phí không tìm thấy kết quả phù hợp chứ không phải lỗi; hãy tắt bộ lọc để xem toàn bộ mô hình được hỗ trợ. Muqun hiển thị chi phí ước tính theo phiên nhưng không thu bất kỳ khoản phí nào và không can thiệp giữa bạn và nhà cung cấp.

Yêu cầu Đọc ngoài dự án và Ghi ngoài dự án đúng như tên gọi của chúng và đường dẫn tệp được hiển thị rõ trên thẻ. Cho phép (Allow) áp dụng một lần, Luôn cho phép (Always allow) ghi nhớ lựa chọn, Từ chối (Deny) sẽ ngăn chặn thao tác. Hộp thoại này thực hiện đúng vai trò bảo vệ — hãy đọc kỹ đường dẫn trước khi đưa ra quyết định.

Nút chỉ xuất hiện khi terminal nằm trong một kho git và Gateway đủ mới để cung cấp diff. So sánh với gốc và Hủy thay đổi cần Gateway 0.13 trở lên. Nâng cấp bằng cách chạy lại lệnh cài đặt.

Ứng dụng thăm dò khả năng hỗ trợ của Gateway thay vì đoán, nên Gateway cũ chỉ thiếu tính năng mới mà vẫn duy trì chức năng terminal. Việc phân công công việc cho trợ lý khác ngoài ra còn yêu cầu Herdr 0.9.0 trở lên trong phiên làm việc đó, và ứng dụng sẽ nêu rõ thành phần nào cần cập nhật.

Máy tính của bạn là nơi trực tiếp giao tiếp với nhà cung cấp mô hình, do đó nếu máy tính cần proxy để truy cập internet thì OpenCode cần được cấu hình proxy trên chính máy tính đó. Muqun không làm trung gian và không nhìn thấy lưu lượng truy cập đó.

Gateway đang chạy nhưng không có backend terminal nào — đã cài tmux mà không có máy chủ tmux, hoặc Herdr chưa khởi động. Màn hình liệt kê các backend của Gateway và trạng thái; khởi động một cái và terminal tự xuất hiện. Trong lúc đó phiên trợ lý vẫn hoạt động.

Gateway đã từ chối một tổ hợp. Với tmux, chạy tmux set -s extended-keys on, và với Ctrl+Enter thì chạy thêm tmux set -s extended-keys-format csi-u. Gợi ý bên dưới thông báo nhắc lại lời giải thích của chính Gateway.

Chạy muqun-gateway agent trên máy chủ: nó nêu bước tiếp theo cho từng trợ lý. Cần cập nhật nghĩa là Gateway này cũ hơn giao thức của trợ lý — chạy lại lệnh cài đặt.