Paperclip: Khi Bạn Là CEO Của Công Ty Không Có Nhân Viên - Chỉ Có AI Agents

Paperclip Là Gì? Từ Chatbot Đến Công Ty

Định Nghĩa

Paperclip là một Node.js server và React UI cho phép bạn điều phối một đội ngũ AI agents để điều hành một doanh nghiệp. Nếu OpenClaw là một nhân viên, thì Paperclip là công ty tuyển dụng họ.

Triết lý thiết kế: "Quản lý mục tiêu kinh doanh, không phải pull requests. Bạn là hội đồng quản trị, không phải người quản lý hàng ngày."

Sự Khác Biệt Cốt Lõi

Hầu hết các công cụ AI đều tập trung vào việc làm cho một agent thông minh hơn. Paperclip tập trung vào việc làm cho nhiều agents làm việc cùng nhau hiệu quả hơn.

Thông Số Kỹ Thuật

Tech Stack

• Backend: Node.js 20+

• Frontend: React (dashboard UI)

• Database: PostgreSQL (embedded hoặc external)

• Package manager: pnpm 9.15+

• License: MIT (open-source)

• Deployment: Self-hosted (local, VPS, hoặc cloud)

• API: REST API tại localhost:3100

• Mobile: Responsive web UI (không cần app riêng)

Agents Được Hỗ Trợ

• OpenClaw: Autonomous agent framework (Python)

• Claude Code: Anthropic's coding agent

• Codex: OpenAI's code generation

• Cursor: AI-powered code editor

• Bash scripts: Custom automation

• HTTP agents: Bất kỳ agent nào có HTTP endpoint

Quan trọng: Paperclip không tạo ra agents. Nó điều phối các agents bạn đã có. Bring Your Own Agent (BYOA).

Tính Năng Cốt Lõi: 9 Điều Làm Paperclip Khác Biệt

1. Org Chart Cho AI Agents

Bạn định nghĩa roles, reporting lines, và responsibilities giống như một công ty thật. Mỗi agent biết scope của mình và báo cáo cho ai.

Ví dụ org chart:

CEO (Claude Opus)
├── CTO (GPT-4)
│   ├── Senior Engineer (Claude Sonnet)
│   ├── Junior Engineer (GPT-4o-mini)
│   └── DevOps (Bash scripts)
├── CMO (Claude Sonnet)
│   ├── Content Writer (GPT-4)
│   ├── SEO Specialist (Claude Haiku)
│   └── Social Media Manager (GPT-4o-mini)
└── CFO (Claude Haiku)
    └── Accountant (Bash scripts)

2. Budget Enforcement

Đặt giới hạn chi tiêu hàng tháng cho từng agent hoặc department. Paperclip tự động throttle agents khi gần đạt limit, ngăn chặn chi phí vượt kiểm soát.

Ví dụ budget:

• CEO: $200/tháng (strategic decisions, ít calls)

• Engineers: $500/tháng mỗi người (nhiều code generation)

• Content Writer: $300/tháng (nhiều text generation)

• Tổng budget công ty: $2,000/tháng

Khi một agent đạt 80% budget, Paperclip gửi warning. Khi đạt 100%, agent tự động dừng cho đến tháng sau.

3. Goal Alignment

Mọi task đều trace back về company mission. Agents không bao giờ lạc hướng vào busywork vì hệ thống enforce rằng mọi công việc đều kết nối với mục tiêu đã định.

Hierarchy:

Company Mission: "Build the #1 AI note-taking app to $1M MRR"
└── Project: "Launch MVP in 3 months"
    ├── Task: "Design database schema"
    ├── Task: "Build REST API"
    ├── Task: "Create React frontend"
    └── Task: "Write marketing copy"

Mỗi task đều biết "why" - không chỉ "what".

4. Heartbeat Scheduling

Agents check in theo intervals đều đặn, báo cáo status, và nhận tasks mới. Tạo ra nhịp điệu giống daily standups trong team người.

Ví dụ heartbeat:

• CEO: Mỗi 24 giờ (review strategy, adjust priorities)

• Engineers: Mỗi 4 giờ (check tasks, commit code)

• Content Writer: Mỗi 8 giờ (publish posts, check analytics)

• DevOps: Mỗi 1 giờ (monitor systems, handle alerts)

5. Ticket System Với Audit Trail

Mọi conversation được trace. Mọi quyết định được giải thích. Full tool-call tracing và immutable audit log.

Ví dụ audit log:

[2026-03-15 09:23:14] CEO Agent: Created project "Launch MVP"
[2026-03-15 09:23:45] CEO Agent: Assigned task "Design DB" to CTO
[2026-03-15 10:15:22] CTO Agent: Delegated to Senior Engineer
[2026-03-15 11:42:18] Senior Engineer: Completed schema design
[2026-03-15 11:42:19] Senior Engineer: Used 12,400 tokens ($0.18)
[2026-03-15 11:42:20] CTO Agent: Approved schema, moved to next task

6. Atomic Execution

Task checkout và budget enforcement là atomic, nên không có double-work và không có runaway spend. Nếu một agent bắt đầu một task, không agent nào khác có thể làm task đó cho đến khi hoàn thành hoặc release.

7. Persistent Agent State

Agents resume cùng task context qua các heartbeats thay vì restart từ đầu. Điều này quan trọng cho long-running tasks.

8. Multi-Company Support

Một deployment duy nhất có thể chạy nhiều companies với data isolation hoàn toàn. Perfect cho agencies hoặc founders chạy nhiều ventures.

Use case:

• Company A: SaaS startup (5 agents, $1,500/tháng budget)

• Company B: Content agency (8 agents, $800/tháng budget)

• Company C: E-commerce store (4 agents, $600/tháng budget)

Tất cả chạy trên cùng một Paperclip instance, nhưng data hoàn toàn tách biệt.

9. Governance Với Rollback

Approval gates được enforce, config changes được version, và bad changes có thể rollback safely.

Ví dụ governance rules:

• Mọi email gửi cho khách hàng phải được CEO approve

• Mọi deploy lên production phải được CTO approve

• Mọi chi tiêu trên $50 phải được CFO approve

• Mọi thay đổi org chart phải được founder approve

So Sánh: Paperclip vs OpenClaw - Hai Công Cụ Bổ Sung Nhau

Hiểu Đúng Mối Quan Hệ

Đây không phải là cuộc cạnh tranh. Paperclip và OpenClaw giải quyết hai vấn đề hoàn toàn khác nhau và được thiết kế để hoạt động cùng nhau.

Khi Nào Dùng Gì?

Dùng OpenClaw khi:

• Bạn cần một agent tự động, proactive

• Bạn muốn agent sống trong messaging apps

• Bạn là solo founder hoặc team nhỏ (1-3 người)

• Bạn cần persistent memory và identity

• Bạn muốn agent tự quyết định việc cần làm

Dùng Paperclip khi:

• Bạn có 5+ agents cần phối hợp

• Bạn cần budget control nghiêm ngặt

• Bạn cần governance và approval workflows

• Bạn chạy nhiều companies/projects

• Bạn cần audit trail đầy đủ

Dùng cả hai khi:

• Bạn muốn OpenClaw agents hoạt động trong Paperclip org chart

