03 / AI REPO RADAR

paperclipai/paperclip

Ứng dụng mã nguồn mở (máy chủ Node.js và giao diện React) để điều phối một đội AI agent như một tổ chức: giao việc, sơ đồ tổ chức, ngân sách, phê duyệt và lịch sử chạy.

Paperclip là gì

Paperclip tự giới thiệu là ứng dụng mà mọi người dùng để quản lý AI agent trong công việc, một nền tảng điều phối mã nguồn mở cho cả đội agent. Về mặt kỹ thuật, README mô tả đây là một máy chủ Node.js kèm giao diện React, cho phép mang agent của riêng bạn vào, giao mục tiêu, rồi theo dõi công việc và chi phí trên một bảng điều khiển. Repo dùng giấy phép MIT và tại thời điểm thu thập có 106209 sao trên GitHub.

README dùng một phép so sánh dễ nhớ: nếu OpenClaw là một nhân viên thì Paperclip là cả công ty. Bề ngoài nó trông như một công cụ quản lý công việc, nhưng bên dưới là sơ đồ tổ chức, ngân sách, quản trị, căn chỉnh mục tiêu và phối hợp giữa các agent. Khẩu hiệu của tác giả là hãy quản lý mục tiêu kinh doanh chứ không phải pull request.

Vấn đề mà nó nhắm tới

README có một bảng so sánh trước và sau khi dùng Paperclip. Tình huống quen thuộc là bạn mở 20 terminal Claude Code cùng lúc và không biết cái nào đang làm gì, mất sạch khi khởi động lại máy. Bạn phải tự gom ngữ cảnh từ nhiều nơi để nhắc agent đang làm gì, tự dựng lại cách quản lý công việc và liên lạc giữa các agent, và các vòng lặp chạy mất kiểm soát có thể đốt rất nhiều token trước khi bạn nhận ra.

Phía còn lại là cách Paperclip trả lời: công việc theo dạng ticket, hội thoại theo luồng, phiên làm việc còn nguyên sau khi khởi động lại; ngữ cảnh đi từ nhiệm vụ lên dự án rồi lên mục tiêu công ty; theo dõi chi tiêu, cảnh báo ngân sách và tạm dừng tự động; và các công việc định kỳ được tạo thành nhiệm vụ có lịch sử. Các tuyên bố này là mô tả của tác giả, README không kèm số liệu đo độc lập.

Bốn trụ cột

README cho rằng muốn một tổ chức gồm các agent thật sự tạo ra kết quả thì bốn thứ phải hoạt động: nhiệm vụ, tổ chức, huấn luyện và hạ tầng. Trụ cột thứ nhất là trình quản lý nhiệm vụ cho agent, gồm nhiệm vụ, cổng phê duyệt và review, agent đồng nghiệp chủ động, quy trình có thể kiểm toán, và kiểm chứng đầu ra qua diff, ảnh chụp màn hình và test. Trụ cột thứ hai là sơ đồ tổ chức cho agent, với vai trò, quyền hạn, ranh giới, bí mật theo phạm vi và danh tính người chịu trách nhiệm.

Trụ cột thứ ba là huấn luyện nhân viên agent: Skill Studio và các kỹ năng dùng chung toàn tổ chức, đánh giá và các lần chạy thử đã lưu, vòng lặp học, chỉ số chất lượng, đánh giá hiệu suất cho agent, lịch sử phiên bản kỹ năng có khôi phục và mẫu đội ngũ dùng lại. Trụ cột thứ tư là Agentic OS, tức hạ tầng chạy công việc: runtime đa nhà cung cấp, sandbox, tích hợp và MCP server, SSO, GRC, RBAC, kiểm soát chi phí, quyền riêng tư dữ liệu, lịch sử chạy và truy vết tùy chọn.

Tính năng chính

Danh sách tính năng trong README khá dài. Bring Your Own Agent nghĩa là agent nào nhận được heartbeat thì coi như đã được thuê. Heartbeat là cách agent thức dậy khi có việc được giao, tin nhắn tiếp theo hoặc lịch cấu hình. Goal Alignment gắn nhiệm vụ và dự án với mục tiêu tổ chức để agent biết lý do phía sau công việc. Cost Control đặt ngân sách theo công ty, agent và dự án, theo dõi chi tiêu được báo cáo, cảnh báo theo ngưỡng và tạm dừng ở giới hạn cấu hình.

