Sebastian Petrus

Posted on Mar 18 • Originally published at apidog.com

Paperclip: Cách Vận Hành Công Ty Một Người Với Framework Mã Nguồn Mở Này

Paperclip là một framework công ty một người mã nguồn mở giúp điều phối các đại lý AI như nhân viên: sơ đồ tổ chức, ngân sách, lập lịch nhịp đập, phê duyệt quản trị và nhật ký kiểm toán đầy đủ. Chỉ một lệnh là có thể chạy nó cục bộ. Các đại lý của bạn thực hiện công việc; bạn điều hành cuộc họp hội đồng quản trị.

Dùng thử Apidog ngay hôm nay

Điều hành một công ty một người vào năm 2026 không còn có nghĩa là bạn phải tự làm mọi thứ mà là chỉ đạo một đội ngũ đại lý AI thực hiện công việc trong khi bạn tập trung vào chiến lược. Paperclip là framework công ty một người mã nguồn mở được xây dựng để biến điều đó thành hiện thực. Nó cung cấp cho các nhà sáng lập đơn độc một sơ đồ tổ chức, một hệ thống ngân sách, một lớp quản trị và một công cụ theo dõi nhiệm vụ cho các đại lý AI của họ, tất cả trong một bảng điều khiển tự lưu trữ. Nếu bạn cũng sử dụng Apidog để thiết kế, giả lập và kiểm thử các API mà các đại lý của bạn tương tác, Paperclip hoàn thiện ngăn xếp: Apidog sở hữu hợp đồng API, Paperclip sở hữu các đại lý gọi API đó. Hướng dẫn này sẽ trình bày chính xác cách Paperclip hoạt động và cách tích hợp nó vào một hoạt động kinh doanh một người bắt đầu từ hôm nay.

💡Tải Apidog (miễn phí) trước nhịp đập Paperclip đầu tiên của bạn. Nhúng URL giả lập vào mô tả nhiệm vụ để các đại lý xây dựng dựa trên các hợp đồng hoàn hảo — không tốn chi phí, không bất ngờ. Chuyển sang API trực tiếp sau đó với các bài kiểm thử Apidog phát hiện bất kỳ sự sai lệch nào trước khi ngân sách bị đốt cháy.

Paperclip là gì và tại sao Khung công ty một người lại quan trọng đối với người dùng Apidog?

Khẩu hiệu của Paperclip nói thẳng: "Nếu OpenClaw là một nhân viên, Paperclip là công ty."

Paperclip là một máy chủ Node.js và giao diện người dùng React biến tập hợp các đại lý AI của bạn thành một tổ chức có cấu trúc với chức danh, tuyến báo cáo, ngân sách hàng tháng và mục tiêu chiến lược. Nó không phải là một chatbot, một trình quản lý lời nhắc hay một công cụ xây dựng quy trình làm việc kéo thả. Đây là mặt phẳng điều khiển cho một công ty tự chủ.

Lý do framework công ty một người này lại quan trọng:

Hầu hết các nhà sáng lập đơn độc sử dụng đại lý AI vào năm 2026 phải tự xử lý sự hỗn loạn: nhiều tab Claude Code, không kiểm soát chi tiêu token, không tracking nhiệm vụ, không audit log.
Paperclip giải quyết bằng cách coi đại lý AI như nhân viên thực sự:
- Sơ đồ tổ chức: vai trò, chức danh, người quản lý
- Nhiệm vụ: trạng thái, độ ưu tiên, người được giao
- Mục tiêu: liên kết nhiệm vụ với chiến lược công ty
- Nhịp đập: đại lý chạy định kỳ, xử lý task, báo cáo tự động
- Ngân sách: giới hạn chi tiêu token/đại lý
- Quản trị: mọi quyết định lớn đều cần phê duyệt

Khi dùng Apidog để định nghĩa và giả lập API, Paperclip bổ sung lớp orchestrator còn thiếu: Apidog định nghĩa hợp đồng API. Paperclip quản lý ai làm việc gì, khi nào, ngân sách bao nhiêu.

Tại sao các nhà sáng lập đơn độc chọn khung công ty một người này thay vì chỉ sử dụng Apidog

Apidog rất mạnh trong thiết kế, kiểm thử API. Nhưng để vận hành một sản phẩm, bạn cần nhiều hơn: phân rã mục tiêu, giao nhiệm vụ, tracking cost, audit log,... Paperclip đảm nhiệm những quy trình này. Kết hợp Apidog + Paperclip, bạn có một hệ điều hành cho công ty phần mềm một người: con người định hướng, AI tác nghiệp.

Các tính năng cốt lõi của Khung công ty một người của Paperclip và vị trí của Apidog

Nhịp đập: Vòng lặp kích hoạt đại lý tương thích Apidog

Nhịp đập là cơ chế thực thi cốt lõi trong Paperclip. Một chu kỳ nhịp đập thường gồm:

