Bỏ qua tới nội dung
Ông T.vn

Paperclip: quản lý đội AI agent như một công ty — hướng dẫn cài đặt và dùng

12 phút đọcCập nhật
Paperclip: quản lý đội AI agent như một công ty — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Paperclip là ứng dụng mã nguồn mở (Node.js + React) để điều phối cả một đội AI agent như Claude Code, Codex, Cursor, Gemini CLI. Bạn đặt mục tiêu, giao việc, đặt ngân sách và duyệt kết quả trên một giao diện giống phần mềm quản lý công việc. Cài cần Node 24.11 trở lên và biết dùng terminal, README phần được cung cấp chưa ghi lệnh cài cụ thể nên bài này chỉ rõ chỗ cần xem thêm.

Paperclip là một ứng dụng mã nguồn mở gồm máy chủ Node.js và giao diện web React, dùng để quản lý cả một đội AI agent làm việc cho bạn. Nó trông giống một phần mềm quản lý công việc, nhưng bên dưới có sơ đồ tổ chức, ngân sách, duyệt việc và theo dõi mục tiêu. Tác giả tóm gọn: nếu OpenClaw là một nhân viên thì Paperclip là cả công ty.

Bạn nên quan tâm nếu đang mở nhiều cửa sổ Claude Code, Codex hay Cursor cùng lúc và không nhớ cái nào đang làm gì. Nó cũng hợp với người muốn agent chạy liên tục nhưng vẫn kiểm tra được việc đã làm và số tiền token đã tiêu. Repo hiện có khoảng 113.353 sao và 18.816 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất là bạn quản lý mục tiêu chứ không phải từng đoạn code hay từng cửa sổ terminal. Bạn nêu mục tiêu, tuyển các agent vào đúng vai (CEO, kỹ sư, marketer…), đặt ngân sách rồi theo dõi. Bạn có thể xem video ngắn bên dưới để thấy giao diện trước khi cài.

Ứng dụng

paperclipai/paperclip

Paperclip là máy chủ Node.js kèm giao diện web mã nguồn mở, giúp giao việc, theo dõi chi phí và kiểm soát nhiều AI agent từ một bảng điều khiển.

★ 113kTypeScriptMIT
Xem repo trên GitHub
Video giới thiệu paperclipXem trên YouTubeXem trên Facebook

I.Paperclip làm được gì

Dưới đây là những tính năng chính, kèm lợi ích thực tế khi dùng.

A.Mang agent nào cũng được

Paperclip làm việc với nhiều loại agent: OpenClaw, Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Pi, Hermes, Grok Build, Kimi Code. README có một câu đáng nhớ: "nếu nó nhận được heartbeat thì nó được tuyển". Tức là nếu agent nhận được tín hiệu đánh thức, nó vào đội được. Tiến trình tự viết, địa chỉ HTTP hoặc gói adapter bên ngoài cũng thêm vào được. Lợi ích: bạn không bị khoá vào một hãng, mỗi vai có thể dùng một mô hình khác nhau.

B.Giao việc như quản lý ticket

Mỗi việc là một "task" có luồng trao đổi, kế hoạch, vướng mắc, tệp đính kèm và lịch sử chạy. Bạn giao cho agent hoặc cho người. README nói phiên làm việc được lưu lại qua các lần khởi động lại, nên bạn không mất hết khi tắt máy.

C.Hiểu mục tiêu phía sau công việc

Task và dự án được gắn với mục tiêu của tổ chức. Agent nhận được cả ngữ cảnh "vì sao phải làm", không chỉ một tiêu đề. Bạn đỡ phải tự nhắc lại bối cảnh nhiều lần.

D.Heartbeat và lịch chạy

Agent "thức dậy" khi có việc được giao, có tin nhắn tiếp theo, hoặc theo lịch đã đặt. Việc định kỳ (báo cáo, chăm sóc khách hàng, đăng mạng xã hội) có thể đặt thành routine chạy theo cron, webhook hoặc API. Mỗi lần chạy tạo ra một task có chủ và có lịch sử.

E.Kiểm soát chi phí

Bạn đặt ngân sách theo công ty, agent hoặc dự án. Hệ thống theo dõi chi tiêu được báo cáo, cảnh báo khi gần ngưỡng và tạm dừng ở giới hạn đã cấu hình. README nói rõ việc dừng dựa trên số liệu đã ghi nhận, nên báo cáo trễ hoặc việc đang chạy dở có thể làm việc dừng chậm hơn một chút.

F.Duyệt và quản trị