Ngoài ra có Multi-Organization để một lần triển khai chứa nhiều tổ chức tách biệt, Task Threads để giữ hội thoại, kế hoạch, vật cản, file và lịch sử chạy gắn với công việc, Governance với các giai đoạn review và phê duyệt, và Org Chart với phân cấp, vai trò, tuyến báo cáo. Apps và Connections cho phép nối GitHub, Notion, Railway hoặc MCP server riêng, đặt hành động qua cổng thành Allowed, Ask first hoặc Off. Còn có Skills và Skill Studio, Scheduled Routines kích hoạt theo lịch, API hoặc webhook, Artifacts và Feedback để xem file agent tạo ra, và các đội dựng sẵn để cài nhanh. Agent Chat và các bộ kết nối chat hoặc email như Slack, Discord, Telegram và AgentMail được README ghi là thử nghiệm.

Những gì nằm bên dưới

README nhấn mạnh Paperclip là một control plane đầy đủ chứ không phải lớp bọc mỏng. Về nhiệm vụ, nó có khóa checkout nguyên tử với một người nhận duy nhất và khóa thực thi để các lượt chạy không tranh cùng một việc, phụ thuộc chặn, bình luận, tài liệu, tệp đính kèm và hộp thư. Cơ chế heartbeat dùng hàng đợi đánh thức lưu trong cơ sở dữ liệu, có gộp sự kiện, kiểm tra ngân sách, xác định workspace, nạp bí mật và kỹ năng rồi gọi adapter. Các lượt chạy tạo log, bản ghi sử dụng và trạng thái phiên riêng của adapter, và việc khôi phục có giới hạn xử lý một số lỗi được hỗ trợ.

Về hạ tầng, README nêu workspace dự án với git worktree tách biệt tùy chọn, dịch vụ runtime như dev server và URL xem trước, nhà cung cấp sandbox mở rộng việc thực thi ra ngoài máy chủ cục bộ, hệ plugin chạy tiến trình ngoài, kho bí mật mã hóa, lưu trữ cục bộ hoặc tương thích S3, nhật ký hoạt động bền vững để kiểm toán, và tính năng xuất nhập cả tổ chức. README cảnh báo khi chia sẻ gói tổ chức cần tự xem lại vì giá trị môi trường thường và đường dẫn cục bộ có thể còn sót lại, còn giá trị bí mật tham chiếu thì bị bỏ.

Quản trị, ngân sách và kiểm soát

Phần quản trị là điểm khác biệt mà tác giả nhấn mạnh. Có quy trình phê duyệt của board, chính sách thực thi với các giai đoạn review và phê duyệt, theo dõi quyết định, ngưỡng dừng cứng về ngân sách, và khả năng tạm dừng, tiếp tục hoặc chấm dứt agent. Thay đổi cấu hình được lưu theo phiên bản nên có thể hoàn tác an toàn khi một thay đổi xấu xảy ra. Quyền truy cập của con người, tính đủ điều kiện của agent và quyền thực hiện hành động qua cổng là ba lớp kiểm soát riêng, và người dùng có thể duyệt một lần hoặc lưu thành quy tắc có thể thu hồi.

Về chi phí, Paperclip theo dõi token và tiền theo công ty, agent, dự án, mục tiêu, nhiệm vụ, nhà cung cấp và mô hình, với chính sách ngân sách có ngưỡng cảnh báo và ngưỡng dừng cứng. README thừa nhận việc áp dụng dựa trên chi tiêu đã được ghi nhận, nên báo cáo sử dụng chậm và công việc đang chạy có thể làm trễ thời điểm dừng. Đây là chi tiết quan trọng cho ai định dùng ngân sách như hàng rào bảo vệ tuyệt đối.

Cài đặt và dùng thử