Gọi GET /api/agents/me xác nhận danh tính
Gọi GET /api/companies/:id/issues?status=todo,in_progress lấy danh sách nhiệm vụ
Gọi GET /api/issues/:id lấy toàn bộ ngữ cảnh và cây mục tiêu cha
Thực hiện công việc (code, gọi API, tạo nội dung)
Gọi PATCH /api/issues/:id cập nhật trạng thái và bình luận giải thích

Tích hợp Apidog:

Nếu nhiệm vụ cần gọi API bên ngoài, đại lý sẽ gọi tới server giả lập Apidog lúc phát triển, sau đó chuyển sang endpoint thật khi production mà không thay đổi code. Apidog sẽ xác thực request, phát hiện mọi sai lệch trước khi sản xuất.

Sơ đồ tổ chức và hệ thống phân cấp mục tiêu – Apidog là lớp API

Mô hình mục tiêu Paperclip: công ty → nhóm → đại lý → nhiệm vụ. Đại lý luôn nhận được ngữ cảnh tổ tiên (VD: Viết blog → tăng SEO → đạt $1M MRR) để không tối ưu cục bộ.

Apidog đóng vai trò lớp đặc tả API:

Định nghĩa dịch vụ nội bộ trong Apidog, xuất bản mock server, đại lý tham chiếu endpoint này trong task description.
Khi API thay đổi, chỉ cần cập nhật spec Apidog, regenerate mock, đại lý tự nhận hợp đồng mới.

Thực thi ngân sách – Ngăn chặn chi tiêu vượt tầm kiểm soát trong workflow Apidog của bạn

Mỗi đại lý Paperclip có budgetMonthlyCents. Khi spentMonthlyCents chạm ngưỡng, đại lý dừng nhận nhiệm vụ. Không có ngoại lệ.

Kết hợp với mock server Apidog, bạn có thể chạy cả sprint mà không tốn token, chỉ tiêu tiền khi chuyển sang production thực.