Bạn cấu hình các bước review và phê duyệt, duyệt việc tuyển agent mới, và tạm dừng, giao lại hoặc dừng hẳn công việc khi cần. Thay đổi cấu hình có phiên bản nên có thể hoàn tác.

G.Kết nối ứng dụng

Bạn kết nối các dịch vụ như GitHub, Notion, Railway hoặc máy chủ MCP của riêng bạn. Mỗi hành động qua cổng kết nối đặt được ở ba mức: Cho phép, Hỏi trước, hoặc Tắt. Ai được dùng kết nối và agent nào được chạm vào nó là các quyền tách biệt.

H.Skill, mẫu đội nhóm và nhiều tổ chức

  • Skill Studio: cài hoặc tự viết skill dùng chung, thử với dữ liệu mẫu đã lưu, xem kết quả và khôi phục phiên bản cũ.
  • Đội dựng sẵn: xem trước và cài các nhóm có sẵn vai trò, skill, dự án và routine, rồi chọn runtime của riêng bạn.
  • Nhiều tổ chức: một lần triển khai chứa được nhiều tổ chức, mỗi nơi tách riêng task, agent, quyền và lịch sử.
  • Chat thử nghiệm: tính năng Agent Chat và kết nối chat/email (Slack, Discord, Telegram, AgentMail) đang ở mức thử nghiệm và phải bật trong cài đặt.

II.Cần chuẩn bị gì

Phần README mình có chỉ nói rõ vài điều. Mình chỉ liệt kê những gì có trong tư liệu:

  • Node.js từ 24.11.0 trở lên. File package.json của repo yêu cầu như vậy.
  • pnpm. Repo dùng pnpm-workspace.yaml và pnpm-lock.yaml, nên quản lý gói bằng pnpm.
  • Một cơ sở dữ liệu. File .env.example có biến DATABASE_URL.
  • Các agent bạn muốn dùng. Paperclip điều phối agent chứ không thay thế chúng. Ví dụ muốn dùng Claude Code hay Codex thì bạn cần có công cụ đó và tài khoản của nó. README không nói chi tiết cách đăng nhập từng agent.
  • Docker (tuỳ chọn). Repo có sẵn Dockerfile, nhưng phần README mình có không ghi lệnh chạy bằng Docker.

Tư liệu không nói về yêu cầu GPU, dung lượng ổ cứng hay hệ điều hành cụ thể, nên mình không khẳng định gì thêm.

Paperclip có thể kích hoạt agent chạy liên tục và agent tiêu token thật. Trước khi cho chạy thật, bạn nên đặt ngân sách và ngưỡng cảnh báo. Không dán key hay mật khẩu vào mô tả task hay chat. Hãy dùng phần quản lý secret của Paperclip.

III.Cài đặt từng bước

Lưu ý trước: phần README được cung cấp bị cắt trước mục Quickstart, nên mình chưa có lệnh khởi chạy chính thức để chép. Các bước dưới đây chỉ gồm lệnh phổ thông chắc chắn đúng, và chỉ cho bạn chỗ xem lệnh còn lại.

  1. Kiểm tra NodeChạy node --version, cần 24.11.0 trở lên
  2. Tải mã nguồnDùng git clone rồi cd vào thư mục paperclip
  3. Cài thư việnChạy pnpm install ở thư mục gốc
  4. Tạo file .envSao chép .env.example thành .env rồi điền giá trị
  5. Khởi chạyLàm theo mục Quickstart trong README hoặc trang tài liệu

A.Kiểm tra phiên bản Node

Mở terminal (trên Windows dùng PowerShell hoặc Terminal; trên macOS/Linux dùng Terminal) và chạy lệnh dưới đây. Nếu số hiện ra nhỏ hơn 24.11.0, bạn cần nâng cấp Node trước, nếu không các bước sau dễ lỗi.

Terminal
node --version

B.Tải mã nguồn về máy

Lệnh dưới tải toàn bộ repo về một thư mục tên paperclip, rồi đi vào thư mục đó. Từ đây trở đi, mọi lệnh bạn chạy trong thư mục này.

Terminal
git clone https://github.com/paperclipai/paperclip.git
cd paperclip

C.Cài thư viện phụ thuộc

Repo dùng pnpm, nên bạn cài thư viện bằng pnpm install. Nếu máy báo không có lệnh pnpm thì bạn cần cài pnpm trước. README phần mình có không ghi cách cài pnpm, bạn xem trang chủ pnpm.

Terminal
pnpm install

Lệnh này đọc file pnpm-lock.yaml và tải đúng phiên bản các gói. Lần đầu có thể mất vài phút.

