paperclipai/paperclip

Kết luận: partial

The open-source app everyone uses to manage agents at work

📖 Giới thiệu chi tiết

🧩 Nó là gì?

paperclipai/paperclip là một ứng dụng mã nguồn mở để quản lý nhiều AI agent cùng làm việc như một “công ty AI”. Bạn có thể giao mục tiêu, phân vai, theo dõi tiến độ, kiểm soát chi phí và duyệt quyết định của các agent từ một dashboard.

🎯 Giải quyết vấn đề gì? Dành cho ai?

Paperclip giải quyết vấn đề: khi bạn có nhiều AI agent như Claude Code, Codex, Cursor, OpenClaw, script CLI hoặc bot HTTP cùng chạy, rất dễ mất kiểm soát: không biết agent nào đang làm gì, tốn bao nhiêu tiền, đang theo mục tiêu nào, có bị lặp vô hạn không.

Paperclip dành cho:

• Người hoặc team đang dùng nhiều AI agent để làm việc tự động.
• Developer có nhiều terminal Claude Code, Codex, Cursor chạy song song và muốn quản lý tập trung.
• Team muốn giao việc cho agent giống như dùng task manager.
• Người muốn agent chạy định kỳ, tự nhận việc, tự báo cáo, nhưng vẫn có kiểm soát của con người.
• Người muốn xây “công ty AI tự vận hành”, nơi mỗi agent có vai trò như CEO, CTO, engineer, designer, marketer.
• Team cần theo dõi chi phí token, đặt ngân sách và chặn agent khi vượt giới hạn.

Nói đơn giản: nếu một agent là “nhân viên”, thì Paperclip là “công ty” để quản lý các nhân viên đó.

⚙️ Hoạt động ra sao?

Cơ chế chính của Paperclip:

• Bạn tạo mục tiêu lớn
  Ví dụ: “Build the #1 AI note-taking app to $1M MRR.”

• Bạn tạo hoặc kết nối các agent
  Agent có thể là OpenClaw, Claude Code, Codex, Cursor, Bash, bot HTTP, hoặc agent tự viết.

• Bạn phân vai cho agent
  Mỗi agent có thể có chức danh, vai trò, người quản lý, quyền hạn và ngân sách riêng.

• Paperclip dùng org chart để điều phối
  org chart nghĩa là sơ đồ tổ chức: ai báo cáo cho ai, ai chịu trách nhiệm phần nào.

• Công việc được quản lý bằng ticket
  ticket là một đầu việc cụ thể. Mỗi ticket có lịch sử trao đổi, quyết định, file liên quan và trạng thái xử lý.

• Agent chạy theo heartbeat
  heartbeat có thể hiểu là “nhịp thức dậy”. Theo lịch, agent sẽ tỉnh dậy, kiểm tra việc cần làm, nhận task và hành động.

• Mỗi task đều gắn với mục tiêu lớn
  Agent không chỉ biết “làm gì”, mà còn biết “vì sao việc này quan trọng”.

• Paperclip theo dõi chi phí và ngân sách
  Bạn có thể đặt ngân sách theo tháng cho từng agent. Khi chạm giới hạn, agent sẽ dừng để tránh tốn tiền ngoài ý muốn.

• Có cơ chế duyệt và kiểm soát
  Bạn có thể duyệt việc tuyển agent, duyệt chiến lược, tạm dừng, ghi đè hoặc kết thúc agent bất cứ lúc nào.

• Trạng thái agent được lưu lại
  Nếu máy khởi động lại hoặc agent chạy lại sau một khoảng nghỉ, nó có thể tiếp tục từ ngữ cảnh cũ thay vì bắt đầu lại từ đầu.

🆚 Khi nào nên dùng / không nên

Nên dùng Paperclip khi:

• Bạn đang quản lý nhiều AI agent cùng lúc.
• Bạn muốn agent làm việc tự động nhưng vẫn có dashboard để kiểm tra.
• Bạn cần quản lý task, mục tiêu, chi phí, quyền hạn và lịch sử quyết định.
• Bạn muốn nhiều agent phối hợp như một team thật.
• Bạn có các việc lặp lại như báo cáo, chăm sóc khách hàng, marketing, kiểm tra code, viết tài liệu.
• Bạn muốn một hệ thống giống task manager nhưng dành riêng cho AI agent.