• Bạn cần autonomy của OpenClaw + coordination của Paperclip

• Bạn đang scale từ 1 agent lên 10+ agents

Case Study: Felix - Công Ty $200K Không Có Nhân Viên

Câu Chuyện

Nat Eliason, một writer và entrepreneur, đã tạo ra Felix - một "one-person company" với mục tiêu $1 triệu doanh thu chỉ sử dụng AI agents. Felix được xây dựng trên OpenClaw framework và đã đạt gần $200,000 doanh thu chỉ trong vài tuần đầu năm 2026.

Cấu Trúc Felix

Dòng doanh thu:

• PDF sales: Bán guides và tutorials về OpenClaw

• Claw Mart: Marketplace cho OpenClaw skills

• Clawcommerce: Custom services - deploy OpenClaw cho businesses

Agents trong Felix:

• Content Agent: Viết blog posts, tutorials, documentation

• Marketing Agent: Social media, email campaigns, SEO

• Sales Agent: Lead research, outreach, follow-ups

• Support Agent: Customer support qua Discord và email

• Dev Agent: Maintain Claw Mart, fix bugs, add features

Kết Quả Sau 6 Tuần

• Doanh thu: ~$200,000 (đang hướng tới $1M)

• Chi phí API: ~$800/tháng (chủ yếu là Claude và GPT-4)

• Thời gian làm việc của Nat: 5-10 giờ/tuần (chủ yếu là strategic decisions)

• Agents hoạt động: 24/7 không nghỉ

• Customers: 2,400+ (PDF + Claw Mart + services)

• Support tickets: 95% được AI xử lý tự động

Bài Học Từ Felix

1. Mistakes compound nhanh hơn với agents:

Một lần Felix gửi 23 emails thay vì 3 vì bug trong logic. Với người, họ sẽ nhận ra sau email thứ 2-3. Với AI, nó gửi hết 23 emails trước khi ai phát hiện. Budget controls và human checkpoints là bắt buộc.

2. ROI đến sau tháng thứ 2-3, không phải tuần đầu:

Setup AI agent workflows tốn thời gian và iteration. Payoff đến khi agents đã học được patterns và processes. Businesses mong đợi kết quả ngay sẽ thất vọng.

3. Human oversight không bao giờ biến mất:

Ngay cả trong "zero-human company", luôn có một human setting strategy, reviewing outcomes, và making judgment calls. Human role chuyển từ "doing the work" sang "governing the system".

Hướng Dẫn Setup Paperclip: Từ Zero Đến Company Trong 30 Phút

Bước 1: Cài Đặt Nhanh (5 phút)

Cách 1: Onboard tự động (khuyến nghị):

npx paperclipai onboard --yes

Lệnh này sẽ:

• Clone repo từ GitHub

• Cài đặt dependencies

• Tạo embedded PostgreSQL database

• Start API server tại localhost:3100

• Mở browser với dashboard UI

Cách 2: Manual setup:

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

Requirements:

• Node.js 20+

• pnpm 9.15+

• 8GB RAM (khuyến nghị 16GB)

• 5GB disk space

Bước 2: Tạo Company Đầu Tiên (10 phút)

1. Truy cập dashboard:

http://localhost:3100

2. Tạo company:

Company Name: "MyStartup"
Mission: "Build the #1 AI note-taking app to $1M MRR"
Monthly Budget: $2,000

3. Hire agents (tạo org chart):

# CEO
Role: CEO
Agent Type: Claude Opus
Monthly Budget: $200
Responsibilities: Strategy, goal decomposition, priority setting

# CTO
Role: CTO
Agent Type: GPT-4
Reports To: CEO
Monthly Budget: $500
Responsibilities: Technical architecture, code review, DevOps

# Senior Engineer
Role: Senior Engineer
Agent Type: Claude Sonnet
Reports To: CTO
Monthly Budget: $400
Responsibilities: Feature development, API design, database

# Content Writer
Role: Content Writer
Agent Type: GPT-4
Reports To: CEO
Monthly Budget: $300
Responsibilities: Blog posts, documentation, marketing copy

Bước 3: Cấu Hình API Keys (5 phút)

Trong dashboard, vào Settings → API Keys:

# Anthropic (cho Claude agents)
ANTHROPIC_API_KEY=sk-ant-xxxxx

# OpenAI (cho GPT agents)
OPENAI_API_KEY=sk-xxxxx

# Optional: Gemini, DeepSeek, Ollama
GOOGLE_API_KEY=xxxxx
DEEPSEEK_API_KEY=xxxxx

Bước 4: Tạo Project Đầu Tiên (10 phút)

1. Tạo project:

Project Name: "MVP Launch"
Goal: "Launch working note-taking app in 3 months"
Owner: CEO Agent
Budget: $1,500
Deadline: 2026-06-15

2. CEO agent tự động decompose thành tasks:

Sau khi tạo project, CEO agent sẽ tự động phân tích và tạo tasks:

• Design database schema (assign to CTO)

• Build REST API (assign to Senior Engineer)

• Create React frontend (assign to Senior Engineer)

• Write documentation (assign to Content Writer)

• Setup CI/CD (assign to CTO)

3. Approve và run:

Review strategy từ CEO, approve, và agents bắt đầu làm việc theo heartbeat schedule.

Kiến Trúc Kỹ Thuật: Làm Thế Nào Paperclip Hoạt Động?

High-Level Architecture

┌─────────────────────────────────────────────┐
│         React Dashboard (Frontend)          │
│  - Org chart visualization                  │
│  - Task management                          │
│  - Budget monitoring                        │
│  - Approval workflows                       │
└─────────────────┬───────────────────────────┘
                  │ REST API
┌─────────────────▼───────────────────────────┐
│      Node.js Server (Orchestration)         │
│  - Task routing                             │
│  - Budget enforcement                       │
│  - Heartbeat scheduling                     │
│  - Audit logging                            │
└─────────────────┬───────────────────────────┘
                  │
        ┌─────────┴─────────┐
        │                   │
┌───────▼────────┐  ┌──────▼──────────┐
│   PostgreSQL   │  │  Agent Runtime  │
│   - Companies  │  │  - OpenClaw     │
│   - Agents     │  │  - Claude Code  │
│   - Tasks      │  │  - Codex        │
│   - Budgets    │  │  - Cursor       │
│   - Audit logs │  │  - HTTP agents  │
└────────────────┘  └─────────────────┘

Database Schema (Simplified)

-- Companies
CREATE TABLE companies (
  id UUID PRIMARY KEY,
  name TEXT NOT NULL,
  mission TEXT,
  monthly_budget DECIMAL,
  created_at TIMESTAMP
);

-- Agents
CREATE TABLE agents (
  id UUID PRIMARY KEY,
  company_id UUID REFERENCES companies(id),
  role TEXT NOT NULL,
  agent_type TEXT, -- 'claude-opus', 'gpt-4', etc.
  reports_to UUID REFERENCES agents(id),
  monthly_budget DECIMAL,
  current_spend DECIMAL DEFAULT 0,
  heartbeat_interval INTEGER, -- seconds
  last_heartbeat TIMESTAMP
);

