Câu hỏi thường gặp
Phiên bản sản phẩm
Kimi WebBridge và Tiện ích mở rộng trình duyệt Kimi có mối quan hệ gì?
Kimi WebBridge đã được đổi tên thành Tiện ích mở rộng trình duyệt Kimi, đồng thời bổ sung các tính năng mới như lối vào thanh bên của trình duyệt, ghi lại thao tác web và tách trang web thành chỉ dẫn. Cách Local Agent gọi tiện ích mở rộng vẫn giữ nguyên và có thể tiếp tục sử dụng; lối vào thanh bên mới cần đăng nhập bằng tài khoản Kimi để sử dụng.
Sử dụng thanh bên
Lịch sử cuộc trò chuyện có đồng bộ với kimi.com và ứng dụng máy tính Kimi không?
Không. Lịch sử cuộc trò chuyện trên thanh bên chỉ được lưu trong trình duyệt hiện tại, và mỗi tài khoản mặc định giữ 10 cuộc trò chuyện gần nhất. Để lưu lâu dài, nhấp “Export” bên dưới câu trả lời để lưu nội dung thành tệp Markdown (.md).
Cài đặt và cấu hình
Những trình duyệt nào được hỗ trợ?
Hiện hỗ trợ Chrome và Edge. Chúng tôi khuyên bạn dùng phiên bản mới nhất để có trải nghiệm tốt nhất.
Khi cài đặt tiện ích mở rộng, bạn thấy thông báo “Không thể thêm ứng dụng từ trang web này”?
Hãy đảm bảo cài đặt từ kho ứng dụng chính thức (Chrome Web Store hoặc Edge Add-ons). Nếu không truy cập được kho ứng dụng, hãy dùng phương thức cài đặt thủ công có trên trang web chính thức.
Trên Windows, khi cài đặt Tiện ích mở rộng trình duyệt Kimi gặp lỗi: Cài đặt thất bại
Tiện ích mở rộng trình duyệt Kimi hỗ trợ hệ điều hành Windows, và lệnh cài đặt có thể chạy trong PowerShell:
Sau khi cài đặt, Tiện ích mở rộng trình duyệt Kimi hiển thị cảnh báo về tính tương thích với Chrome. Điều đó nghĩa là gì?
Nếu Tiện ích mở rộng trình duyệt Kimi mở được trang bình thường, nhưng các thao tác như snapshot, evaluate, screenshot hay click liên tục thất bại, thì nguyên nhân phổ biến hơn cả là xung đột với các tiện ích mở rộng khác của trình duyệt.
Điều này đặc biệt hay xảy ra với các công cụ thu thập dữ liệu, tiện ích hỗ trợ trang web, tiện ích quay màn hình và tiện ích trợ lý AI.
Chúng tôi khuyên bạn làm theo các bước sau để khắc phục:
- Mở trang quản lý tiện ích mở rộng của trình duyệt
- Tạm thời tắt các tiện ích mở rộng khác
- Chỉ giữ lại Tiện ích mở rộng trình duyệt Kimi ở trạng thái bật
- Khởi động lại trình duyệt và thử lại
- Nếu Tiện ích mở rộng trình duyệt Kimi hoạt động bình thường, hãy bật lại từng tiện ích còn lại để tìm ra tiện ích đang gây xung đột
Chạy lệnh kết nối nhưng không có gì xảy ra?
Vui lòng kiểm tra kết nối mạng của bạn. Nếu vẫn không khắc phục được, hãy thử khởi động lại Kimi Claw Desktop rồi chạy lại lệnh.
Tôi có thể dùng trên nhiều máy tính không?
Có, nhưng mỗi máy tính cần được cài đặt và cấu hình riêng.
Tôi không tìm thấy Kimi Claw Desktop?
Kimi Claw Desktop là một Kimi Claw được triển khai ngay trên máy tính của bạn. Hãy mở Kimi Desktop, tìm Kimi Claw ở thanh bên trái, tạo một Claw mới và chọn “Triển khai trên máy tính của tôi”.
Kết nối và sử dụng
Kiểm tra kết nối thế nào? Làm gì khi Agent cục bộ không dùng được trình duyệt?
- Trong thanh bên trình duyệt, mở “Settings” → “Local agent remote control” và xem “Connection”: nếu hiển thị “Not connected”, nhấp “Connect” để thử lại.
- Trong Kimi Work, bạn cũng có thể xem trạng thái “Kết nối dịch vụ” tại “Cài đặt” → “Điều khiển tự động” → “Browser use”, rồi nhấp “Kết nối” để thử lại.
Lưu ý: Mở được thanh bên không có nghĩa là đã cấu hình xong kết nối của Agent cục bộ.
Nếu Kimi Work hoặc Agent cục bộ khác không dùng được trình duyệt, trước tiên hãy xem lỗi gốc do công cụ trả về. Các trường hoặc đoạn phổ biến tương ứng với hướng kiểm tra khác nhau:
| Trường hoặc đoạn trong lỗi gốc | Ý nghĩa và hướng kiểm tra |
|---|---|
error.code là extension_not_connected | Dịch vụ cục bộ đã nhận yêu cầu nhưng tiện ích trình duyệt chưa kết nối. Ưu tiên kiểm tra trình duyệt và tiện ích ở bước 1, cùng địa chỉ kết nối ở bước 4 |
Connection refused hoặc Failed to connect khi truy cập dịch vụ cục bộ | Lệnh gọi chưa đến được dịch vụ. Kiểm tra cài đặt và khởi động ở bước 2, 3, rồi địa chỉ ở bước 4 |
Khi khởi động xuất hiện daemon did not come up và Port … is most likely held by another program | Dịch vụ không khởi động được, có thể do cổng bị chiếm. Kiểm tra bước 5 và nhật ký đi kèm |
Lần lượt kiểm tra như sau:
1. Trình duyệt đã mở và tiện ích đã bật chưa?
Mở Chrome hoặc Edge đã cài Tiện ích mở rộng trình duyệt Kimi và kiểm tra tiện ích được bật trong trang quản lý tiện ích. Sau đó quay lại Kimi Work và nhấp “Kết nối”, hoặc nhấp “Connect” trong cài đặt tiện ích.
2. Bạn mới cài tiện ích mà chưa cấu hình Agent cục bộ?
Cần cài cả tiện ích trình duyệt lẫn thành phần kết nối cho Agent cục bộ. Trong Kimi Work, cài plugin Kimi Browser Extension từ kho plugin và làm theo hướng dẫn cài đặt, kết nối.
Nếu dùng Agent cục bộ khác hoặc chưa cấu hình dịch vụ, nhấp “Connect” trong tiện ích rồi gửi hướng dẫn cài đặt trong hộp thoại cho Agent. Bạn cũng có thể sao chép yêu cầu tương ứng với hệ điều hành dưới đây:
macOS hoặc Linux
Windows
Xác nhận cài đặt và khởi động dịch vụ đều thành công rồi kiểm tra lại “Connection”.
3. Dịch vụ đã cài có đang chạy không?
Cài xong không có nghĩa là dịch vụ luôn chạy. Trong Kimi Work, trước tiên nhấp “Kết nối” ở trang cài đặt nêu trên. Với Agent cục bộ khác, hãy nhờ kiểm tra dịch vụ cục bộ của Tiện ích mở rộng trình duyệt Kimi và khởi động nếu cần. Sau đó nhấp “Connect” trong tiện ích. Nếu khởi động thất bại, kiểm tra xung đột cổng.
4. Địa chỉ của tiện ích có khớp với dịch vụ cục bộ không?
Kiểm tra “Settings” → “Local agent remote control” → “Connection address”. Mặc định là ws://127.0.0.1:10086/ws. Nếu đổi cổng dịch vụ, tiện ích phải dùng cùng cổng. Chỉ đổi một phía sẽ khiến kết nối thất bại.
5. Lỗi có nhắc đến khả năng cổng bị chiếm không?
Nếu thấy Port … is most likely held by another program, hãy nhờ Agent cục bộ kiểm tra cổng thực tế, chương trình đang dùng cổng và nhật ký đi kèm. Thông báo chỉ nêu khả năng, chưa xác nhận nguyên nhân. Khi xác nhận có xung đột, làm theo hướng dẫn về cổng bên dưới.
Nếu vẫn không kết nối được, vào “Settings” → “Feedback” trong tiện ích và gửi phiên bản Kimi Work hoặc Agent cục bộ, phiên bản trình duyệt và tiện ích, ảnh trạng thái kết nối, toàn bộ lỗi và các bước đã thử.
Cổng bị chiếm thì làm gì? Đổi cổng kết nối thế nào?
Dịch vụ kết nối cục bộ mặc định dùng cổng 10086. Trước tiên xác định chương trình đang chiếm cổng. Nếu có thể đóng, hãy đóng rồi thử kết nối lại. Nếu cần giữ chương trình chạy, đổi cổng theo các bước dưới đây.
Kimi Work 3.2.18 và các Agent cục bộ khác có thể dùng chung quy trình đổi cổng. Nếu dùng Work phiên bản cũ, hãy cập nhật lên 3.2.18 hoặc mới hơn trước. Dịch vụ cục bộ của Tiện ích mở rộng trình duyệt Kimi phải là v2.0.22 hoặc mới hơn.
Bạn có thể đổi cổng của cả dịch vụ và tiện ích. Ví dụ dưới đây dùng 12086; trước tiên nhờ Agent xác nhận cổng còn trống. Chờ tác vụ trình duyệt đang chạy kết thúc vì khởi động lại dịch vụ sẽ ngắt kết nối hiện tại.
1. Sửa cấu hình dịch vụ cục bộ.
Mở tệp sau hoặc tạo nếu chưa có. Giữ nguyên các trường khác và chỉ sửa addr. Nếu có lỗi cấu hình, kiểm tra cú pháp JSON và xem addr có đúng định dạng địa chỉ bên dưới không, sửa rồi thử lại:
- macOS / Linux:
~/.kimi-webbridge/config.json - Windows:
%USERPROFILE%\.kimi-webbridge\config.json
2. Khởi động lại dịch vụ và kiểm tra trạng thái.
Chạy lệnh phù hợp với hệ điều hành hoặc nhờ Agent cục bộ chạy:
Xác nhận kết quả có running: true và port là 12086. Nếu vẫn là cổng cũ hoặc không khởi động được, xử lý lỗi dịch vụ trước. Work dùng lại dịch vụ đang chạy bình thường; lưu cấu hình hoặc mở lại Work không tự chuyển dịch vụ đó sang cổng mới.
3. Đổi địa chỉ kết nối của tiện ích.
Trong thanh bên, mở “Settings” → “Local agent remote control” → “Connection address”, nhập ws://127.0.0.1:12086/ws rồi nhấp “Test”. Khi thành công, nhấp “Save”. Quay lại cài đặt và xác nhận “Connection” hiển thị “Connected”.
4. Yêu cầu Agent cục bộ dùng địa chỉ mới.
Trong Kimi Work, mở lại Work sau các bước trên rồi nhấp “Kết nối” tại “Cài đặt” → “Điều khiển tự động” → “Browser use”. Với Agent cục bộ khác, cho biết dịch vụ đã đổi sang 127.0.0.1:12086 và tiếp tục dùng cổng thực tế do status trả về. extension_connected: true nghĩa là tiện ích đã kết nối. Nếu là false, kiểm tra trình duyệt đang mở, tiện ích đã bật và địa chỉ trùng với bước 3.
Để khôi phục mặc định, đổi addr về 127.0.0.1:10086, khởi động lại dịch vụ rồi nhấp “Reset to default” trong trang “Connection address”. Trước đó cần xác nhận không có chương trình khác dùng 10086.
Tiện ích mở rộng trình duyệt Kimi có làm lộ thông tin đăng nhập của tôi không?
Không. Mọi thao tác đều diễn ra cục bộ trên thiết bị của bạn—trạng thái đăng nhập và nội dung trang web không bao giờ rời khỏi máy. Agent chỉ có thể truy cập những kết quả thao tác mà bạn cho phép.
Vì sao các thao tác lại thất bại?
Cấu trúc trang phức tạp hoặc nội dung tải động có thể khiến thao tác thất bại. Hãy thử đơn giản hóa hướng dẫn của bạn, hoặc yêu cầu Agent chụp ảnh màn hình trước để xác nhận trạng thái trang trước khi thực hiện.
Phối hợp với các agent khác
Những Agent nào khác được hỗ trợ?
Tiện ích mở rộng trình duyệt Kimi hỗ trợ mọi Local Agent, bao gồm Claude Code, Codex, Cursor, Kimi Code, Hermes Claw cùng nhiều công cụ khác.
Cách cấu hình có giống nhau giữa các Agent không?
Lệnh thiết lập đều giống nhau—chỉ cần chạy một lệnh curl duy nhất để cài đặt. Hãy tham khảo cấu hình Skill của từng Agent để biết chi tiết.
Bài viết này có hữu ích không?