Paperclip là gì? Nền tảng điều phối đội ngũ AI Agent như một công ty: tính năng, cài đặt và rủi ro

Paperclip là gì? Paperclip là máy chủ Node.js mã nguồn mở kèm giao diện React để điều phối cả một đội tác tử AI như thể đó là một công ty: có sơ đồ tổ chức, mục tiêu, ngân sách, quy trình phê duyệt và theo dõi công việc dạng phiếu. Theo kho GitHub (đọc ngày 24/10/2026), dự án theo giấy phép MIT, do Paperclip Labs, Inc. duy trì, có khoảng 106,6 nghìn sao, chạy được với các tác tử như Claude Code của Anthropic, Codex của OpenAI, Cursor, Gemini CLI, OpenClaw và Hermes. Câu giới thiệu của dự án: nếu OpenClaw là một nhân viên thì Paperclip là cả công ty. Lưu ý chính tả: tên đúng là Paperclip (một chữ p ở giữa). Bài này gồm sáu phần: (1) Paperclip làm gì; (2) khái niệm chính; (3) cách cài; (4) rủi ro; (5) khi nào nên dùng; (6) kinh nghiệm của OPCAIOS trên máy chủ riêng.

Paperclip không phải một tác tử, mà là lớp quản lý nhiều tác tử: vai trò, ngân sách, phê duyệt. Sơ đồ: OPCAIOS.

Paperclip là gì và nó không phải là gì?

Paperclip là lớp điều phối cho một đội tác tử, theo trang kho mã GitHub (đọc ngày 24/10/2026). Paperclip không phải chatbot, khung xây tác tử (agent framework), công cụ dựng quy trình hay trình quản lý lời nhắc, và không giới hạn ở một tác tử hay việc xem lại mã. Mỗi tác tử trong Paperclip được cấp vai trò, chức danh, người quản lý và quyền hạn. Công việc được giao dưới dạng phiếu gắn với mục tiêu của tổ chức để tác tử hiểu vì sao phải làm việc đó. Nếu bạn mới làm quen với khái niệm tác tử, xem LLM là gì? và Cách xây dựng hệ thống AI Agent làm việc 24/7.

Các khái niệm chính

Khái niệm	Ý nghĩa theo tài liệu
Sơ đồ tổ chức	Tác tử có vai trò, chức danh, quan hệ báo cáo và quyền hạn
Mục tiêu	Nhiệm vụ và dự án gắn với mục tiêu tổ chức để tác tử có ngữ cảnh
Nhịp đánh thức (heartbeats)	Tác tử thức dậy để làm việc được giao, trả lời tin nhắn hoặc theo lịch
Ngân sách	Ngân sách theo công ty, tác tử, dự án; cảnh báo theo ngưỡng và tự dừng khi chạm giới hạn
Quản trị	Giai đoạn xem xét và phê duyệt, phê duyệt tuyển tác tử mới, tạm dừng, giao lại hoặc dừng việc
Luồng trao đổi trong phiếu	Hội thoại, kế hoạch, tệp và lịch sử chạy gắn với từng nhiệm vụ
Việc định kỳ	Kích hoạt bằng cron, webhook hoặc API, mỗi lần có phiếu và lịch sử
Kỹ năng	Kỹ năng dùng chung, có đầu vào kiểm thử lưu sẵn và khôi phục phiên bản
Kết nối	GitHub, Notion, Railway và máy chủ MCP tuỳ chỉnh, với cổng Cho phép, Hỏi trước, Tắt
Nhiều tổ chức	Một lần triển khai có thể chứa nhiều tổ chức riêng biệt

Các runtime tác tử được liệt kê: OpenClaw, Claude Code, Codex, Cursor (và Cursor Cloud), Gemini CLI, OpenCode, Pi, Hermes, Grok Build, Kimi Code, cùng tiến trình tuỳ chỉnh và điểm cuối HTTP.

Cài đặt và yêu cầu