Thiết lập Paperclip làm Khung công ty một người của bạn với Apidog {#setup}

Khởi động cục bộ không cần cấu hình – Apidog kết nối ngay lập tức

Chạy Paperclip với một lệnh:

npx paperclipai onboard --yes

Tự động khởi động PostgreSQL nhúng, tạo khóa mã hóa, migrate DB, chạy server tại http://localhost:3100
Không cần Docker hay dịch vụ ngoài

Sau đó, mở UI Paperclip, tạo công ty và định nghĩa mục tiêu đầu tiên:

Build the #1 AI-powered API monitoring tool to $1M MRR.

Tạo đại lý đầu tiên, ví dụ "Kỹ sư Backend" dùng adapter claude_local:

{
  "adapterType": "claude_local",
  "adapterConfig": {
    "model": "claude-opus-4-6",
    "maxTokens": 4096
  },
  "budgetMonthlyCents": 2000
}

Chỉ định nhiệm vụ đến mock server Apidog bằng cách tham chiếu URL bộ sưu tập Apidog vào mô tả nhiệm vụ.

Kết nối Apidog Mock với Nhiệm vụ của Đại lý

Mô tả nhiệm vụ trong Paperclip hỗ trợ markdown giàu ngữ cảnh. Nhúng trực tiếp URL mock Apidog:

## Nhiệm vụ: Thêm phân trang vào điểm cuối /users

**Apidog Mock Base:** http://localhost:4523/m1/123456/users
**Tiêu chí chấp nhận:**
- Điểm cuối chấp nhận tham số truy vấn `page` và `limit`
- Trả về envelope `{ data: [], total: 0, page: 1 }`
- Phạm vi kiểm thử đơn vị cho các trường hợp biên (page=0, limit>100)

Đại lý sẽ đọc, gọi mock Apidog để xác minh, viết code, báo cáo kết quả.

Chạy Đại lý, Nhiệm vụ và Nhịp đập trong Khung công ty một người Paperclip với Apidog

Quản lý vấn đề thông qua quy trình Paperclip Apidog

Quản lý vòng đời nhiệm vụ bằng CLI, không cần UI:

# Tạo nhiệm vụ mới cho đại lý, gắn với spec Apidog
pnpm paperclipai issue create \
  --company-id <id> \
  --title "Implement POST /webhooks endpoint per Apidog spec" \
  --description "See Apidog collection: http://localhost:4523/..."

# Kiểm tra trạng thái nhiệm vụ
pnpm paperclipai issue list --company-id <id> --status in_progress

# Giải phóng nhiệm vụ nếu đại lý bị kẹt
pnpm paperclipai issue release <issue-id>

Mọi thay đổi trạng thái đều được ghi lại vào audit log.

Quản trị và Phê duyệt trong Khung công ty một người tích hợp Apidog

Paperclip buộc mọi quyết định lớn phải được phê duyệt qua CLI:

# Xem xét các phê duyệt đang chờ
pnpm paperclipai approval list --company-id <id>

# Phê duyệt tuyển dụng đại lý mới
pnpm paperclipai approval approve <approval-id> \
  --decision-note "Approved. Use Apidog mock for first sprint."

Bạn là hội đồng quản trị. Đại lý đề xuất, bạn duyệt.

Kiểm thử, Quản trị và Kiểm soát chi phí trong ngăn xếp Khung công ty một người Paperclip + Apidog của bạn

Chạy Bộ kiểm thử đơn vị Paperclip Apidog

Paperclip tích hợp sẵn test suite (Vitest cho unit, Playwright cho end-to-end):

# Chạy unit test
pnpm test:run

# Chạy end-to-end test
pnpm test:e2e

# Kiểm tra tình trạng server và mock Apidog
curl http://localhost:3100/api/health

Test suite này kiểm tra logic chuyển trạng thái issue, thực thi ngân sách, vòng đời nhịp đập, xác thực agent. Khi thêm adapter mới, chỉ cần chạy lại test để đảm bảo orchestrator không sai lệch.

Lưu ý: Đối với công ty một người, test suite và kiểm thử hợp đồng Apidog là lưới an toàn thay cho review code truyền thống.

Ngăn xếp chất lượng ba lớp: Paperclip + Apidog + Kiểm thử đơn vị

Mô hình chất lượng thực chiến cho solo founder:

Apidog: định nghĩa hợp đồng API, kiểm thử hợp đồng tự động mỗi lần push
Paperclip: nhiệm vụ chứa tiêu chí chấp nhận có liên kết Apidog spec
Unit test (Vitest): xác thực code đúng hợp đồng và logic nghiệp vụ

Cách này đảm bảo solo founder có chất lượng như một team 5 người nhưng không cần meeting.

Kết luận

Paperclip là framework công ty một người mã nguồn mở, mang lại sơ đồ tổ chức, kiểm soát ngân sách, quản trị, căn chỉnh mục tiêu, lập lịch nhịp đập và audit log đầy đủ cho việc quản lý đại lý AI – tất cả tự lưu trữ, mã nguồn mở, bạn toàn quyền kiểm soát.

Kết hợp với Apidog để thiết kế và kiểm thử API, Paperclip hoàn thiện ngăn xếp: Apidog xử lý hợp đồng API, Paperclip điều phối ai gọi khi nào, vì sao, chi phí bao nhiêu. Cùng nhau, chúng tạo framework company-of-one đạt chuẩn production ngay từ ngày đầu:

Mock server Apidog hỗ trợ phát triển agent
Contract test Apidog xác thực output
Lớp quản trị Paperclip đảm bảo mọi hành động đều được phê duyệt

Bắt đầu ngay:

Chạy cục bộ: npx paperclipai onboard --yes
Mở UI tại http://localhost:3100, tạo công ty, định nghĩa mục tiêu đầu tiên
Thêm đại lý với ngân sách 20 đô/tháng, chỉ định tới mock server Apidog
Chạy pnpm test:run xác minh unit test trước khi production
Phê duyệt, xem agent làm việc, kiểm tra audit log

Company-of-one không còn là ẩn dụ. Với Paperclip và Apidog, đó là một kiến trúc thực thi được.

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

Paperclip là gì?

Paperclip là framework công ty một người mã nguồn mở — một máy chủ Node.js và UI React giúp điều phối đại lý AI với sơ đồ tổ chức, ngân sách, nhịp đập và quản trị. Đây là mặt phẳng điều khiển để điều hành một công ty phần mềm với AI agent thay vì nhân viên con người.

Paperclip tích hợp với Apidog như thế nào?

Apidog định nghĩa hợp đồng API cho các đại lý. Bạn nhúng URL mock Apidog vào mô tả nhiệm vụ của Paperclip, đại lý gọi mock đó khi phát triển, kiểm thử hợp đồng Apidog xác thực kết quả. Paperclip điều phối, Apidog xử lý API spec.

Paperclip có phù hợp với một công ty một người thực sự không?

Có. Thiết lập cục bộ không cần cấu hình (npx paperclipai onboard --yes). Giới hạn ngân sách ngăn chi phí vượt tầm kiểm soát. Nhịp đập xử lý công việc định kỳ tự động. Tích hợp Tailscale để quản lý agent từ điện thoại. Có thể mở rộng lên cloud mà không đổi config.

Làm thế nào để chạy các bài kiểm thử đơn vị?

Chạy pnpm test:run cho unit test (Vitest), pnpm test:e2e cho end-to-end test (Playwright). Kiểm tra http://localhost:3100/api/health trước khi test.

Paperclip hỗ trợ những đại lý AI nào?

Paperclip hỗ trợ Claude (cục bộ và qua OpenClaw), Codex, Cursor, Gemini, OpenCode, và bất kỳ agent nào qua HTTP hoặc process cục bộ. Adapter system là OSS — miễn là agent của bạn nhận được nhịp đập, nó có thể chạy.

Paperclip có phải là mã nguồn mở không?

Có. MIT license, phát triển tại github.com/paperclipai/paperclip. SDK plugin, adapter, skill definition đều là các gói NPM dưới scope @paperclipai/*.

DEV Community