-- Tasks
CREATE TABLE tasks (
  id UUID PRIMARY KEY,
  company_id UUID REFERENCES companies(id),
  project_id UUID REFERENCES projects(id),
  assigned_to UUID REFERENCES agents(id),
  title TEXT NOT NULL,
  status TEXT, -- 'pending', 'in_progress', 'completed'
  budget DECIMAL,
  spent DECIMAL DEFAULT 0,
  checked_out_by UUID REFERENCES agents(id),
  checked_out_at TIMESTAMP
);

-- Audit Log
CREATE TABLE audit_log (
  id UUID PRIMARY KEY,
  company_id UUID REFERENCES companies(id),
  agent_id UUID REFERENCES agents(id),
  action TEXT NOT NULL,
  details JSONB,
  tokens_used INTEGER,
  cost DECIMAL,
  timestamp TIMESTAMP
);

Heartbeat System

Paperclip sử dụng heartbeat pattern để agents hoạt động proactive:

// Pseudo-code của heartbeat loop
async function heartbeat(agent) {
  while (true) {
    // 1. Check budget
    if (agent.currentSpend >= agent.monthlyBudget) {
      await sleep(agent.heartbeatInterval);
      continue;
    }

    // 2. Check for assigned tasks
    const tasks = await getAssignedTasks(agent.id);
    
    // 3. Checkout task (atomic)
    const task = await checkoutTask(tasks[0], agent.id);
    if (!task) {
      await sleep(agent.heartbeatInterval);
      continue;
    }

    // 4. Execute task
    const result = await agent.execute(task);
    
    // 5. Log to audit trail
    await logExecution(agent, task, result);
    
    // 6. Update budget
    await updateBudget(agent, result.cost);
    
    // 7. Mark task complete
    await completeTask(task.id, result);
    
    // 8. Sleep until next heartbeat
    await sleep(agent.heartbeatInterval);
  }
}

Atomic Task Checkout

Để tránh double-work, Paperclip sử dụng PostgreSQL row-level locking:

-- Atomic checkout
UPDATE tasks
SET 
  checked_out_by = $agent_id,
  checked_out_at = NOW(),
  status = 'in_progress'
WHERE id = $task_id
  AND checked_out_by IS NULL
RETURNING *;

Nếu hai agents cùng cố checkout một task, chỉ một agent thành công. Agent kia nhận NULL và move on.

Clipmart: Marketplace Cho "Công Ty Trong Hộp"

Tầm Nhìn

Clipmart (đang phát triển) là marketplace cho phép bạn download và chạy entire companies chỉ với một click. Browse các company templates được build sẵn - full org structures, agent configs, và skills - và import vào Paperclip instance của bạn trong vài giây.

Ví Dụ Templates Dự Kiến

1. Content Agency Template:

• CEO (strategy, client management)

• Content Director (editorial calendar, quality control)

• 3x Writers (blog posts, social media, newsletters)

• SEO Specialist (keyword research, optimization)

• Designer (graphics, thumbnails)

• Budget: $800/tháng

• Output: 40 blog posts, 120 social posts, 8 newsletters/tháng

2. SaaS Startup Template:

• CEO (product vision, fundraising)

• CTO (architecture, code review)

• 2x Engineers (frontend, backend)

• DevOps (CI/CD, monitoring)

• Product Manager (roadmap, user research)

• Marketing Manager (growth, content)

• Budget: $2,500/tháng

• Output: MVP trong 3 tháng

3. E-commerce Store Template:

• CEO (strategy, vendor relationships)

• Marketing Manager (ads, email campaigns)

• Content Creator (product descriptions, videos)

• Customer Support (tickets, refunds)

• Analyst (sales data, inventory)

• Budget: $600/tháng

• Output: 500+ product listings, 24/7 support

Cách Clipmart Hoạt Động

# Browse templates
paperclip browse

# Preview template
paperclip preview content-agency

# Install template
paperclip install content-agency --company-name "MyAgency"

# Customize
paperclip config edit MyAgency

# Run
paperclip start MyAgency

Templates bao gồm:

• Org chart đầy đủ với roles và reporting lines

• Agent configs (model, temperature, system prompts)

• Skills và tools cho từng role

• Budget allocations

• Governance rules

• Sample projects và tasks

Case Study Thực Tế: 3 Businesses Đang Chạy Trên Paperclip

Case 1: Content Marketing Agency (Úc)

Background: Một solo founder tại Sydney muốn chạy content agency nhưng không muốn hire team.

Setup:

• 8 agents: CEO, Content Director, 4 Writers, SEO Specialist, Designer

• Budget: $950/tháng

• Clients: 6 SMEs (mỗi client trả $800-1,200/tháng)

Workflow:

1. CEO agent nhận brief từ client qua email

2. Content Director tạo editorial calendar

3. Writers viết content theo calendar

4. SEO Specialist optimize cho search

5. Designer tạo featured images

6. CEO agent gửi draft cho client approve

7. Sau approve, content được publish tự động

Kết quả sau 2 tháng:

• Doanh thu: $6,400/tháng (6 clients × $1,067 average)

• Chi phí AI: $950/tháng

• Chi phí khác: $200/tháng (hosting, tools)

• Profit margin: 82% ($5,250 profit/tháng)

• Thời gian làm việc của founder: 8 giờ/tuần (client calls, approvals)

• Output: 48 blog posts, 144 social posts, 12 newsletters/tháng

Case 2: SaaS Startup (Singapore)

Background: Một technical founder muốn build SaaS product nhưng không có co-founder.

Setup:

• 7 agents: CEO, CTO, 2 Engineers, DevOps, PM, Marketing

• Budget: $2,200/tháng

• Product: AI-powered project management tool

Timeline:

• Tuần 1-2: CEO và PM define requirements, CTO design architecture

• Tuần 3-8: Engineers build MVP (database, API, frontend)

• Tuần 9-10: DevOps setup CI/CD, monitoring

• Tuần 11-12: Marketing tạo landing page, content, launch plan

Kết quả sau 3 tháng:

• MVP: Hoàn thành đúng deadline

• Chi phí AI: $6,600 total (3 tháng × $2,200)

• Code quality: 85% test coverage, zero critical bugs

• Early users: 120 signups trong 2 tuần đầu

• Founder time: 15 giờ/tuần (product decisions, user interviews)

So sánh với hiring team:

• Cost với human team: ~$180,000 (3 tháng × 3 engineers × $20K/tháng)

• Cost với Paperclip: $6,600

• Tiết kiệm: 96.3%

Case 3: E-commerce Automation (Việt Nam)

Background: Một shop owner tại Hà Nội bán 300+ sản phẩm trên Shopify, tốn 6-8 giờ/ngày cho customer support và content.

Setup:

• 5 agents: CEO, Marketing, Content Creator, Support, Analyst

• Budget: $580/tháng

• Tích hợp: Shopify API, Gmail, Facebook Messenger

Workflow tự động:

• Content Creator: Tạo product descriptions cho 300 sản phẩm trong 2 ngày

• Marketing: Chạy Facebook ads, email campaigns tự động

• Support: Trả lời 90% customer questions qua Messenger

• Analyst: Daily reports về sales, inventory, customer behavior

Kết quả sau 1 tháng:

• Thời gian làm việc của owner: Giảm từ 8 giờ/ngày xuống 2 giờ/ngày

• Response time support: Giảm từ 4 giờ xuống 5 phút

