Chuyển tới nội dung chính
Phiên bản: v1

Câu hỏi thường gặp

Trả lời ngắn cho người vận hành. Nội bộ sâu hơn nằm ở Kiến trúc nâng cao và thuật ngữ.

Chung​

ActonOS khác CLI agent thông thường thế nào?​

ActonOS là hệ điều hành cho agent, không phải script bạn chạy trong terminal. Bạn có:

  1. Thực thi công cụ trong sandbox (agent không tùy ý sửa OS host).
  2. Vault mã hóa cho API key và token bot.
  3. Plugin cho công cụ, kênh chat, app SaaS — cài không cần reboot.
  4. Nhiệm vụ tiếp tục sau mất điện, cập nhật tự phục hồi.
  5. Hai cách cài: ảnh MiniPC, hoặc Docker.

Cài plugin thế nào? Tự viết thế nào?​

Cài: Extensions → Plugins → Upload tệp .actonpkg. Xem Plugins.

Viết: dùng Plugin SDK. Scaffold bằng acton-plugin new, rồi build, test, pack, upload. Không cần khởi động lại ActonOS.

ActonOS có thể chạy Offline 100% không cần Internet không?​

Có. Khi kết hợp với các LLM nội bộ (như Ollama, vLLM, hoặc các mô hình ONNX cục bộ), ActonOS vận hành trọn vẹn trong mạng LAN nội bộ mà không có bất kỳ dữ liệu nào gửi ra ngoài.

Phần cứng & Triển khai​

Thiết bị MiniPC nào phù hợp nhất để chạy ActonOS?​

Bất kỳ máy tính MiniPC x86_64 nào trang bị chip Intel Processor N100 (như Beelink EQ12, Minisforum UN100, GMKtec G2) kèm 8 GB – 16 GB RAM và ổ cứng 128 GB+ NVMe SSD đều mang lại sự cân bằng tối ưu giữa tiết kiệm điện năng (6W–15W) và khả năng hoạt động 24/7.

Tôi có thể cài đặt ActonOS trên Raspberry Pi không?​

Hiện tại, phiên bản ActonOS v1 tập trung tối ưu cho kiến trúc x86_64. Hỗ trợ ARM64 (bao gồm Raspberry Pi 5 và Docker trên Apple Silicon) đang được hoàn thiện.

Bảo mật & Quyền Riêng tư Dữ liệu​

Khóa API và Token OAuth được lưu trữ ở đâu?​

Toàn bộ bí mật được mã hóa bằng thuật toán AES-256-GCM trong tệp /data/config/vault.db. Khóa chủ được dẫn xuất mật mã từ UUID và CPU serial phần cứng qua Argon2id. Dữ liệu văn bản thô không bao giờ tồn tại trên đĩa cứng.

Agent hay Plugin có thể vô tình xóa tệp hệ điều hành không?​

Không. Trên Bare-Metal MiniPC, phân vùng gốc hệ điều hành được gắn kết ở chế độ Read-Only. Hơn nữa, mọi công cụ đều chạy trong namespace Bubblewrap hoặc bộ nhớ tuyến tính Wazero được kiểm tra biên nghiêm ngặt.

Tệp Workspace & gửi tài liệu sang chat​

Agent có mở được PDF tôi tải lên theo đúng tên không?​

Có. Tải report.pdf lên (hoặc nhờ agent lưu vào Workspace). Sau đó nói “Mở report.pdf” hoặc “Trích bảng trong report.pdf.” Agent dùng tên gốc. Bạn không cần sao chép mã ID bên trong.

Tệp trên trang Workspace là của bạn. Agent còn có thư mục tạm riêng cho script; những tệp đó không hiện ra cho đến khi được lưu vào Workspace. Xem Workspace.

Làm sao gửi tệp từ ActonOS sang Telegram / Discord / Zalo?​

Nhờ agent trong Chat hoặc ngay trên ứng dụng chat, ví dụ: “Gửi report.pdf trong workspace sang Telegram.” Agent tìm tệp rồi chuyển cho plugin kênh đã cài. ActonOS không tự tải lên Telegram hay Zalo. Xem Gửi tệp sang chat.

Agent báo đã gửi tệp nhưng Zalo không hiện gì​

API bot Zalo khác Telegram. Tệp được gửi bằng JSON (đường dẫn URL công khai, hoặc tệp nhỏ mã hóa trong yêu cầu), không phải multipart kiểu Telegram. HTTP 200 từ Zalo vẫn có thể nghĩa là thất bại (ok: false).

Cần làm:

  1. Cài lại plugin Zalo .actonpkg mới nhất từ Plugins.
  2. Mở Logs của plugin. Plugin hiện tại ghi rõ lỗi Zalo thay vì giả thành công.
  3. Kiểm tra bot có được phép gửi tệp trong cuộc trò chuyện Zalo đó không.

Tôi tải PDF từ Telegram về thì bị lỗi font​

Thường do plugin kênh cũ gửi tệp qua trường JSON dạng chữ, làm hỏng byte nhị phân (bảng font PDF hay bị ảnh hưởng). Cài lại plugin Telegram / Discord / Slack mới nhất, rồi gửi lại tệp từ Workspace. Plugin hiện tại gửi đúng dữ liệu nhị phân, không qua bước chuyển chữ đó.

Tôi có gửi một tệp tới mọi kênh đã kết nối cùng lúc được không?​

Không. Hãy chọn một kênh đã cài (Telegram, Discord, Zalo, …). Cố ý chặn gửi tệp tới “tất cả kênh.”