Cài Paperclip là chạy một lệnh sau khi có Node.js. Bước 1, theo kho GitHub của Paperclip (đọc ngày 24/10/2026), chuẩn bị Node.js 24.11 trở lên. Bước 2, chạy lệnh npx paperclipai@latest onboard --yes. Bước 3, mở giao diện ở cổng cục bộ. Chế độ phát triển cần thêm pnpm 9.15 trở lên rồi chạy pnpm install và pnpm dev (giao diện và API ở cổng cục bộ). Đăng nhập bằng gói thuê bao Claude hoặc Codex cục bộ cần Python 3 và công cụ dòng lệnh tương ứng. Cơ sở dữ liệu PostgreSQL nhúng được tạo tự động cho môi trường cục bộ; bản sản xuất dùng Postgres riêng. Có hai chế độ triển khai: tin cậy cục bộ (loopback) hoặc có xác thực và riêng tư. Dự án gợi ý truy cập từ xa qua mạng riêng như Tailscale. Ví dụ giả định, một người thử trên máy cá nhân dùng chế độ cục bộ. Về hạ tầng máy chủ, xem VPS là gì? và Docker là gì?.

Rủi ro và lưu ý

Paperclip có sáu rủi ro cần kiểm soát, theo kho GitHub của dự án (đọc ngày 24/10/2026):

• 1. Quyền của tác tử: mỗi tác tử có thể chạy lệnh và dùng công cụ; hãy dùng cổng Cho phép, Hỏi trước, Tắt và cấp quyền tối thiểu (xem MCP là gì?).
• 2. Chi phí: nhiều tác tử chạy nền tiêu tốn token; đặt ngân sách theo tác tử và dự án để tự dừng khi chạm giới hạn.
• 3. Bí mật: theo dự án, bí mật công ty được lưu mã hoá và cấu hình tác tử chỉ tham chiếu đến bí mật; nhưng gói xuất ra có thể còn giá trị biến môi trường thường và đường dẫn cục bộ, nên xem lại trước khi chia sẻ.
• 4. Thông tin đo từ xa (telemetry): mặc định bật; tắt bằng PAPERCLIP_TELEMETRY_DISABLED=1, DO_NOT_TRACK=1 hoặc cấu hình.
• 5. Dự án rất mới: lộ trình còn nhiều mục đang làm (bộ nhớ và tri thức, hội thoại với tác tử, triển khai đám mây); tính năng thay đổi nhanh.
• 6. Không thay con người: phê duyệt, mục tiêu và ngân sách vẫn do bạn đặt; tác tử chỉ làm trong khung đó.

Khi nào nên dùng Paperclip?

Tình huống	Gợi ý
Có từ hai tác tử trở lên làm việc song song, cần giao việc và kiểm soát chi phí	Paperclip phù hợp
Chỉ một tác tử, một việc	Chưa cần; dùng trực tiếp tác tử đó
Muốn thêm tầng phê duyệt và nhật ký cho tác tử chạy nền	Paperclip có sẵn phê duyệt và lịch sử chạy
Muốn nhiều tác tử phối hợp trong cùng một cửa sổ terminal	Xem Herdr là gì? (hướng khác: multiplexer)

Kinh nghiệm của OPCAIOS

Chúng tôi triển khai Paperclip bằng Docker trên máy chủ riêng, đứng sau reverse proxy, kèm một cơ sở dữ liệu PostgreSQL riêng. Tại thời điểm kiểm tra ngày 24/10/2026, cả hai container đang chạy ổn định (vài ngày liên tục) và trang trả về mã 200. Theo tài liệu triển khai nội bộ, chúng tôi tạo một tổ chức và một tác tử mặc định mang vai trò "chánh văn phòng", dùng runtime Claude cục bộ qua một cổng định tuyến mô hình nội bộ. Chúng tôi chưa đo mức tiết kiệm thời gian hay chất lượng đầu ra của đội tác tử, chưa dùng hết các tính năng như việc định kỳ hay cổng kết nối, và không đưa số liệu hiệu quả vào bài.