• Conversion rate: Tăng 18% nhờ product descriptions tốt hơn

• Customer satisfaction: Tăng từ 3.2/5 lên 4.1/5

• Chi phí: $580/tháng (so với $1,200/tháng nếu hire VA)

Budget Control: Tại Sao Đây Là Tính Năng Quan Trọng Nhất

Vấn Đề: Runaway AI Costs

Không có budget controls, AI agents có thể burn qua hàng nghìn dollars trong vài giờ. Đây là các scenarios thực tế đã xảy ra:

Scenario 1: Infinite loop bug:

Agent A: "Tạo 10 blog posts"
Agent A gọi GPT-4: $0.50
Agent A không hài lòng với output
Agent A retry: $0.50
Agent A vẫn không hài lòng
Agent A retry 847 lần
Chi phí: $423.50 trong 2 giờ

Scenario 2: Overzealous research:

Marketing Agent: "Research 100 competitors"
Agent gọi web search API: 100 queries × $0.02 = $2
Agent analyze mỗi competitor với GPT-4: 100 × $0.80 = $80
Agent tạo comparison report: $1.20
Agent không được approve, làm lại với 200 competitors
Chi phí: $164 trong 1 ngày

Giải Pháp Của Paperclip

1. Hard budget limits:

Agent monthly budget: $300
Current spend: $285
Remaining: $15

Next task cost estimate: $25
→ Task rejected, agent paused until next month

2. Tiered warnings:

• 50% budget: Log warning

• 80% budget: Email notification

• 90% budget: Require approval cho mọi task

• 100% budget: Agent tự động pause

3. Cost estimation trước khi execute:

Task: "Write 5,000 word article"
Estimated tokens: ~8,000 (input) + ~7,000 (output)
Estimated cost: $0.24 (GPT-4o-mini)
Budget check: $15 remaining → OK
Execute: ✅

4. Circuit breakers:

If agent.consecutiveFailures > 3:
  pause agent
  notify human
  require manual review

Deployment Options: Từ Laptop Đến Production

Option 1: Local Development (Miễn Phí)

Setup:

pnpm dev

Specs:

• Embedded PostgreSQL (không cần cài riêng)

• Local file storage

• Chỉ truy cập từ localhost

• Perfect cho testing và development

Chi phí: $0 (chỉ trả API calls cho agents)

Option 2: VPS Self-Hosted ($5-20/tháng)

Providers:

• DigitalOcean Droplet: $12/tháng (2GB RAM, 50GB SSD)

• Hetzner Cloud: €4.51/tháng (~$5, 4GB RAM, 40GB SSD)

• Vultr: $6/tháng (2GB RAM, 55GB SSD)

Setup:

# SSH vào VPS
ssh root@your-vps-ip

# Install Node.js 20
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt-get install -y nodejs

# Install pnpm
npm install -g pnpm

# Clone và setup
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install

# Setup PostgreSQL
apt-get install -y postgresql
sudo -u postgres createdb paperclip

# Configure
cat > .env << EOF
DATABASE_URL=postgresql://postgres:password@localhost:5432/paperclip
PORT=3100
NODE_ENV=production
EOF

# Build và run
pnpm build
pnpm start

# Setup systemd service
cat > /etc/systemd/system/paperclip.service << EOF
[Unit]
Description=Paperclip AI Orchestration
After=network.target postgresql.service

[Service]
Type=simple
User=root
WorkingDirectory=/root/paperclip
ExecStart=/usr/bin/pnpm start
Restart=always

[Install]
WantedBy=multi-user.target
EOF

systemctl enable paperclip
systemctl start paperclip

Access từ xa với Tailscale (khuyến nghị):

# Install Tailscale trên VPS
curl -fsSL https://tailscale.com/install.sh | sh
tailscale up

# Bây giờ truy cập từ bất kỳ đâu qua Tailscale IP
http://100.x.x.x:3100

Option 3: Cloud Deployment (Vercel/Railway)

Vercel (khuyến nghị cho production):

# Install Vercel CLI
npm i -g vercel

# Deploy
cd paperclip
vercel

# Setup environment variables trong Vercel dashboard:
DATABASE_URL=postgresql://user:pass@host:5432/db
ANTHROPIC_API_KEY=sk-ant-xxxxx
OPENAI_API_KEY=sk-xxxxx

Chi phí Vercel:

• Hobby: $0 (giới hạn 100GB bandwidth)

• Pro: $20/tháng (1TB bandwidth)

• Database: Sử dụng Supabase ($0-25/tháng) hoặc Neon ($0-69/tháng)

Tổng Chi Phí Ước Tính

Lưu ý: Chi phí chính là AI API calls, không phải hosting.

Paperclip + OpenClaw: Kết Hợp Hoàn Hảo

Tại Sao Dùng Cả Hai?

OpenClaw excels ở autonomy, persistence, và human communication. Paperclip excels ở task decomposition, agent coordination, và budget management. Kết hợp chúng cho bạn thứ mà không tool nào đạt được riêng lẻ - một autonomous company với single point of contact.

Pattern: "Agentic Company"

Đây là pattern được nhiều founders áp dụng:

Human Founder
    ↓
OpenClaw Agent (CEO)
    ↓
Paperclip Orchestration
    ↓
├── CTO Agent (Claude)
├── Engineer Agents (GPT-4)
├── Marketing Agents (Claude)
└── Support Agents (GPT-4o-mini)

Cách hoạt động:

1. Founder giao tiếp với OpenClaw CEO qua Telegram: "Tôi muốn launch feature X trong 2 tuần"

2. OpenClaw CEO phân tích và tạo project trong Paperclip: Decompose thành tasks, estimate budget, assign agents

3. Paperclip điều phối execution: CTO review architecture, Engineers code, DevOps deploy

4. OpenClaw CEO báo cáo progress cho founder: Daily updates qua Telegram

5. Founder chỉ cần approve major decisions: Architecture changes, budget increases, hiring

Setup Integration

# 1. Setup Paperclip
pnpm dev

# 2. Setup OpenClaw
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pip install -e .

# 3. Configure OpenClaw để connect với Paperclip
cat > workspace/SKILLS/paperclip.py << EOF
import requests

class PaperclipSkill:
    def __init__(self):
        self.api_url = "http://localhost:3100/api"
        self.api_key = "your-paperclip-api-key"
    
    def create_project(self, name, goal, budget):
        response = requests.post(
            f"{self.api_url}/projects",
            headers={"Authorization": f"Bearer {self.api_key}"},
            json={"name": name, "goal": goal, "budget": budget}
        )
        return response.json()
    
    def get_tasks(self, project_id):
        response = requests.get(
            f"{self.api_url}/projects/{project_id}/tasks",
            headers={"Authorization": f"Bearer {self.api_key}"}
        )
        return response.json()
    
    def report_progress(self, project_id):
        tasks = self.get_tasks(project_id)
        completed = [t for t in tasks if t['status'] == 'completed']
        return f"{len(completed)}/{len(tasks)} tasks completed"
EOF

# 4. Thêm skill vào OpenClaw SOUL.md
echo "- Paperclip integration: Tạo projects, monitor tasks, report progress" >> workspace/SOUL.md

# 5. Run
openclaw run

Kết Quả