Paperclip mã nguồn mở, tự lưu trữ và không cần tài khoản Paperclip. Theo README, cần Node.js 24.11 trở lên và pnpm 9.15 trở lên cho trường hợp phát triển từ mã nguồn; đăng nhập gói thuê bao Claude và Codex cục bộ còn cần Python 3 và công cụ dòng lệnh của nhà cung cấp tương ứng trên máy chủ, còn ảnh Docker đã gồm sẵn. Có thể chạy một lệnh hướng dẫn từ npm để làm theo quy trình khởi tạo, hoặc nhờ chính agent của bạn đọc hướng dẫn cài đặt rồi tự cài. Cách khởi động nhanh mặc định chạy ở chế độ cục bộ đáng tin cậy qua loopback, và có thể chọn chế độ có xác thực.

Khi chạy cục bộ, một tiến trình Node.js quản lý cơ sở dữ liệu PostgreSQL nhúng và kho file cục bộ, không cần cài đặt thêm. Với môi trường thật, README gợi ý trỏ sang PostgreSQL riêng và triển khai tùy ý, truy cập từ xa qua chế độ xác thực với mạng riêng như Tailscale hoặc qua Docker. Có thêm lệnh test-drive để dựng nhanh một bản thử đã có sẵn agent CEO, chạy ở foreground, không cài dịch vụ và không tạo nhiệm vụ đầu tiên.

Vị trí trong hệ sinh thái agent

README phân định rõ phạm vi. Paperclip không phải chatbot, vì hội thoại gắn với nhiệm vụ, kế hoạch và kết quả. Nó không phải một framework để xây agent: tác giả nói họ không hướng dẫn cách xây agent mà hướng dẫn cách vận hành một công ty gồm các agent. Nó không chỉ là trình dựng workflow, không phải trình quản lý prompt, không giới hạn ở một agent và không chỉ dành cho review code. Danh sách runtime được nêu gồm OpenClaw, Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Pi, Hermes, Grok Build và Kimi Code, cùng tiến trình tùy chỉnh, endpoint HTTP và adapter ngoài.

Cũng vì lý do đó, việc xếp repo vào nhóm framework chỉ mang tính gần đúng của danh mục trên trang này. Với người xây agent, Paperclip nằm ở lớp vận hành phía trên: nó điều phối và kiểm soát các agent có sẵn, còn việc agent suy luận hay dùng công cụ thế nào vẫn do agent tự quyết. Trong lộ trình, README đánh dấu hoàn thành nhiều hạng mục như hệ plugin, kỹ năng, routine, phê duyệt, cổng công cụ MCP và đánh giá agent, còn bộ nhớ và tri thức được ghi là đang làm, các mục như chế độ MAXIMIZER, hàng đợi công việc và tự tổ chức chưa bắt đầu.

Giới hạn và khi nào nên dùng

README đưa ra danh sách tình huống phù hợp: muốn xây tổ chức AI tự chủ, phối hợp nhiều loại agent về một mục tiêu chung, có 20 terminal Claude Code mở cùng lúc và mất dấu, muốn agent chạy tự động 24/7 nhưng vẫn kiểm toán và can thiệp được, muốn giám sát chi phí và áp ngân sách, hoặc muốn quản lý từ điện thoại. Với một agent duy nhất làm việc đơn giản trong một repo, phần lớn chức năng ở đây có thể là thừa, dù README nói có thể bắt đầu với một agent rồi mở rộng.

Có vài điều cần lưu ý. Tính năng Agent Chat và các bộ kết nối chat là thử nghiệm. Việc tích hợp hệ thống ticket có sẵn như Asana, Linear hay Jira mới nằm trong lộ trình. Telemetry ẩn danh được bật theo mặc định, README nói không thu thập thông tin cá nhân, nội dung issue, prompt, đường dẫn file hay bí mật, và có thể tắt bằng biến môi trường, quy ước DO_NOT_TRACK, cấu hình hoặc tự động khi chạy trong CI. Về độ trưởng thành, tác giả cho biết đã gộp hơn 2,700 pull request, nhưng README không có benchmark hiệu năng nào để đối chiếu.

Bài do AI viết tự động từ README và dữ liệu GitHub API của repo, có kiểm tra tự động nhưng không có người duyệt từng câu. Báo sai sót qua email.