D.Tạo file cấu hình .env

Repo có sẵn file mẫu .env.example. Bạn sao chép nó thành .env rồi mở bằng trình soạn thảo để điền. Trên macOS/Linux:

Terminal
cp .env.example .env

Trên Windows PowerShell:

PowerShell
Copy-Item .env.example .env

Trong file mẫu có các biến sau (mình chỉ biết tên, không biết giá trị gợi ý):

  • DATABASE_URL: địa chỉ cơ sở dữ liệu.
  • PORT: cổng máy chủ lắng nghe.
  • SERVE_UI: liên quan đến việc có phục vụ giao diện web hay không.
  • BETTER_AUTH_SECRET: tên gợi là khoá bí mật cho phần đăng nhập.
  • PAPERCLIP_TOOL_ACTION_SIGNING_SECRET: tên gợi là khoá ký cho các hành động của công cụ.
  • PAPERCLIP_SENTRY_RUN_FAILURES: liên quan đến báo lỗi khi chạy thất bại.

Các khoá bí mật nên là chuỗi dài, ngẫu nhiên và chỉ bạn biết. Đừng đưa file .env lên GitHub hay gửi cho người khác. Ý nghĩa chính xác từng biến, bạn đối chiếu trong tài liệu của dự án.

E.Khởi chạy ứng dụng

Đây là chỗ README chưa ghi cách chạy trong phần mình có. Bạn xem theo thứ tự sau:

  1. Mục Quickstart ở đầu README trên trang GitHub của repo.
  2. Trang tài liệu chính thức tại docs.paperclip.ing.
  3. Phần scripts trong file package.json ở thư mục gốc, nơi liệt kê các lệnh chạy có sẵn.
  4. File Dockerfile và thư mục docker/ nếu bạn muốn chạy bằng container.

Mình không đoán tên lệnh cho bạn để tránh chép sai. Khi tìm được lệnh chính thức, hãy chạy nó trong thư mục paperclip đã clone.

IV.Kiểm tra đã chạy được chưa

Phần README mình có không mô tả màn hình sau khi cài. Dựa vào cấu trúc dự án (máy chủ Node.js kèm giao diện React, có biến PORT), cách kiểm tra hợp lý là:

  1. Terminal cho thấy máy chủ đang chạy và không báo lỗi đỏ.
  2. Bạn mở trình duyệt vào địa chỉ http://localhost kèm số cổng bạn đặt ở PORT (hoặc số cổng mà terminal in ra).
  3. Bạn thấy giao diện Paperclip để tạo tổ chức, mục tiêu và agent.

Nếu trình duyệt không vào được, hãy đọc kỹ dòng cuối trong terminal. Thường nó nói rõ lỗi nằm ở cơ sở dữ liệu, cổng hay thiếu khoá trong .env.

V.Dùng vào việc thật

Dưới đây là các tình huống bám đúng khả năng README mô tả. Tên nút bấm trên giao diện có thể khác chút, bạn cứ theo tinh thần.

A.Dev đang mở quá nhiều tab Claude Code

Bối cảnh: bạn là lập trình viên tự do, đang để 5 đến 6 cửa sổ Claude Code cho nhiều dự án. Mỗi lần khởi động lại máy là mất dấu cái nào đang làm gì.

Cách làm: tạo một tổ chức trong Paperclip, thêm Claude Code làm một agent, rồi nhập từng việc thành task kèm dự án. Agent nhận việc và làm trên đó, bạn xem tiến độ ở luồng trao đổi của task. README nói phiên làm việc được lưu lại qua các lần khởi động, với agent nào hỗ trợ.

Kết quả: một danh sách việc rõ ràng thay vì một đống tab. Bạn duyệt kết quả khi agent báo xong.

Quản lý mục tiêu, đừng quản lý từng cửa sổ terminal.

Ông T

B.Chủ shop muốn báo cáo định kỳ

Bối cảnh: bạn bán hàng online và mỗi tuần cần một bản tổng hợp (ví dụ tình hình chăm sóc khách hàng) nhưng hay quên giao việc.

Cách làm: tạo một routine chạy theo lịch (cron), giao cho một agent phù hợp, và mô tả việc cần làm bằng một câu lệnh ngắn như:

text
Mỗi sáng thứ Hai, tổng hợp các phản hồi khách hàng tuần trước thành bản tóm tắt 10 dòng và đưa vào tài liệu của task.