Bạn có thể chat với OpenClaw CEO qua Telegram như một người thật, và nó sẽ điều phối entire company trong Paperclip. Best of both worlds.

Hạn Chế Và Thách Thức

Hạn Chế Kỹ Thuật

• Learning curve cao: Cần hiểu organizational design, không chỉ là config một chatbot

• Setup phức tạp: Nhiều moving parts (Node.js, PostgreSQL, agents, API keys)

• Documentation còn thiếu: Project mới (early 2026), docs chưa đầy đủ

• Debugging khó: Khi có bug, khó trace qua nhiều agents

• Latency: Orchestration layer thêm overhead, chậm hơn direct agent calls

• Single point of failure: Nếu Paperclip server down, toàn bộ company dừng

Thách Thức Về Mặt Kinh Doanh

• Quality control: AI output không consistent như người, cần review processes

• Customer trust: Nhiều khách hàng không thoải mái với "AI-only" companies

• Legal liability: Khi AI agent làm sai, ai chịu trách nhiệm?

• Compliance: Nhiều ngành (finance, healthcare) yêu cầu human oversight

• Creativity limits: AI tốt cho execution, chưa tốt cho breakthrough ideas

Vấn Đề Đạo Đức

• Job displacement: Zero-human companies đe dọa việc làm của freelancers và agencies

• Race to the bottom: Giá dịch vụ có thể giảm mạnh, khó cạnh tranh cho human workers

• Quality degradation: Nếu mọi người đều dùng AI, content trở nên generic

• Accountability gap: Khi AI làm sai, trách nhiệm pháp lý không rõ ràng

Khi Nào Không Nên Dùng Paperclip?

Scenarios Không Phù Hợp

1. Bạn chỉ cần một chatbot:

Nếu use case của bạn là "trả lời câu hỏi" hoặc "tạo content đơn giản", dùng ChatGPT hoặc Claude trực tiếp. Paperclip là overkill.

2. Bạn chưa có agents:

Paperclip điều phối agents bạn đã có. Nếu bạn chưa có agents nào, bắt đầu với OpenClaw hoặc Claude Code trước.

3. Công việc cần creativity cao:

AI tốt cho execution, chưa tốt cho breakthrough creative work. Nếu business của bạn sống nhờ creativity (design agency, advertising), AI chỉ nên là assistant, không phải entire team.

4. Ngành có compliance nghiêm ngặt:

Finance, healthcare, legal - các ngành này yêu cầu human oversight và có regulations về AI. Zero-human company không phù hợp.

5. Bạn không có technical background:

Paperclip cần setup Node.js, PostgreSQL, configure agents, debug issues. Nếu bạn không comfortable với terminal và code, đây không phải tool cho bạn (ít nhất là bây giờ).

Roadmap: Tương Lai Của Paperclip

Q2 2026

• Clipmart launch: Marketplace cho company templates

• Easier OpenClaw onboarding: One-click integration

• Cloud agents support: Cursor, e2b agents

• Better docs: Comprehensive guides và tutorials

Q3-Q4 2026

• Plugin system: Custom knowledgebase, tracing, queues

• Better agent configs: Easier to understand và customize

• Harness engineering support: Advanced agent coordination patterns

• Mobile app: Native iOS/Android apps (hiện tại chỉ có responsive web)

• Bring-your-own-ticket-system: Tích hợp với Asana, Trello, Linear

Long-Term Vision

Theo team Paperclip, vision là:

"Trong 5 năm, việc start một company sẽ giống như deploy một app. Bạn chọn template, customize, và hit deploy. Company của bạn chạy 24/7, tạo revenue, và scale tự động. Bạn chỉ cần set strategy và approve major decisions."

Cộng Đồng Và Ecosystem

GitHub Stats (15/3/2026)

• Stars: 12,800 (tăng nhanh)

• Forks: 680

• Contributors: 34

• Open issues: 156

• Pull requests: 89

• Discord: 5,600+ members

Các Projects Liên Quan

1. Paperclip Templates (community-driven):

• github.com/paperclip-templates

• 45+ company templates được community đóng góp

• Content agencies, SaaS startups, e-commerce, consulting

2. Paperclip Plugins:

• Slack integration

• Notion sync

• Stripe billing automation

• Analytics dashboards

3. Paperclip CLI (paperclipper):

# Install
npm install -g paperclipper

# Commands
paperclipper init          # Tạo company mới
paperclipper hire          # Thêm agent
paperclipper status        # Xem company status
paperclipper budget        # Check budget usage
paperclipper logs          # Xem audit logs

So Sánh Với Các Công Cụ Khác

Paperclip vs LangChain/AutoGen/CrewAI

Kết Luận So Sánh

LangChain, AutoGen, và CrewAI là frameworks để build agents. Paperclip là platform để run companies made of agents. Chúng không cạnh tranh - chúng bổ sung nhau.

Typical stack:

LangChain/AutoGen → Build custom agents
OpenClaw → Autonomous agent runtime
Paperclip → Company orchestration layer

Xu Hướng "Zero-Human Company" Năm 2026

Các Ví Dụ Thực Tế

1. Felix (Nat Eliason) - $200K trong vài tuần:

• OpenClaw-based company

• 3 dòng doanh thu: PDF sales, Claw Mart, Clawcommerce

• Target: $1M revenue

• Được nhắc đến trên Bankless podcast (4/3/2026)

2. Aaron Sneed - 15 AI agents council:

• Profiled bởi Business Insider (2/2026)

• 15 custom GPT agents với roles cụ thể

• Tiết kiệm 20+ giờ/tuần

• Agents phối hợp như một management team

3. FelixCraft - $80K trong 30 ngày:

• Platform tạo và bán AI-generated products

• Hoàn toàn tự động từ creation đến fulfillment

• Được nhắc đến trong Contrary Research report

4. Polcia - $1M ARR với 1,200+ sub-companies:

• Platform chạy hàng nghìn micro-businesses tự động

• Mỗi "company" là một niche business nhỏ

• Aggregate revenue: $1M ARR

Thống Kê Thị Trường

• Autonomous agents market: Dự kiến tăng trưởng 43% CAGR

• 82% của Global 2000 companies: Sẽ có dedicated AI orchestration budget line items trong 2026

• Enterprise AI budgets: Tăng gấp đôi so với 2024

• Top-quartile AI users: 6x output gap so với average users

• Anthropic engineers: 67% tăng merged PRs nhờ AI agents

Best Practices: Làm Thế Nào Để Thành Công Với Paperclip

1. Bắt Đầu Nhỏ

Đừng tạo 20 agents ngay từ đầu. Bắt đầu với 2-3 agents cho một workflow cụ thể.

Ví dụ starter setup:

• CEO Agent: Strategy và coordination

• Worker Agent: Execution (content, code, research)

• QA Agent: Review và quality control

Chạy trong 2-4 tuần, học patterns, rồi mới scale.

2. Map Processes Trước Khi Automate

Nếu bạn không thể explain steps của một task, AI agent không thể làm nó reliably.

Bad: "Làm marketing"

Good:

1. Research 10 competitors

2. Identify 3 content gaps

3. Write 1 blog post addressing gap #1

4. Optimize for SEO (target keyword: X)

5. Create 5 social posts promoting blog

