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ị.
Đ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.
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ả. Nó là mặt phẳng điều khiển cho một công ty tự chủ.
Đây là lý do tại sao framework công ty một người này lại quan trọng ngay lúc này.
Hầu hết các nhà sáng lập đơn độc sử dụng đại lý AI vào năm 2026 đang phải quản lý sự hỗn loạn. Hai mươi tab Claude Code đang mở. Không có hồ sơ về việc đại lý nào đã chạm vào tệp nào. Không giới hạn chi tiêu token. Không có cách nào để biết liệu đại lý đã hoàn thành nhiệm vụ hay đã tạo ra một kết quả ảo. Paperclip khắc phục tất cả những điều này bằng cách coi các đại lý theo cách mà một công ty thực sự đối xử với nhân viên:
- Sơ đồ tổ chức — các đại lý có vai trò, chức danh và người quản lý
- Vấn đề / nhiệm vụ — mọi phần công việc đều được theo dõi với trạng thái, độ ưu tiên và người được giao
- Mục tiêu — mọi nhiệm vụ đều bắt nguồn từ sứ mệnh của công ty để các đại lý luôn biết lý do
- Nhịp đập — các đại lý thức dậy theo lịch trình, kiểm tra hộp thư nhiệm vụ của họ, thực hiện công việc, báo cáo lại
- Ngân sách — giới hạn chi tiêu token hàng tháng cho mỗi đại lý; khi đạt đến giới hạn, họ sẽ dừng lại
- Quản trị — bạn phê duyệt việc tuyển dụng đại lý và các quyết định chiến lược lớn trước khi chúng được thực hiện
Đối với các nhóm sử dụng Apidog để định nghĩa và giả lập các API mà đại lý của họ gọi, Paperclip bổ sung lớp điều phối còn thiếu. Apidog cho đại lý biết hợp đồng API là gì. Paperclip cho đại lý biết công việc phải làm, khi nào làm và được phép chi tiêu 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 nổi bật trong việc thiết kế và kiểm thử API một cách độc lập. Nhưng thiết kế API chỉ là một tầng trong việc vận hành sản phẩm. Paperclip xử lý các quy trình xung quanh: phân rã mục tiêu, giao nhiệm vụ, theo dõi tiến độ, hiển thị chi phí và ghi nhật ký kiểm toán. Cùng nhau, Apidog + Paperclip cung cấp cho một nhà sáng lập đơn độc một hệ điều hành hoàn chỉnh cho một công ty phần mềm nơi con người định hướng và các đại lý AI thực thi.
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à nguyên thủy thực thi cốt lõi của Paperclip. Trong mỗi nhịp đập, một đại lý sẽ:
- Gọi
GET /api/agents/međể xác nhận danh tính của mình - Gọi
GET /api/companies/:id/issues?status=todo,in_progressđể đọc hộp thư nhiệm vụ của mình - Gọi
GET /api/issues/:idđể có toàn bộ ngữ cảnh bao gồm cây mục tiêu cha - Thực hiện công việc (viết mã, gọi API, tạo nội dung)
- Gọi
PATCH /api/issues/:idvới cập nhật trạng thái và một bình luận giải thích những gì nó đã làm
Đây là nơi tích hợp Apidog phát huy tác dụng. Nếu nhiệm vụ liên quan đến việc gọi một API bên ngoài — ví dụ, lấy dữ liệu khách hàng để tạo báo cáo hàng tuần — đại lý sẽ truy cập một máy chủ giả lập Apidog trong quá trình phát triển, sau đó chuyển sang điểm cuối trực tiếp trong sản xuất mà không cần thay đổi một dòng mã nào. Xác thực yêu cầu của Apidog sẽ phát hiện bất kỳ sự sai lệch nào trong hợp đồng API trước khi nó ngầm phá vỡ công việc của đại lý.
Sơ đồ tổ chức và hệ thống phân cấp mục tiêu Apidog là lớp API
Hệ thống phân cấp mục tiêu của Paperclip chảy từ công ty → nhóm → đại lý → nhiệm vụ. Một đại lý được giao nhiệm vụ luôn nhận được chuỗi tổ tiên của nó để một đại lý cấp dưới biết rằng nó đang viết một bài đăng blog như một phần của "tăng lưu lượng SEO" như một phần của "đạt 1 triệu đô la MRR". Ngữ cảnh này ngăn các đại lý tối ưu hóa cục bộ với chi phí của mục tiêu rộng lớn hơn.
Trong hệ thống phân cấp này, Apidog đóng vai trò là lớp đặc tả API. Bạn định nghĩa các dịch vụ nội bộ của mình trong Apidog, xuất bản các máy chủ giả lập cho từng dịch vụ và các đại lý tham chiếu các điểm cuối Apidog đó trong mô tả nhiệm vụ của họ. Khi API thay đổi, bạn cập nhật đặc tả Apidog, tạo lại bản giả lập và mọi đại lý hạ nguồn sẽ tự động nhận được 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 quy trình làm việc Apidog của bạn
Mọi đại lý trong Paperclip đều có trường budgetMonthlyCents. Khi spentMonthlyCents của đại lý đạt đến giới hạn đó, nó sẽ ngừng chấp nhận nhiệm vụ. Không có ghi đè, không có ngoại lệ. Đối với một công ty một người hoạt động tinh gọn, đây là tính năng giúp mọi thứ còn lại khả thi — bạn có thể cấp cho một đại lý ngân sách 20 đô la/tháng và biết chắc chắn rằng nó sẽ không bao giờ vượt quá.
Khi bạn kết hợp điều này với các máy chủ giả lập của Apidog, bạn có thể chạy toàn bộ một sprint công việc của đại lý chống lại các bản giả lập (không tốn token) trước khi chuyển sang các nhà cung cấp AI trực tiếp. Tạo mẫu là miễn phí; sản xuất có ngân sách.
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 chỉ cần một lệnh duy nhất:
npx paperclipai onboard --yes
Lệnh này khởi động một cơ sở dữ liệu PostgreSQL nhúng, tạo khóa mã hóa chính, áp dụng tất cả các di chuyển cơ sở dữ liệu và khởi động máy chủ trên http://localhost:3100. Không yêu cầu Docker, không cần dịch vụ bên ngoài.
Sau khi chạy, hãy mở giao diện người dùng, tạo một công ty và định nghĩa mục tiêu đầu tiên của bạn:
"Build the #1 AI-powered API monitoring tool to $1M MRR."
Sau đó tạo đại lý đầu tiên của bạn — ví dụ, một đại lý "Kỹ sư Backend" sử dụng bộ điều hợp claude_local:
{
"adapterType": "claude_local",
"adapterConfig": {
"model": "claude-opus-4-6",
"maxTokens": 4096
},
"budgetMonthlyCents": 2000
}
Chỉ định các nhiệm vụ của đại lý đến máy chủ giả lập Apidog của bạn. Trong mô tả nhiệm vụ, hãy tham chiếu URL bộ sưu tập Apidog để đại lý có toàn bộ hợp đồng API dưới dạng ngữ cảnh.
Kết nối Apidog Mocks với Nhiệm vụ của Đại lý
Trong Paperclip, mô tả nhiệm vụ là markdown phong phú với đầy đủ ngữ cảnh tổ tiên. Bạn có thể nhúng URL cơ sở giả lập Apidog của mình trực tiếp:
## 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ý đọc điều này, gọi bản giả lập Apidog để xác minh hình dạng phản hồi hiện tại, viết triển khai và báo cáo lại với một bình luận.
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
CLI của Paperclip cung cấp cho bạn toàn quyền kiểm soát vòng đời nhiệm vụ mà không cần mở giao diện người dùng:
# Tạo một nhiệm vụ cho một đại lý để triển khai một điểm cuối mới được định nghĩa bởi 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 một nhiệm vụ nếu một đại lý bị kẹt
pnpm paperclipai issue release <issue-id>
Mỗi thay đổi trạng thái được ghi lại trong nhật ký hoạt động bất biến để bạn luôn biết chính xác đại lý nào đã thực hiện nhiệm vụ và những gì nó đã nói.
Quản trị và Phê duyệt trong Khung công ty một người tích hợp Apidog
Mô hình quản trị của Paperclip đặt bạn vào vai trò của hội đồng quản trị. Trước khi bất kỳ đại lý nào được thuê hoặc bất kỳ chiến lược lớn nào được phê duyệt, Paperclip có thể yêu cầu sự chấp thuận rõ ràng của bạn:
# Xem xét các phê duyệt đang chờ xử lý
pnpm paperclipai approval list --company-id <id>
# Phê duyệt việc tuyển dụng đại lý mới
pnpm paperclipai approval approve <approval-id> \
--decision-note "Approved. Use Apidog mock for first sprint."
Điều này giữ cho khung công ty một người không trở thành một thảm họa tự chủ. Đại lý đề xuất; bạn quyết định.
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 đi kèm với một bộ kiểm thử đơn vị đầy đủ được cung cấp bởi Vitest và các bài kiểm thử đầu cuối được cung cấp bởi Playwright. Việc chạy chúng rất đơn giản:
# Chạy tất cả các bài kiểm thử đơn vị
pnpm test:run
# Chạy các bài kiểm thử đầu cuối
pnpm test:e2e
# Kiểm tra tình trạng — xác minh máy chủ và bản giả lập Apidog có thể truy cập được
curl http://localhost:3100/api/health
Bộ kiểm thử đơn vị bao gồm logic kinh doanh cốt lõi: chuyển đổi trạng thái vấn đề, thực thi ngân sách, vòng đời chạy nhịp đập và xác thực đại lý. Khi bạn thêm một bộ điều hợp tùy chỉnh để kết nối một nhà cung cấp AI mới, việc chạy bộ kiểm thử đơn vị sẽ xác nhận hành vi điều phối hiện có không thay đổi.
Trong một khung công ty một người, điều này quan trọng hơn so với một nhóm truyền thống. Bạn không có người đánh giá mã. Bộ kiểm thử đơn vị và các bài kiểm thử hợp đồng Apidog của bạn là lưới an toàn của bạn.
Ngăn xếp chất lượng ba lớp: Paperclip + Apidog + Kiểm thử đơn vị
Một mô hình chất lượng thực tế dành cho các nhà sáng lập đơn độc:
- Apidog định nghĩa hợp đồng API và chạy các bài kiểm thử hợp đồng tự động trên mỗi lần đẩy
- Các vấn đề của Paperclip chứa các tiêu chí chấp nhận tham chiếu đến đặc tả Apidog
- Kiểm thử đơn vị (Vitest) xác thực rằng triển khai phù hợp với cả hai
Cách tiếp cận ba lớp này có nghĩa là một nhà sáng lập đơn độc nhận được sự đảm bảo chất lượng tương tự như một đội ngũ năm người có được từ việc đánh giá ngang hàng mà không cần các cuộc họp.
Kết luận
Paperclip là framework công ty một người mã nguồn mở biến một nhà sáng lập đơn độc thành một công ty. Nó mang đến 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à một nhật ký kiểm toán đầy đủ cho việc quản lý đại lý AI — tất cả đều tự lưu trữ, tất cả đều mã nguồn mở, tất cả là của bạn.
Đối với các nhà phát triển đã sử dụng Apidog để thiết kế và kiểm thử API, việc bổ sung Paperclip hoàn thiện ngăn xếp. Apidog xử lý những gì API thực hiện. Paperclip xử lý ai gọi nó, khi nào, tại sao và với chi phí bao nhiêu. Cùng nhau, chúng tạo thành một framework công ty một người đạt cấp độ sản xuất ngay từ ngày đầu: các máy chủ giả lập Apidog của bạn cung cấp sức mạnh cho việc phát triển đại lý, các bài kiểm thử hợp đồng Apidog của bạn xác thực đầu ra của đại lý và lớp quản trị của Paperclip đảm bảo không đại lý nào thực hiện hành động mà bạn chưa phê duyệt.
Bắt đầu:
- Khởi động cục bộ:
npx paperclipai onboard --yes - Mở giao diện người dùng tại
http://localhost:3100, tạo một công ty và định nghĩa mục tiêu đầu tiên của bạn - Thêm một đại lý với ngân sách
20 đô la/thángvà chỉ nó đến máy chủ giả lập Apidog của bạn - Chạy
pnpm test:runđể xác minh bộ kiểm thử đơn vị đã vượt qua trước nhịp đập sản xuất đầu tiên của bạn - Phê duyệt nhiệm vụ đầu tiên, xem đại lý làm việc, xem lại nhật ký kiểm toán
Công ty một người không còn là một phép ẩn dụ. Với Paperclip và Apidog, nó là một kiến trúc.
Câu hỏi thường gặp
Paperclip là gì? Paperclip là một framework công ty một người mã nguồn mở — một máy chủ Node.js và giao diện người dùng React giúp điều phối các đại lý AI với sơ đồ tổ chức, ngân sách, lập lịch nhịp đập và quản trị. Nó là mặt phẳng điều khiển để điều hành một công ty phần mềm bằng các đại lý AI 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 các hợp đồng API mà các đại lý của bạn làm việc dựa trên. Bạn nhúng URL giả lập Apidog vào mô tả nhiệm vụ của Paperclip, các đại lý gọi các bản giả lập đó trong quá trình phát triển, và các bài kiểm thử hợp đồng của Apidog xác thực việc triển khai cuối cùng. Paperclip xử lý việc điều phối; Apidog xử lý đặc tả API.
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) không yêu cầu cơ sở hạ tầng. Giới hạn ngân sách ngăn chặn chi phí vượt tầm kiểm soát. Hệ thống nhịp đập xử lý công việc định kỳ tự động. Tích hợp Tailscale cho phép bạn quản lý các đại lý của mình từ điện thoại. Nó có thể mở rộng từ cục bộ lên đám mây với cùng một cấu hình.
Làm thế nào để chạy các bài kiểm thử đơn vị? Chạy pnpm test:run cho bộ kiểm thử đơn vị Vitest, hoặc pnpm test:e2e cho các bài kiểm thử đầu cuối Playwright. Một kiểm tra tình trạng đối với http://localhost:3100/api/health xác nhận máy chủ đang chạy chính xác trước khi kiểm thử.
Paperclip hỗ trợ những đại lý AI nào? Paperclip hỗ trợ Claude (cục bộ và thông qua OpenClaw), Codex, Cursor, Gemini, OpenCode và bất kỳ đại lý nào giao tiếp qua HTTP hoặc chạy như một quy trình cục bộ. Hệ thống bộ điều hợp là mã nguồn mở — nếu đại lý của bạn có thể nhận nhịp đập, nó có thể được thuê.
Paperclip có phải là mã nguồn mở không? Có. Paperclip được cấp phép MIT và được duy trì tích cực tại github.com/paperclipai/paperclip. SDK plugin, các gói bộ điều hợp và định nghĩa kỹ năng đều được xuất bản dưới dạng các gói NPM có phạm vi dưới @paperclipai/*.