Đồng nghiệp AI chạy trên máy tính cá nhân của bạn
Giao một mục tiêu, WorkBot lập kế hoạch, dùng công cụ, theo dõi tiến độ và đưa việc đến bước cần bạn quyết định.
--- ## WorkBot là gì WorkBot là ứng dụng AI local-first dành cho một người dùng trên một máy tính cá nhân. Đây không phải chatbot chỉ chờ từng câu lệnh, cũng không phải nền tảng SaaS để quản lý tenant. Bạn giao mục tiêu; WorkBot có thể: - chia công việc thành các bước; - tìm trong tài liệu và bộ nhớ trên máy; - chuẩn bị nội dung, quy trình, ticket và bản nháp; - dùng trình duyệt hoặc công cụ khi được phép; - dừng tại Stop Gate khi thiếu dữ liệu hoặc cần chủ máy duyệt; - chạy lịch và Hands sau khi bạn chủ động bật. WorkBot không cung cấp WorkBot Cloud, không tạo workspace được host, không provision VPS và không có control plane multi-tenant. ## Mô hình phát hành **WorkBot Core là phần mềm miễn phí và công khai cho cộng đồng.** Người dùng có thể cài một bản single-user trên máy cá nhân, dùng Mama Agent, Local API, WebAuth, bộ nhớ, Stop Gate và các skill cộng đồng mà không cần mua gói nền tảng. WorkBot không bán quyền truy cập cloud hay thu phí theo tenant. Sản phẩm thương mại về sau là các **gói Agent Skills chuyên ngành**: quy trình, tri thức, công cụ và cấu hình Agent đã được đóng gói cho từng nhu cầu SME. Các gói này là phần mở rộng tùy chọn, không tạo paywall trong onboarding và không khóa WorkBot Core. Agent Pack được phát hành bằng file `.wskill` ký số và entitlement offline, cài ngay trên máy khách. Xem [hướng dẫn Agent Skill Packs](docs/AGENT_SKILL_PACKS.md). ## Nguyên tắc sản phẩm | Nguyên tắc | Cách WorkBot thực hiện | |---|---| | Một chủ máy | Một bản cài, một workspace, một người sở hữu quyền duyệt | | Local-first | Bộ nhớ, tệp cấu hình và dữ liệu nghiệp vụ nằm trên máy | | Tự chọn cách dùng AI | Chạy model local, dùng WebAuth bằng gói AI đã mua hoặc dùng API key do chủ máy cấu hình | | Có thể chạy on-device | Hỗ trợ endpoint AI local tương thích OpenAI, mặc định hướng tới Ollama trên localhost | | Không tự hành khi chưa đồng ý | Hands và lịch mẫu được cài ở trạng thái tắt | | Hành động nhạy cảm có chốt | Gửi, đăng, thanh toán, xóa và thao tác quan trọng phải qua bước duyệt | > “Không WorkBot Cloud” không có nghĩa là cấm người dùng chọn model AI qua Internet. WebAuth hoặc API AI bên ngoài là lựa chọn của chủ máy; WorkBot không đứng giữa để host hoặc chuyển tiếp dữ liệu. ## Lần khởi động đầu tiên Luồng welcome đưa người dùng từ lúc cài đến một việc thật, không bắt đầu bằng terminal hay tệp cấu hình: 1. **Chào mừng** — WorkBot Core là Free/Public, chạy local-first và không tạo WorkBot Cloud. 2. **Kiểm tra máy** — phân biệt runtime bắt buộc với Local AI, WebAuth và công cụ tùy chọn. 3. **Kết nối AI** — chọn model local, đăng nhập WebAuth bằng gói AI đã mua hoặc dùng API key cá nhân. 4. **Chọn kênh** — ghi nhớ kênh muốn kết nối; token và phiên đăng nhập được xác minh ở màn Kênh. 5. **Mama & Skills** — chọn gói khởi đầu cho bán hàng, chăm sóc khách, nội dung hoặc vận hành; không có paywall. 6. **Hoàn tất** — xác nhận AI, kênh, skill lõi, Stop Gate và lời giao việc đầu tiên. Nếu AI chưa sẵn sàng, WorkBot vẫn cho hoàn tất onboarding rồi mở thẳng phần **Nhà cung cấp/Cài đặt**. Nếu đã chọn kênh, WorkBot mở màn **Kênh** để người dùng tự xác thực. Không có automation nào chạy ngầm trong lúc onboarding. ## Bề mặt chính - **Mama Chat** — giao mục tiêu và nhận kết quả. - **Vận hành** — ticket, workflow, Stop Gate và các việc chờ duyệt. - **Tri thức** — tài liệu và bộ nhớ khách hàng trên máy. - **Content Ops** — kế hoạch, bản nháp và phê duyệt nội dung. - **Trình duyệt** — chuẩn bị hành động web có kiểm soát. - **Kênh** — các kênh do chủ máy tự kết nối. - **Cài đặt** — model local, WebAuth hoặc provider API cá nhân. ## Chạy thử Yêu cầu phát triển: - Rust 1.85 trở lên - Node.js 20 trở lên - npm Chạy bản gateway local: ```bash cargo build --release --bin workbot ./target/release/workbot serve --open ``` Gateway mặc định chỉ bind vào `127.0.0.1`. Không có tùy chọn WorkBot Cloud hoặc Cloudflare Tunnel trong bản single. Build giao diện desktop: ```bash cd desktop/src-ui npm ci npm run build cd ../.. cargo build --release -p workbot-desktop ``` ## Cấu trúc sản phẩm ```text WorkBot Desktop ├── Welcome onboarding ├── Mama + đội agent chuyên môn ├── Local memory + knowledge + business data ├── Provider do chủ máy cấu hình ├── Browser / tools / channels └── Approval gate + automation opt-in ``` Không còn trong sản phẩm: - `workbot-platform` - máy chủ quản trị multi-tenant - provision tenant/VPS/Proxmox - Cloud Panel - gói phát hành `workbot-platform` ## Bảo mật - Mặc định chạy loopback-only. - Hands tích hợp mặc định ở trạng thái `Disabled`. - Hành động rủi ro cao đi qua approval gate. - Không ghi API key vào README, log hoặc mã nguồn. - Chỉ kết nối dịch vụ ngoài khi người dùng tự cấu hình. ## Giấy phép WorkBot Core phát hành theo giấy phép MIT. Các file có nguồn gốc bên thứ ba giữ giấy phép và thông báo riêng trong [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). Website: [workbot.vn](https://workbot.vn)