6. Schedule posts for next week

3. Set Conservative Budgets Ban Đầu

Bạn luôn có thể tăng budget. Khó hơn nhiều để recover từ $2,000 bill bất ngờ.

Khuyến nghị starting budgets:

• CEO/strategic agents: $100-200/tháng

• Worker agents: $200-400/tháng

• QA/review agents: $50-100/tháng

• Total company: $500-1,000/tháng cho first month

4. Review Audit Logs Hàng Ngày

Ít nhất trong 2 tuần đầu, check audit logs mỗi ngày để catch issues sớm.

Red flags cần chú ý:

• Agent retry cùng một task nhiều lần

• Sudden spike trong token usage

• Tasks completed quá nhanh (có thể output kém chất lượng)

• Agents không complete tasks (có thể stuck)

5. Human Checkpoints Cho High-Stakes Decisions

Đừng để agents tự động làm mọi thứ. Set approval gates cho:

• Emails gửi cho clients/customers

• Deploys lên production

• Chi tiêu trên $50

• Thay đổi pricing hoặc terms

• Hiring/firing agents

Advanced Patterns: Khi Bạn Đã Thành Thạo Basics

Pattern 1: Hierarchical Delegation

CEO agent không assign tasks trực tiếp cho engineers. CEO assign cho CTO, CTO assign cho engineers.

CEO: "Launch feature X"
  ↓
CTO: "Design architecture, estimate effort"
  ↓
Senior Engineer: "Implement backend"
Junior Engineer: "Implement frontend"
DevOps: "Setup deployment"

Điều này scale tốt hơn flat structure.

Pattern 2: Specialist Agents

Thay vì một "Engineer" agent làm mọi thứ, tạo specialist agents:

• Backend Engineer: API, database, business logic

• Frontend Engineer: React, UI/UX, responsive design

• DevOps Engineer: CI/CD, monitoring, infrastructure

• QA Engineer: Testing, bug reports, quality assurance

Mỗi agent dùng model phù hợp với task:

• Backend: Claude Sonnet (tốt cho logic phức tạp)

• Frontend: GPT-4 (tốt cho UI code)

• DevOps: GPT-4o-mini (scripts đơn giản, rẻ)

• QA: Claude Haiku (fast, cheap cho testing)

Pattern 3: Budget Pooling

Thay vì hard limit cho từng agent, tạo department budgets:

Engineering Department: $1,200/tháng
├── CTO: $300 allocated, $180 used
├── Senior Engineer: $400 allocated, $420 used ⚠️
└── Junior Engineer: $500 allocated, $280 used

Department total: $880/$1,200 used (73%)
→ Senior Engineer có thể borrow từ Junior Engineer pool

Flexible hơn nhưng cần monitoring cẩn thận.

Pattern 4: Approval Workflows

Tạo multi-level approvals cho sensitive operations:

Task: "Send email campaign to 5,000 customers"
  ↓
Marketing Agent: Draft email
  ↓
Marketing Manager Agent: Review và approve
  ↓
CEO Agent: Final approval
  ↓
Execute: Send emails

Pattern 5: Fallback Chains

Khi một agent fail, tự động escalate:

Junior Engineer: Attempt task
  ↓ (if fails after 2 tries)
Senior Engineer: Attempt task
  ↓ (if fails after 2 tries)
CTO: Attempt task
  ↓ (if fails)
Notify human: Manual intervention needed

Tính Toán ROI: Paperclip Có Đáng Không?

Scenario: Content Agency

Option A: Human team

• 1 Content Director: $5,000/tháng

• 2 Writers: $3,000/tháng mỗi người

• 1 SEO Specialist: $3,500/tháng

• 1 Designer: $3,000/tháng

• Total: $17,500/tháng

• Output: 40 blog posts, 120 social posts/tháng

Option B: Paperclip + AI agents

• Hosting: $20/tháng (Vercel + Supabase)

• AI API: $800/tháng (8 agents × $100 average)

• Human oversight: $2,000/tháng (founder, 10 giờ/tuần)

• Total: $2,820/tháng

• Output: 40 blog posts, 120 social posts/tháng (same)

ROI:

• Tiết kiệm: $14,680/tháng ($176,160/năm)

• Tiết kiệm: 84%

• Payback period: Ngay lập tức (setup chỉ tốn 1-2 ngày)

Scenario: SaaS Startup MVP

Option A: Hire team

• 1 CTO: $12,000/tháng

• 2 Engineers: $8,000/tháng mỗi người

• 1 Designer: $6,000/tháng

• Total: $34,000/tháng × 3 tháng = $102,000

• Timeline: 3 tháng đến MVP

Option B: Paperclip

• Hosting: $20/tháng

• AI API: $2,200/tháng

• Founder time: $0 (sweat equity)

• Total: $2,220/tháng × 3 tháng = $6,660

• Timeline: 3 tháng đến MVP (tương tự)

ROI:

• Tiết kiệm: $95,340

• Tiết kiệm: 93.5%

• Trade-off: Code quality có thể cần more review

Khi Nào ROI Không Tốt?

• Tasks cần deep expertise: AI chưa thay thế được senior specialists

• High-stakes decisions: Legal, compliance, financial - cần human judgment

• Creative breakthrough work: AI tốt cho execution, chưa tốt cho innovation

• Relationship-heavy work: Sales, partnerships - cần human touch

Troubleshooting: Các Vấn Đề Thường Gặp

Problem 1: Agents Không Làm Gì

Symptoms: Agents được assign tasks nhưng không execute.

Possible causes:

• Heartbeat interval quá dài (agent chưa wake up)

• Budget đã hết (agent bị pause)

• API keys không đúng (agent không thể call LLM)

• Task không có clear instructions

Solutions:

# Check agent status
paperclip status --agent-id xxx

# Check budget
paperclip budget --agent-id xxx

# Check logs
paperclip logs --agent-id xxx --last 50

# Trigger manual heartbeat
paperclip heartbeat --agent-id xxx --force

Problem 2: Runaway Costs

Symptoms: Budget tăng nhanh bất thường.

Possible causes:

• Agent stuck trong retry loop

• Task quá phức tạp, cần nhiều tokens

• Agent dùng expensive model (GPT-4) cho simple tasks

Solutions:

# Pause agent ngay lập tức
paperclip pause --agent-id xxx

# Review audit logs
paperclip logs --agent-id xxx --filter "cost > 1.0"

# Adjust budget
paperclip budget set --agent-id xxx --monthly 200

# Switch to cheaper model
paperclip config edit --agent-id xxx --model "gpt-4o-mini"

Problem 3: Poor Output Quality

Symptoms: Agents complete tasks nhưng output không đạt yêu cầu.

Solutions:

• Improve prompts: Thêm examples, constraints, quality criteria

• Add review step: Tạo QA agent review output trước khi approve

• Use better models: Upgrade từ GPT-4o-mini lên GPT-4 hoặc Claude Sonnet

• Provide more context: Link đến style guides, examples, documentation

Problem 4: Agents Conflict

Symptoms: Hai agents làm cùng một việc hoặc làm việc mâu thuẫn nhau.

Solutions:

• Clear role definitions: Mỗi agent phải có scope rõ ràng

• Atomic task checkout: Đảm bảo database locking hoạt động đúng

