Paperclip: Điều Phối AI Agent Cho Đội Nhóm

Quản Lý AI Agent Như Một Doanh Nghiệp

Paperclip là ứng dụng mã nguồn mở mà README mô tả là thứ người ta dùng để quản lý AI agent trong công việc, với cách ví von: 'nếu OpenClaw là một nhân viên, thì Paperclip là cả công ty.' Nó chạy như một Node.js server kèm dashboard React, nơi bạn định nghĩa mục tiêu, thuê một đội nhân viên người và AI, rồi theo dõi task, chi phí và phê duyệt từ một nơi duy nhất — thay vì một thư viện bạn import vào code agent riêng.

Giải Quyết Các Vấn Đề Thường Gặp Khi Quản Lý AI Agent

Chạy nhiều hơn vài AI coding agent là bạn gặp ngay cùng một vấn đề: hai mươi tab Claude Code mở cùng lúc mà chẳng có bản ghi nào về việc mỗi tab đang làm gì, ngữ cảnh phải giải thích lại bằng tay mỗi phiên, và những công việc lặp lại bạn phải tự nhớ để kích hoạt thủ công. README liệt kê chính xác đây là những kiểu lỗi Paperclip nhắm tới — mất trạng thái khi reboot, các file config agent rải rác đóng vai trò thay cho quản lý task thực sự, và chi phí token vượt tầm kiểm soát trước khi ai kịp nhận ra.

Paperclip Phù Hợp Với Ai

Paperclip phù hợp với các team đã chạy nhiều AI agent — OpenClaw, Claude Code, Codex, Cursor — hướng tới cùng một mục tiêu và cần sơ đồ tổ chức, ngân sách, cùng nhật ký audit để giữ mọi thứ minh bạch. Nó cũng phù hợp với một người vận hành một mình nhưng có nhiều 'doanh nghiệp' chạy bằng AI, muốn một dashboard duy nhất, truy cập được từ điện thoại qua Tailscale, thay vì một đống script. Bỏ qua nếu bạn chỉ chạy một agent cho một task; chính README nói Paperclip 'không phải công cụ cho một agent đơn lẻ.'

Năng Lực Cốt Lõi Cho Agent Orchestration

• ✓Bring Your Own Agent: bất kỳ runtime nào nhận được heartbeat đều được 'thuê' — Claude Code, Codex, các CLI agent như Cursor hay Gemini, hoặc bot HTTP/webhook như OpenClaw, theo danh sách adapter trong README.
• ✓Heartbeat execution: agent 'thức dậy' theo lịch hoặc theo sự kiện (được giao task, được @-mention), kiểm tra công việc rồi hành động; README mô tả một hàng đợi wakeup lưu trong DB có gộp lệnh và tự phục hồi các run bị treo.
• ✓Cost control: ngân sách hàng tháng theo phạm vi company, agent, project, goal, issue, provider và model, kèm ngưỡng cảnh báo và điểm dừng cứng khiến agent tạm dừng, huỷ công việc đang chờ khi vượt ngân sách.
• ✓Sơ đồ tổ chức và quản trị: cấu trúc phân cấp hỗn hợp người-agent với vai trò, cấp báo cáo, và cổng phê duyệt — README nói bạn có thể duyệt tuyển dụng, ghi đè chiến lược, hoặc tạm dừng/chấm dứt bất kỳ agent nào bất cứ lúc nào.
• ✓Multi-Company isolation: một deployment duy nhất chạy được nhiều company, theo README là cách ly dữ liệu hoàn toàn và nhật ký audit riêng biệt.
• ✓Ticket system: mọi cuộc trò chuyện và quyết định đều được truy vết, với điều README gọi là tool-call tracing đầy đủ và audit log không thể chỉnh sửa.
• ✓Company portability: export/import toàn bộ một tổ chức — agent, skill, project, routine, issue — kèm lọc bỏ secret và xử lý xung đột.

Bắt Đầu Với Paperclip

Cách nhanh nhất là dùng installer: `curl -fsSLO https://paperclip.ing/install.sh` cùng file `.sha256` của nó, xác minh bằng `sha256sum -c` (hoặc `shasum -a 256 -c` trên macOS), rồi `bash install.sh`. Script kiểm tra Node.js 20 trở lên, cài một CLI `paperclipai` được quản lý dưới `~/.paperclip/cli`, và dẫn dắt onboarding tương tác; nó cũng có thể đăng ký Paperclip như một background service trên các hệ Linux và macOS được hỗ trợ. Để cài không tương tác: `curl -fsSL https://paperclip.ing/install.sh | bash -s -- --no-prompt --no-onboard` rồi `paperclipai onboard --yes`. Để dùng thử mà không cài gì lâu dài: `npx --registry https://registry.npmjs.org paperclipai onboard --yes`. Để build từ source: `git clone https://github.com/paperclipai/paperclip.git && cd paperclip && pnpm install && pnpm dev` — lệnh này khởi động API server tại `http://localhost:3100` với một PostgreSQL nhúng được tạo tự động. Yêu cầu: Node.js 20+, pnpm 9.15+.

Paperclip So Với Các Giải Pháp Agent Khác

Câu Hỏi Thường Gặp

Trường Hợp Sử Dụng Tốt Nhất

• •Dựng một 'công ty AI' cho một mục tiêu cụ thể — ví dụ chính README đưa ra là xây một app ghi chú hướng tới $1M MRR — với một đội vai trò AI được thuê (CEO, CTO, kỹ sư, designer, marketer).
• •Thay một đống config agent rải rác bằng một sơ đồ tổ chức, hệ thống ticket, và phân quyền thật, thay vì tự tay dựng lại cơ chế điều phối agent.
• •Áp ngân sách hàng tháng theo từng agent để một vòng lặp chạy sai tự dừng lại thay vì đốt hết quota token trước khi ai đó nhận ra.
• •Chạy các công việc lặp lại — hỗ trợ khách hàng, đăng bài social, báo cáo — theo routine đã lên lịch thay vì tự tay kích hoạt từng cái.
• •Quản lý nhiều doanh nghiệp tự vận hành từ một control plane duy nhất, kể cả từ điện thoại, vì dashboard hỗ trợ mobile theo README.

Repo liên quan