Kết quả: mỗi lần đến giờ, Paperclip tạo một task có chủ, agent chạy, và bạn xem được kết quả cùng lịch sử chạy. Muốn đưa kết quả về điện thoại hay chat thì xem tính năng chat/email còn đang thử nghiệm, phải bật trong cài đặt.

C.Chủ doanh nghiệp nhỏ giữ chi phí trong tầm tay

Bối cảnh: bạn sợ agent chạy vòng lặp và đốt tiền token mà không hay biết.

Cách làm: đặt ngân sách cho công ty, cho từng agent và từng dự án, kèm ngưỡng cảnh báo. Với các hành động nhạy cảm qua cổng kết nối (ví dụ gửi thứ gì đó qua GitHub hay Notion), bạn đặt mức Hỏi trước để tự duyệt từng lần.

Kết quả: khi gần ngưỡng bạn nhận cảnh báo, và khi chạm giới hạn thì công việc được tạm dừng. Nhớ rằng việc dừng dựa trên số liệu đã ghi nhận nên có thể trễ chút, vì vậy đừng đặt ngưỡng sát mức bạn chịu được.

D.Dựng nguyên một đội theo mẫu

Bối cảnh: bạn muốn thử mô hình "công ty AI" nhưng chưa biết nên có những vai nào.

Cách làm: vào phần đội dựng sẵn, xem trước một mẫu gồm vai trò, skill, dự án và routine, rồi cài và chọn runtime cho từng agent. Sau đó nhập mục tiêu lớn theo kiểu README ví dụ: "Build the #1 AI note-taking app to $1M MRR", duyệt chiến lược rồi cho chạy.

Kết quả: bạn có sẵn khung tổ chức để chỉnh lại, thay vì dựng từ trắng. Nhớ đặt ngân sách trước khi bấm chạy.

VI.Lỗi hay gặp và cách xử lý

Tư liệu không có mục xử lý lỗi, nên các lỗi dưới đây là những lỗi rất dễ gặp với loại công cụ này.

A.Báo sai phiên bản Node hoặc lỗi khi cài thư viện

Repo yêu cầu Node từ 24.11.0. Nếu node --version cho số thấp hơn, hãy nâng Node rồi chạy lại pnpm install. Nếu máy không nhận lệnh pnpm, bạn cần cài pnpm trước.

B.Máy chủ không lên vì cổng bận hoặc thiếu cấu hình

Nếu terminal báo cổng đang được dùng, đổi giá trị PORT trong .env sang số khác. Nếu báo lỗi liên quan cơ sở dữ liệu hay thiếu khoá bí mật, kiểm tra lại DATABASE_URL, BETTER_AUTH_SECRET và PAPERCLIP_TOOL_ACTION_SIGNING_SECRET trong .env đã điền chưa.

C.Agent được tuyển nhưng không chạy

Paperclip điều phối agent chứ không thay thế chúng. Nếu Claude Code, Codex hay agent khác chưa được cài, chưa đăng nhập, hoặc không có quyền chạy trên máy thì việc sẽ không tiến triển. Hãy thử chạy riêng agent đó ở terminal trước để chắc nó dùng được, rồi mới thêm vào Paperclip.

D.Chi phí tăng nhanh hơn dự tính

Đặt ngân sách theo từng agent và dự án, bật cảnh báo, và bắt đầu với việc nhỏ. Vì việc dừng dựa trên số liệu đã ghi nhận, hãy đặt ngưỡng thấp hơn mức bạn thực sự chịu được.

E.Tính năng chat hoặc email không thấy đâu

Agent Chat và kết nối Slack, Discord, Telegram, AgentMail là tính năng thử nghiệm. README nói phải bật trong cài đặt của instance mới dùng được. Nếu không thấy, hãy tìm trong phần cài đặt chung trước khi nghi ngờ cài sai.

VII.Có nên dùng không

Điểm mạnh:

  • Gom nhiều agent khác hãng vào một nơi, có sơ đồ tổ chức, task, duyệt việc và lịch sử.
  • Có sẵn kiểm soát chi phí, quyền hạn và bước phê duyệt, những thứ bạn sẽ phải tự dựng nếu chỉ dùng script rời.
  • Mã nguồn mở theo giấy phép MIT, cộng đồng lớn và vẫn đang cập nhật.
  • Hỗ trợ nhiều tổ chức trong một lần triển khai, và có thể mở rộng bằng plugin mà không cần fork.