• Communication protocols: Agents phải notify nhau khi làm related work

Tương Lai: Từ Experiment Đến Mainstream

Dự Đoán 12 Tháng Tới

Q2 2026:

• Clipmart launch với 100+ company templates

• 1,000+ companies chạy trên Paperclip

• First "unicorn" zero-human company (valuation $1B+)

Q3 2026:

• Major VCs bắt đầu fund zero-human companies

• Regulations đầu tiên về AI-operated businesses

• Paperclip Enterprise version (SaaS, managed hosting)

Q4 2026:

• 10,000+ zero-human companies đang hoạt động

• Aggregate revenue: $100M+

• Paperclip trở thành standard cho AI orchestration

Tác Động Dài Hạn

Đối với founders:

• Barrier to entry giảm mạnh - start company với $500 thay vì $50,000

• Time to market nhanh hơn - MVP trong tuần thay vì tháng

• Có thể chạy nhiều companies song song

Đối với workers:

• Cạnh tranh với AI agents cho routine work

• Cần upskill sang strategic/creative work

• Freelance rates có thể giảm do AI competition

Đối với economy:

• Số lượng companies tăng mạnh (dễ start hơn)

• Productivity per capita tăng

• Wealth concentration (founders với AI > workers)

• Cần rethink về employment và social safety net

Đánh Giá Tổng Quan

Ưu Điểm

• Orchestration thực sự: Không tool nào khác có org chart, budget control, và governance như Paperclip

• Open-source và self-hosted: Full control, không vendor lock-in, miễn phí

• Multi-company support: Chạy nhiều businesses từ một deployment

• Agent-agnostic: Dùng bất kỳ agent nào (OpenClaw, Claude, GPT, custom)

• Production-ready: Atomic execution, persistent state, audit trails

• Mobile-friendly: Quản lý company từ điện thoại

• Cost-effective: Tiết kiệm 80-95% so với human team

• Scalable: Từ 2 agents đến 50+ agents

Nhược Điểm

• Learning curve cao: Cần hiểu org design, không chỉ config chatbot

• Setup phức tạp: Node.js, PostgreSQL, agents, API keys

• Documentation thiếu: Project mới, docs chưa comprehensive

• Community nhỏ: 5,600 Discord members (so với 50,000+ của OpenClaw)

• Debugging khó: Multi-agent issues khó trace

• Overkill cho solo use: Nếu chỉ cần 1 agent, dùng OpenClaw trực tiếp

• Chưa có Clipmart: Phải tự setup everything từ đầu

Điểm Số

Overall: 8.2/10

• Innovation: 9.5/10 - Đột phá trong AI orchestration

• Usability: 6.5/10 - Khó cho beginners, tốt khi đã quen

• Features: 9.0/10 - Đầy đủ cho running companies

• Documentation: 6.0/10 - Đang improve

• Community: 7.0/10 - Đang phát triển nhanh

• Value for money: 10/10 - Open-source, tiết kiệm 80-95%

Lời Khuyên Cuối: Nên Bắt Đầu Như Thế Nào?

Roadmap Cho Beginners

Tháng 1: Học OpenClaw

• Setup một OpenClaw agent

• Automate 1-2 workflows đơn giản

• Học cách agents hoạt động, memory system, skills

• Chi phí: $50-100

Tháng 2: Scale lên 3-5 agents

• Thêm specialized agents (content, research, support)

• Bắt đầu thấy coordination challenges

• Track costs manually trong spreadsheet

• Chi phí: $200-400

Tháng 3: Thêm Paperclip

• Setup Paperclip local

• Import existing agents vào org chart

• Set budgets và governance rules

• Monitor từ dashboard thay vì spreadsheet

• Chi phí: $400-800

Tháng 4+: Scale và optimize

• Thêm agents khi cần

• Optimize budgets dựa trên data

• Automate more workflows

• Consider multi-company nếu có nhiều ventures

Checklist Trước Khi Bắt Đầu

Bạn sẵn sàng cho Paperclip nếu:

• ✅ Bạn đã có 3+ agents đang chạy

• ✅ Bạn đang gặp coordination problems

• ✅ Bạn lo lắng về runaway costs

• ✅ Bạn comfortable với Node.js và PostgreSQL

• ✅ Bạn có 1-2 ngày để setup và learn

• ✅ Bạn cần audit trails và governance

Bạn chưa sẵn sàng nếu:

• ❌ Bạn chưa bao giờ dùng AI agents

• ❌ Bạn chỉ cần một chatbot đơn giản

• ❌ Bạn không có technical background

• ❌ Bạn mong đợi "plug and play" solution

• ❌ Bạn không có thời gian để iterate và optimize

Kết Luận: Tương Lai Của Công Ty Là Gì?

Paperclip không chỉ là một công cụ - nó là một tầm nhìn về tương lai của công ty. Một tương lai mà việc start một business giống như deploy một app. Một tương lai mà founder không phải spend 80% thời gian managing people, mà focus vào strategy và vision.

Câu Hỏi Lớn

Liệu zero-human companies có phải là tương lai?

Có lẽ không phải cho mọi business. Nhưng chắc chắn cho một phần đáng kể. Các businesses mà:

• Execution quan trọng hơn creativity

• Processes có thể được documented

• Scale quan trọng hơn personalization

• Cost efficiency là competitive advantage

Những businesses này sẽ chuyển sang AI-first hoặc AI-only. Và Paperclip là công cụ để làm điều đó.

Bài Học Cho Developers

1. Orchestration > Individual capability:

Một team gồm 5 agents trung bình với coordination tốt thắng 1 agent xuất sắc hoạt động độc lập. Đây là lý do Paperclip quan trọng.

2. Governance không phải overhead:

Budget controls, approval gates, audit trails - đây không phải bureaucracy. Đây là infrastructure cần thiết để scale safely.

3. Start simple, scale gradually:

Đừng build 20-agent company ngay từ đầu. Bắt đầu với 2-3 agents, prove the model, rồi scale.

4. Human oversight luôn cần thiết:

Ngay cả trong "zero-human company", human founder vẫn là board of directors. AI làm execution, human làm strategy.

Lời Khuyên Cuối

Nếu bạn đang nghĩ về việc dùng Paperclip:

1. Bắt đầu với OpenClaw: Học cách một agent hoạt động trước

2. Identify một workflow cụ thể: Đừng cố automate everything cùng lúc

3. Setup Paperclip local: Test với 2-3 agents trong 2 tuần

4. Measure ROI: Track time saved, cost, output quality

5. Scale nếu works: Thêm agents, deploy production, automate more

Zero-human company không phải cho mọi người. Nhưng nếu bạn là technical founder, comfortable với AI, và muốn build fast với minimal team - đây có thể là game-changer.

Điều quan trọng nhất: Đừng sợ experiment. Paperclip là open-source và miễn phí. Worst case, bạn học được nhiều về AI orchestration. Best case, bạn build một company tạo revenue 24/7 mà không cần hire anyone.

Tương lai của công ty có thể không phải là zero-human. Nhưng chắc chắn là AI-augmented. Và Paperclip là cách để bắt đầu.

Bonus: Code Examples Thực Tế

Example 1: Tạo Company Qua API

// create-company.js
const axios = require('axios');

