Paperclip là gì?
Paperclip là một nền tảng orchestration (điều phối) mã nguồn mở được thiết kế đặc biệt cho mô hình “zero-human company” – tức là các công ty vận hành hoàn toàn bởi AI mà không cần sự can thiệp của con người. Dự án được xây dựng bằng Node.js server kết hợp React UI, cho phép bạn quản lý một đội ngũ các AI agent cùng hướng tới một mục tiêu kinh doanh chung.
Triết lý cốt lõi của Paperclip được tóm gọn trong một câu:
“Nếu OpenClaw là một nhân viên, thì Paperclip là công ty.”
Nói cách khác, Paperclip không phải là một agent AI đơn lẻ. Nó là hệ thống quản lý doanh nghiệp, nơi các AI agent đóng vai trò như những nhân viên với chức danh, cấp trên, mục tiêu và ngân sách riêng biệt. Bạn mang agent của mình đến, giao mục tiêu, và theo dõi tiến độ cũng như chi phí tất cả từ một bảng điều khiển duy nhất.
Dữ liệu thống kê đáng chú ý từ repository:
| Chỉ số | Giá trị |
|---|---|
| ⭐ Stars | 49,200+ |
| 🍴 Forks | 8,000+ |
| 👥 Contributors | 67 |
| 📝 Commits | 2,003 |
| 🏷️ License | MIT |
| 💻 Ngôn ngữ chính | TypeScript (96.8%) |
| 📦 Latest Release | v2026.403.0 |
Quy trình hoạt động 3 bước đơn giản
Paperclip thiết kế một quy trình vận hành cực kỳ trực quan, mô phỏng cách một công ty thật hoạt động:
| Bước | Hành động | Ví dụ thực tế |
|---|---|---|
| 01 | Xác định mục tiêu | “Xây dựng ứng dụng ghi chú AI số 1, đạt $1M MRR.” |
| 02 | Tuyển đội ngũ | CEO, CTO, kỹ sư, designer, marketer — bất kỳ bot nào, bất kỳ provider nào. |
| 03 | Phê duyệt và vận hành | Review chiến lược. Thiết lập ngân sách. Bấm Go. Theo dõi từ dashboard. |
Các tính năng chính (Features)
🔌 Bring Your Own Agent (Mang agent của bạn đến)
Đây là một trong những điểm mạnh nhất của Paperclip. Bạn không bị_lock-in vào bất kỳ agent hay provider cụ thể nào. Bất kỳ AI agent nào, chạy trên bất kỳ runtime nào — miễn nó có thể nhận “heartbeat” (tín hiệu nhịp tim), nó đều có thể được “tuyển dụng” vào sơ đồ tổ chức của Paperclip.
Điều này có nghĩa bạn có thể kết hợp:
| Agent/Đối tác | Mô tả |
|---|---|
| OpenClaw | Agent nhân viên dạng claw-style |
| Claude Code | Agent lập trình từ Anthropic |
| Codex | Agent code từ OpenAI |
| Cursor | IDE hỗ trợ AI |
| Bash | Script shell truyền thống |
| HTTP | Kết nối qua API endpoint |
“If it can receive a heartbeat, it’s hired.”
🎯 Goal Alignment (Căn chỉnh mục tiêu)
Mỗi task (nhiệm vụ) trong Paperclip đều có thể truy ngược về mục tiêu cốt lõi của công ty. Agent không chỉ biết cần làm gì (what) mà còn hiểu tại sao phải làm (why). Điều này đặc biệt quan trọng khi bạn có nhiều agent hoạt động song song — tất cả đều cần hướng về cùng một mục tiêu chung.
Context (ngữ cảnh) tự động chảy từ task lên project và lên company goals, đảm bảo agent luôn có full picture về nhiệm vụ của mình.
💓 Heartbeats (Nhịp tim – Lịch trình đánh thức agent)
Heartbeat là cơ chế lên lịch trình tự động cho các agent. Thay vì chạy liên tục 24/7 và tiêu tốn tài nguyên, agent sẽ:
- Được đánh thức theo lịch trình (ví dụ: mỗi 30 phút, mỗi giờ, mỗi ngày)
- Kiểm tra công việc cần làm
- Thực hiện hành động phù hợp
- Báo cáo kết quả lên hệ thống
Uỷ quyền (delegation) cũng chảy theo sơ đồ tổ chức — từ trên xuống (manager giao việc cho nhân viên) và từ dưới lên (nhân viên báo cáo cho manager).
Ngoài heartbeat theo lịch trình, Paperclip còn hỗ trợ event-based triggers (kích hoạt theo sự kiện) như:
- Khi task được gán cho agent
- Khi agent được @-mention trong cuộc hội thoại
💰 Cost Control (Kiểm soát chi phí)
Đây là tính năng giải quyết một trong những nỗi đau lớn nhất khi chạy nhiều AI agent: chi phí token chạy khỏi tầm kiểm soát.
Paperclip cung cấp:
- Ngân sách hàng tháng cho từng agent (monthly budget per agent)
- Khi agent hết ngân sách, nó tự động dừng lại
- Không có vòng lặp vô hạn (runaway loops) gây lãng phí hàng trăm đô token
- Bảng theo dõi chi phí (cost tracking) hiển thị budget token consumption
- Quản lý có thể ưu tiên phân bổ ngân sách cho các agent quan trọng hơn
🏢 Multi-Company (Nhiều công ty trên một nền tảng)
Một điểm rất mạnh: một lần triển khai (deployment), chạy nhiều công ty. Mỗi công ty có:
- Cách ly dữ liệu hoàn toàn (complete data isolation)
- Audit trail riêng
- Agent và cấu hình riêng
Điều này lý tưởng cho các portfolio entrepreneur (nhà khởi nghiệp quản lý nhiều dự án), cho phép bạn có một control plane duy nhất quản lý toàn bộ danh sách các autonomous business.
🎫 Ticket System (Hệ thống ticket)
Không chỉ là task manager đơn thuần, hệ thống ticket của Paperclip cung cấp:
- Truy vết mọi cuộc hội thoại giữa các agent
- Giải thích mọi quyết định được đưa ra
- Full tool-call tracing — ghi lại mọi lệnh công cụ agent thực thi
- Immutable audit log — nhật ký kiểm toán không thể thay đổi
Điều này đặc biệt quan trọng cho governance và compliance.
🛡️ Governance (Quản trị)
Bạn đóng vai trò là Hội đồng quản trị (Board of Directors). Bạn có quyền:
- Phê duyệt tuyển dụng agent mới
- Ghi đè chiến lược (override strategy)
- Tạm dừng (pause) bất kỳ agent nào
- Chấm dứt (terminate) agent bất kỳ lúc nào
- Các cổng phê duyệt (approval gates) được enforce nghiêm ngặt
- Thay đổi cấu hình được version hóa (revisioned config changes)
- Rollback an toàn khi có thay đổi xấu
📊 Org Chart (Sơ đồ tổ chức)
Paperclip mô hình hoá công ty với đầy đủ:
- Cấp bậc (Hierarchies)
- Vai trò (Roles)
- Đường báo cáo (Reporting lines)
- Mỗi agent có sếp, chức danh, và mô tả công việc
Điều này cho phép ủy quyền và giám sát tự nhiên theo cấu trúc tổ chức thực tế.
📱 Mobile Ready (Sẵn sàng trên mobile)
Giao diện Paperclip được thiết kế responsive, cho phép:
- Theo dõi tiến độ các autonomous business từ bất kỳ đâu
- Quản lý agent qua điện thoại
- Review và approve từ mobile
Paperclip giải quyết những vấn đề gì?
Bảng so sánh dưới đây cho thấy rõ sự khác biệt giữa việc không có và có Paperclip:
| Không có Paperclip ❌ | Có Paperclip ✅ |
|---|---|
| 20 tab Claude Code mở đồng thời, không biết tab nào đang làm gì. Reboot là mất hết. | Task dạng ticket, hội thoại theo thread, session tồn tại qua reboot. |
| Phải tự thu thập context từ nhiều nơi để nhắc bot đang làm gì. | Context tự động chảy từ task → project → company goals. Agent luôn biết phải làm gì và tại sao. |
| Thư mục agent configs hỗn loạn, tự phát minh lại task management, giao tiếp, phối hợp giữa agents. | Paperclip cung cấp org charts, ticketing, delegation, governance sẵn sàng — chạy một công ty, không phải một đống script. |
| Vòng lặp chạy tốn hàng trăm đô token, hết quota trước khi nhận ra. | Cost tracking hiển thị token budget, throttle agent khi hết. Quản lý ưu tiên với ngân sách. |
| Công việc định kỳ (CS, social, reports) phải nhớ kick-off thủ công. | Heartbeats xử lý công việc định kỳ theo lịch. Management giám sát. |
| Có ý tưởng → tìm repo → mở Claude Code → giữ tab mở → babysit. | Thêm task trong Paperclip → coding agent tự làm đến khi xong → Management review. |
Tại sao Paperclip đặc biệt?
Paperclip xử lý chính xác những chi tiết orchestration phức tạp nhất:
| Đặc điểm | Giải thích |
|---|---|
| Atomic execution | Task checkout và budget enforcement đều là atomic — không trùng lặp công việc, không расход chi phí không kiểm soát. |
| Persistent agent state | Agent tiếp tục cùng task context qua các heartbeat thay vì khởi động lại từ đầu. |
| Runtime skill injection | Agent có thể học Paperclip workflows và project context tại runtime mà không cần retrain. |
| Governance with rollback | Approval gates được enforce, config changes được revision, rollback an toàn khi cần. |
| Goal-aware execution | Tasks mang theo full goal ancestry — agent luôn thấy “tại sao”, không chỉ tiêu đề task. |
| Portable company templates | Export/import orgs, agents, skills với secret scrubbing và collision handling. |
| True multi-company isolation | Mọi entity đều scoped theo company — một deployment chạy nhiều công ty với data và audit trail riêng biệt. |
Cài đặt và Bắt đầu nhanh (Quickstart)
Paperclip hoàn toàn mã nguồn mở, self-hosted, không cần tài khoản Paperclip.
Cách nhanh nhất (1 lệnh):
npx paperclipai onboard --yes
Nếu đã có Paperclip cấu hình sẵn, chạy lại onboard sẽ giữ nguyên config. Dùng paperclipai configure để chỉnh sửa cài đặt.
Cài thủ công:
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev
Server API sẽ khởi động tại http://localhost:3100. Một cơ sở dữ liệu PostgreSQL embedded sẽ được tạo tự động — không cần thiết lập thêm.
Yêu cầu hệ thống: Node.js 20+, pnpm 9.15+
Cấu trúc thư mục dự án
Dự án được tổ chức theo monorepo với các thư mục chính:
| Thư mục | Chức năng |
|---|---|
cli/ |
Công cụ dòng lệnh (CLI tool) |
server/ |
API server (Node.js backend) |
ui/ |
Giao diện người dùng (React UI) |
packages/ |
Các package dùng chung |
skills/ |
Skill Manager cho agent |
docker/ |
Cấu hình Docker deployment |
docs/ |
Tài liệu |
tests/ |
Test suite |
evals/ |
Đánh giá (Evaluations) |
scripts/ |
Script tiện ích |
.agents/skills/ |
Agent skills configs |
.claude/skills/ |
Claude-specific skills |
Các lệnh phát triển (Development)
pnpm dev # Full dev (API + UI, watch mode)
pnpm dev:once # Full dev không watch
pnpm dev:server # Chỉ server
pnpm build # Build tất cả
pnpm typecheck # Kiểm tra kiểu TypeScript
pnpm test:run # Chạy test
pnpm db:generate # Tạo DB migration
pnpm db:migrate # Áp dụng migrations
Roadmap (Lộ trình phát triển)
✅ Đã hoàn thành:
- Plugin system (knowledge base, custom tracing, queues, v.v.)
- OpenClaw / claw-style agent employees
- companies.sh – import/export toàn bộ tổ chức
- Cấu hình AGENTS.md dễ dàng
- Skills Manager
- Scheduled Routines
- Better Budgeting
⚪ Sắp tới:
- Artifacts & Deployments
- CEO Chat
- MAXIMIZER MODE
- Multiple Human Users
- Cloud / Sandbox agents (Cursor / e2b agents)
- Cloud deployments
- Desktop App
Câu hỏi thường gặp (FAQ)
Paperclip phù hợp với ai?
- Bạn muốn xây dựng công ty AI tự chủ
- Bạn phối hợp nhiều agent khác nhau (OpenClaw, Codex, Claude, Cursor) hướng tới mục tiêu chung
- Bạn có 20 terminal Claude Code mở đồng thời và không theo dõi được ai đang làm gì
- Bạn muốn agent chạy tự chủ 24/7 nhưng vẫn audit được
- Bạn muốn theo dõi chi phí và áp dụng ngân sách
- Bạn muốn quản lý business tự chủ từ điện thoại
Paperclip khác gì OpenClaw hay Claude Code?
Paperclip sử dụng các agent đó. Nó orchestrate chúng thành một công ty — với org charts, budgets, goals, governance và accountability.
Agent có chạy liên tục không?
Mặc định, agent chạy theo heartbeat schedule và event-based triggers. Bạn cũng có thể tích hợp continuous agents như OpenClaw. Bạn đem agent của mình đến, Paperclip điều phối.
Telemetry
Paperclip thu thập anonymous usage telemetry để cải thiện sản phẩm. Không thu thập: thông tin cá nhân, nội dung issue, prompts, file paths, hay secrets. Tham chiếu private repo được hash trước khi gửi.
Telemetry mặc định bật và có thể tắt bằng:
| Phương thức | Cách |
|---|---|
| Biến môi trường | PAPERCLIP_TELEMETRY_DISABLED=1 |
| Convention chuẩn | DO_NOT_TRACK=1 |
| Môi trường CI | Tự động tắt khi CI=true |
| Config file | Đặt telemetry.enabled: false trong config |
Cộng đồng và Plugin
- Discord: Tham gia cộng đồng Paperclip
- GitHub Issues: Báo lỗi và yêu cầu tính năng
- GitHub Discussions: Ý tưởng và RFC
- awesome-paperclip: Tìm plugins và nhiều hơn nữa
Open source under MIT. Built for people who want to run companies, not babysit agents.
Source link: paperclipai/paperclip