Giới hạn:

  • Đây là một hệ thống đầy đủ, không phải công cụ một lệnh. Người mới sẽ mất thời gian làm quen các khái niệm như tổ chức, heartbeat, routine, quyền kết nối.
  • Cần Node 24.11 trở lên, pnpm và một cơ sở dữ liệu. Phần README mình có chưa ghi lệnh khởi chạy, nên bạn phải đọc thêm tài liệu chính thức.
  • Bạn vẫn cần tự có các agent và tài khoản của chúng. Chi phí token do các agent đó phát sinh.
  • Một số tính năng (chat, kết nối email) còn thử nghiệm. Tư liệu cũng chưa nói về hiệu năng khi quy mô lớn.

Khi nào nên chọn cách khác: nếu bạn chỉ dùng một agent cho vài việc lẻ, mở thẳng Claude Code hay Codex sẽ nhẹ hơn. Paperclip thật sự có giá trị khi bạn có nhiều agent, nhiều việc chạy song song, và cần theo dõi, duyệt và kiểm soát chi phí một cách có hệ thống.

5.0/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

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

Repo là mã nguồn mở theo giấy phép MIT nên bạn tải và chạy tự do. Tuy nhiên các agent bạn gắn vào (Claude Code, Codex…) có thể tính phí theo tài khoản và token của chúng. README cũng nhắc đến danh sách chờ Paperclip Cloud, nhưng tư liệu chưa có thông tin về giá.

Paperclip khác gì việc mở nhiều cửa sổ Claude Code?

Paperclip gom các agent vào một giao diện giống quản lý task, có sơ đồ tổ chức, luồng trao đổi, duyệt việc, ngân sách và lịch sử chạy. README nói phiên làm việc được lưu qua các lần khởi động lại với agent hỗ trợ. Nó không thay thế Claude Code mà điều phối công cụ đó.

Cần những agent nào để dùng?

README liệt kê OpenClaw, Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Pi, Hermes, Grok Build và Kimi Code. Tiến trình tự viết, địa chỉ HTTP và gói adapter ngoài cũng thêm được. Bạn tự chuẩn bị tài khoản và công cụ cho agent mình chọn.

Cần Node phiên bản nào, có cần GPU không?

File package.json yêu cầu Node từ 24.11.0 trở lên. Tư liệu không nhắc đến yêu cầu GPU, nên mình không có thông tin về chuyện này. Phần nặng tính toán nằm ở các agent và mô hình bạn gắn vào.

Chạy được trên Windows không?

Phần README mình có không nói rõ hệ điều hành nào được hỗ trợ. Công cụ dựa trên Node.js và pnpm nên về nguyên tắc bạn có thể thử trên Windows, nhưng bạn nên kiểm tra mục Quickstart và tài liệu chính thức để chắc chắn.

Dữ liệu và khoá bí mật có an toàn không?

README nói Paperclip có lưu trữ thông tin xác thực được mã hoá, tham chiếu secret để cấp khoá cho lượt chạy được phép, và ghi lại hoạt động để kiểm tra. Hệ thống có hai chế độ triển khai (cục bộ tin cậy hoặc có xác thực). Mức an toàn thực tế còn phụ thuộc cách bạn cấu hình và triển khai, nên bạn đọc thêm SECURITY.md trong repo.

Có dùng được trên điện thoại không?

README ghi tính năng Mobile Ready, cho phép theo dõi và quản lý từ nơi khác. Chi tiết cách dùng trên điện thoại chưa có trong tư liệu mình có.

Chuyển nhanh tới mục

  1. I.Paperclip làm được gì
    1. A.Mang agent nào cũng được
    2. B.Giao việc như quản lý ticket
    3. C.Hiểu mục tiêu phía sau công việc
    4. D.Heartbeat và lịch chạy
    5. E.Kiểm soát chi phí
    6. F.Duyệt và quản trị
    7. G.Kết nối ứng dụng
    8. H.Skill, mẫu đội nhóm và nhiều tổ chức
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra phiên bản Node
    2. B.Tải mã nguồn về máy
    3. C.Cài thư viện phụ thuộc
    4. D.Tạo file cấu hình .env
    5. E.Khởi chạy ứng dụng
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev đang mở quá nhiều tab Claude Code
    2. B.Chủ shop muốn báo cáo định kỳ
    3. C.Chủ doanh nghiệp nhỏ giữ chi phí trong tầm tay
    4. D.Dựng nguyên một đội theo mẫu
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Báo sai phiên bản Node hoặc lỗi khi cài thư viện
    2. B.Máy chủ không lên vì cổng bận hoặc thiếu cấu hình
    3. C.Agent được tuyển nhưng không chạy
    4. D.Chi phí tăng nhanh hơn dự tính
    5. E.Tính năng chat hoặc email không thấy đâu
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.