async function createCompany() {
  // 1. Tạo company
  const company = await axios.post('http://localhost:3100/api/companies', {
    name: 'MyStartup',
    mission: 'Build the #1 AI note-taking app to $1M MRR',
    monthlyBudget: 2000
  });

  const companyId = company.data.id;

  // 2. Hire CEO
  const ceo = await axios.post('http://localhost:3100/api/agents', {
    companyId,
    role: 'CEO',
    agentType: 'claude-opus-4',
    monthlyBudget: 200,
    heartbeatInterval: 86400, // 24 hours
    systemPrompt: 'You are the CEO. Focus on strategy, goal decomposition, and priority setting.'
  });

  // 3. Hire CTO (reports to CEO)
  const cto = await axios.post('http://localhost:3100/api/agents', {
    companyId,
    role: 'CTO',
    agentType: 'gpt-4',
    reportsTo: ceo.data.id,
    monthlyBudget: 500,
    heartbeatInterval: 14400, // 4 hours
    systemPrompt: 'You are the CTO. Handle technical architecture, code review, and DevOps.'
  });

  // 4. Tạo project
  const project = await axios.post('http://localhost:3100/api/projects', {
    companyId,
    name: 'MVP Launch',
    goal: 'Launch working note-taking app in 3 months',
    ownerId: ceo.data.id,
    budget: 1500,
    deadline: '2026-06-15'
  });

  console.log('Company created:', companyId);
  console.log('Project created:', project.data.id);
}

createCompany();

Example 2: Monitor Budget Usage

// monitor-budget.js
const axios = require('axios');

async function monitorBudget(companyId) {
  const response = await axios.get(
    `http://localhost:3100/api/companies/${companyId}/budget`
  );

  const { agents, total } = response.data;

  console.log(`Company Budget: $${total.spent}/$${total.limit}`);
  console.log(`Remaining: $${total.limit - total.spent}\n`);

  agents.forEach(agent => {
    const percentage = (agent.spent / agent.budget * 100).toFixed(1);
    const status = percentage > 90 ? '🔴' : percentage > 80 ? '🟡' : '🟢';
    
    console.log(`${status} ${agent.role}: $${agent.spent}/$${agent.budget} (${percentage}%)`);
  });

  // Alert nếu có agent gần hết budget
  const criticalAgents = agents.filter(a => a.spent / a.budget > 0.9);
  if (criticalAgents.length > 0) {
    console.log('\n⚠️  WARNING: These agents are near budget limit:');
    criticalAgents.forEach(a => {
      console.log(`  - ${a.role}: ${((a.budget - a.spent)).toFixed(2)} remaining`);
    });
  }
}

// Run every hour
setInterval(() => monitorBudget('company-id-here'), 3600000);

Example 3: Custom Agent Integration

// custom-agent.js
// Tạo custom agent có thể integrate với Paperclip

class CustomAgent {
  constructor(config) {
    this.id = config.id;
    this.role = config.role;
    this.paperclipUrl = config.paperclipUrl;
    this.apiKey = config.apiKey;
  }

  async heartbeat() {
    // 1. Get assigned tasks
    const tasks = await this.getTasks();
    
    if (tasks.length === 0) {
      console.log('No tasks assigned');
      return;
    }

    // 2. Checkout first task
    const task = await this.checkoutTask(tasks[0].id);
    
    if (!task) {
      console.log('Task already checked out by another agent');
      return;
    }

    // 3. Execute task
    const result = await this.executeTask(task);

    // 4. Report result
    await this.completeTask(task.id, result);
  }

  async getTasks() {
    const response = await axios.get(
      `${this.paperclipUrl}/api/agents/${this.id}/tasks`,
      { headers: { Authorization: `Bearer ${this.apiKey}` } }
    );
    return response.data;
  }

  async checkoutTask(taskId) {
    try {
      const response = await axios.post(
        `${this.paperclipUrl}/api/tasks/${taskId}/checkout`,
        { agentId: this.id },
        { headers: { Authorization: `Bearer ${this.apiKey}` } }
      );
      return response.data;
    } catch (error) {
      return null; // Already checked out
    }
  }

  async executeTask(task) {
    // Your custom logic here
    console.log(`Executing: ${task.title}`);
    
    // Call your LLM, run your code, etc.
    const output = await yourCustomLogic(task);
    
    return {
      status: 'completed',
      output: output,
      tokensUsed: 1200,
      cost: 0.024
    };
  }

  async completeTask(taskId, result) {
    await axios.post(
      `${this.paperclipUrl}/api/tasks/${taskId}/complete`,
      result,
      { headers: { Authorization: `Bearer ${this.apiKey}` } }
    );
  }

  start(intervalSeconds = 3600) {
    console.log(`Agent ${this.role} started with ${intervalSeconds}s heartbeat`);
    setInterval(() => this.heartbeat(), intervalSeconds * 1000);
  }
}

// Usage
const agent = new CustomAgent({
  id: 'agent-123',
  role: 'Content Writer',
  paperclipUrl: 'http://localhost:3100',
  apiKey: 'your-api-key'
});

agent.start(3600); // Heartbeat every hour

Phụ Lục: Decision Tree - Nên Dùng Tool Nào?

Flowchart Lựa Chọn

Bạn cần AI cho business?
│
├─ Có → Bạn cần bao nhiêu agents?
│       │
│       ├─ 1 agent → Dùng OpenClaw hoặc Claude Code trực tiếp
│       │
│       ├─ 2-4 agents → OpenClaw + manual coordination
│       │              (chưa cần Paperclip)
│       │
│       └─ 5+ agents → Bạn cần budget control?
│                      │
│                      ├─ Có → Paperclip (bắt buộc)
│                      │
│                      └─ Không → Bạn có $10K+ để burn? 😅
│                                 │
│                                 ├─ Có → Chạy không có Paperclip
│                                 │       (prepare for surprises)
│                                 │
│                                 └─ Không → Dùng Paperclip đi
│
└─ Không → Bạn đang đọc bài này làm gì? 😄
    

Bảng Quyết Định Chi Tiết

Kết Luận: Paperclip Và Cuộc Cách Mạng Zero-Human

Paperclip đại diện cho một shift fundamental trong cách chúng ta nghĩ về companies. Từ "organizations of people" sang "organizations of agents". Từ "managing employees" sang "governing systems".

Đây không phải là tương lai xa xôi. Đây là hiện tại. Felix đang tạo $200K. Aaron Sneed đang save 20 giờ/tuần. Hàng trăm founders đang experiment với zero-human models.

Câu hỏi không phải là "Liệu zero-human companies có thành công?" - câu trả lời đã rõ: Có, với đúng use cases.

Câu hỏi thực sự là: "Business của bạn có phải là use case đó không?"

Nếu business của bạn:

• Có processes có thể documented

• Execution quan trọng hơn creativity

• Scale là competitive advantage

• Cost efficiency critical

Thì câu trả lời có thể là có. Và Paperclip là tool để thử.

Nếu không chắc, bắt đầu nhỏ. Setup một OpenClaw agent. Automate một workflow. Measure ROI. Rồi quyết định có scale lên Paperclip hay không.

Tương lai của công ty đang được viết bây giờ. Và bạn có thể là một phần của nó.