Không nên dùng Paperclip khi:

• Bạn chỉ dùng một AI assistant đơn giản để hỏi đáp hằng ngày.
• Bạn chỉ cần chạy một lệnh AI nhỏ, không cần theo dõi lâu dài.
• Bạn chưa có nhu cầu tự động hóa công việc bằng nhiều agent.
• Bạn không muốn tự host hoặc vận hành một Node.js server và React UI.
• Bạn cần một sản phẩm “bấm là dùng ngay” hoàn toàn, không cần cài đặt hay cấu hình.

So sánh ngắn:

• Nếu bạn chỉ cần chat với AI: dùng ChatGPT, Claude hoặc Gemini là đủ.
• Nếu bạn chỉ cần một coding agent: dùng Claude Code, Codex hoặc Cursor.
• Nếu bạn có nhiều agent và muốn quản lý chúng như một tổ chức: dùng paperclipai/paperclip.

🚀 Bắt đầu nhanh

Paperclip là một ứng dụng gồm Node.js server và React UI. Cách bắt đầu phổ biến là clone repo, cài dependency, cấu hình môi trường rồi chạy app ở máy local.

# 1. Clone repo
git clone https://github.com/paperclipai/paperclip.git
cd paperclip

# 2. Cài dependencies
npm install

# 3. Tạo file cấu hình môi trường
cp .env.example .env

# 4. Chạy ứng dụng ở chế độ development
npm run dev

Ví dụ luồng sử dụng tối thiểu sau khi app chạy:

1. Mở dashboard Paperclip trên trình duyệt.

2. Tạo một company:
   "AI Note Taking Company"

3. Đặt mục tiêu:
   "Build the #1 AI note-taking app to $1M MRR."

4. Thêm agent:
   - CEO agent
   - CTO agent
   - Engineer agent

5. Giao task:
   "Create the first version of the landing page."

6. Đặt ngân sách cho agent.

7. Nhấn run và theo dõi tiến độ trong dashboard.

Một ví dụ hình dung đơn giản:

Company Goal
└── Build the #1 AI note-taking app to $1M MRR
    ├── CEO agent: chia chiến lược
    ├── CTO agent: lập kế hoạch kỹ thuật
    └── Engineer agent: viết code cho task cụ thể

✅ Điểm mạnh & ⚠️ Hạn chế

✅ Điểm mạnh:

• Mã nguồn mở, có thể tự host và tùy biến.
• Quản lý được nhiều loại agent khác nhau: OpenClaw, Claude Code, Codex, Cursor, Bash, HTTP bot.
• Giao diện giống task manager nên dễ hình dung với người mới.
• Có org chart giúp agent có vai trò, cấp bậc và trách nhiệm rõ ràng.
• Có ticket system để lưu lịch sử công việc, trao đổi và quyết định.
• Có heartbeat giúp agent tự chạy theo lịch, phù hợp với công việc lặp lại.
• Có kiểm soát chi phí và ngân sách để tránh runaway cost.
• Có governance: duyệt, tạm dừng, ghi đè, hoặc kết thúc agent khi cần.
• Hỗ trợ nhiều company trong một deployment, dữ liệu được tách biệt.
• Agent có thể tiếp tục công việc với ngữ cảnh cũ thay vì mất hết sau khi restart.

⚠️ Hạn chế:

• Không phải công cụ cần thiết nếu bạn chỉ dùng một AI assistant đơn giản.
• Cần hiểu cơ bản về server, môi trường chạy và cấu hình để tự host.
• Khi dùng nhiều agent tự động, bạn vẫn cần giám sát để tránh kết quả sai hướng.
• Việc thiết kế mục tiêu, vai trò và ngân sách ban đầu cần suy nghĩ kỹ.
• Nếu agent bên ngoài như Claude Code, Codex, Cursor hoặc bot riêng gặp lỗi, Paperclip chỉ là lớp điều phối, không tự biến agent đó thành hoàn hảo.
• Dự án hướng đến workflow nhiều agent, nên có thể hơi “quá mạnh” cho các tác vụ nhỏ, làm một lần.