Đọc thêm: 6 công cụ chạy nhiều AI agent viết code cùng lúc tốt nhất 2026.

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

Paperclip là gì?

Paperclip là nền tảng mã nguồn mở điều phối đội tác tử AI như một công ty, gồm sơ đồ tổ chức, mục tiêu, ngân sách, quy trình phê duyệt và phiếu việc. Ví dụ giả định: một chủ doanh nghiệp nhỏ có thể tạo một tổ chức với vài tác tử, giao việc dưới dạng phiếu gắn mục tiêu và duyệt từng bước quan trọng. Paperclip không phải một tác tử mà là lớp quản lý nhiều tác tử.

Paperclip có miễn phí không?

Phần mềm Paperclip là mã nguồn mở theo giấy phép MIT và tự lưu trữ, nên bạn không trả phí bản quyền. Theo kho GitHub của dự án (đọc ngày 24/10/2026), dự án do Paperclip Labs, Inc. duy trì và có khoảng 106,6 nghìn sao. Tuy nhiên bạn vẫn trả phí cho mô hình hoặc gói thuê bao của các tác tử bên dưới, như Claude Code của Anthropic hoặc Codex của OpenAI, và trả chi phí máy chủ nếu tự lưu trữ. Ví dụ giả định: một đội 3 tác tử chạy nền cả ngày có thể tốn token đáng kể, nên hãy đặt ngân sách theo tác tử và dự án để Paperclip tự dừng khi chạm giới hạn. Đầu tiên tính chi phí máy chủ, tiếp theo tính phí mô hình, cuối cùng đặt ngân sách.

Paperclip khác Claude Code hay OpenClaw thế nào?

Claude Code của Anthropic và OpenClaw là các tác tử (giống nhân viên); Paperclip quản lý nhiều tác tử như vậy (giống công ty). Theo kho GitHub của Paperclip (đọc ngày 24/10/2026), Paperclip không thay thế các tác tử đó mà đứng phía trên chúng. Ví dụ, bạn có thể giao một phiếu cho tác tử dùng Claude Code và một phiếu khác cho tác tử dùng Codex, rồi duyệt kết quả ở cùng một nơi. Xem 5 công cụ AI Agent tự hành.

Cài Paperclip cần gì?

Cài Paperclip cần Node.js 24.11 trở lên và lệnh npx paperclipai@latest onboard --yes, theo kho GitHub của dự án (đọc ngày 24/10/2026). Môi trường cục bộ tạo sẵn cơ sở dữ liệu PostgreSQL nhúng, còn bản sản xuất cần PostgreSQL riêng và truy cập qua mạng riêng như Tailscale. Ví dụ giả định: một nhóm triển khai cho nhiều người nên dùng Docker, PostgreSQL riêng và mạng riêng.

Có an toàn không?

Có cổng quyền, ngân sách tự dừng và nhật ký, nhưng tác tử vẫn chạy lệnh thật nên cần quyền tối thiểu và người duyệt. Theo kho GitHub của Paperclip (đọc ngày 24/10/2026), mỗi tác tử có thể chạy lệnh và dùng công cụ, và kết nối có ba cổng: Cho phép, Hỏi trước và Tắt. Bước 1, cấp quyền tối thiểu cho từng tác tử. Bước 2, đặt ngân sách theo tác tử và dự án để tự dừng khi chạm giới hạn. Bước 3, giữ người duyệt cho các thao tác không hoàn tác được. Thông tin đo từ xa (telemetry) mặc định bật và tắt được bằng PAPERCLIP_TELEMETRY_DISABLED=1. Muốn học cách dựng đội tác tử an toàn, xem khoá đào tạo ứng dụng AI của OPCAIOS.

Nguồn: kho GitHub paperclipai/paperclip, đọc trực tiếp ngày 24/10/2026; số sao và tính năng thay đổi nhanh. Chúng tôi chưa đọc tài liệu chi tiết từng tính năng. Kinh nghiệm là của OPCAIOS theo tài liệu triển khai nội bộ và kiểm tra trực tiếp.