這一站不是教材，是研究現場—— 記錄我理解 Paperclip 這套 zero-human company orchestration 的過程。 我不是 paperclip 原始碼貢獻者，也還沒真正用它跑過一家公司。 所以這裡先不追 A 級深度，先追誠實。
Paperclip 是一個開源的 Node.js server + React UI，幫你編排一群 AI agent 來跑一間公司。你定義 company、organize org chart、分派 goal、設 budget，agent 們自己領任務、互相 @ 標記、跑完回報——你只管策略審批，不管執行。
OpenClaw / Claude Code 是員工；Paperclip 是公司。
它不是 agent framework，是 agent 的組織架構 + 治理平台。
官方自己把定位講得很死：
我當下不需要它。我只是一個人用 Claude Code。官方文件清楚寫著「If you have one agent, you probably don't need Paperclip」，所以不要自欺。
那為什麼放進 dean.today 當第五專題？三個理由，由近到遠：
近：B 路線預備——未來把 Product/ 下所有 AI 工具（docutranslate / blog-image-gen / cosyvoice / facefusion / dean.today 自己...）全部納管，需要一個中央治理層。
中：「AI 組織架構」是未來 10 年最貴的技能之一，現在學比 5 年後學便宜。
遠：dean.today 上每個專題都要深到能教人能辯護——如果我不親自跑過一家 paperclip 公司，就沒資格說我懂「AI agent 編排」。
所以這個站的終極目標是：在這裡寫下一份「給想用 paperclip 的台灣開發者的入門指南」——當我能寫到那個深度，這站就從「學習中」升級到「建置中」再到「A 級」。
從官方文件與 README 抽出的 8 個基礎概念。建議依序理解——後面的都建立在前面上。
兩條路。Node.js 20+ 與 pnpm 9.15+ 是先決條件。
路徑 A · 官方 npx 一鍵（還沒親測）：
npx paperclipai onboard --yes # 會自動安裝 + 啟動 API server (http://localhost:3100) # 內建 PostgreSQL 自動建好
路徑 B · 手動從 source（本機已 clone 在 ref/paperclip/）：
cd /Users/dean/Desktop/Product/dean.today/ref/paperclip pnpm install pnpm dev # API server: http://localhost:3100 # UI: http://localhost:3101 (React)
內建 embedded PostgreSQL · 不需要另裝 DB · 檔案存本地
正式部署時再接自己的 Postgres + S3
本地使用可配 Tailscale 從手機遠端管理
這是我要按順序親手跑完的三個實驗。每個跑完要能回答一個問題，能就升級，不能就繼續折騰。
照 Quickstart 路徑 B 把 pnpm dev 跑起來 · 開 UI · 建立第一家公司「dean.today 持續維護」。
✔ 通過條件：localhost:3100 API 正常 · UI 看到一家新建公司 · embedded Postgres 無報錯
設兩個 agent——「園丁」負責每日檢查各子站 RSS / 新聞、「檢查員」負責跑 smoke.mjs + tidy。 設 goal「保持主站全綠」，用 heartbeat 每 12 小時喚醒園丁，園丁發現問題就 @ 檢查員。
✔ 通過條件：24 小時無人介入 · 兩個 agent 有真實 ticket 互動紀錄 · 無預算爆炸
把 docutranslate / blog-image-gen / cosyvoice 三個工具各配一個 agent·
建第二家公司「Dean 個人 AI 工具集」· 跨工具任務測試（例：產生文章 → 翻譯 → 生圖 → 合成配音）。
✔ 通過條件：一個連鎖任務自動跑完 · 費用低於 USD 5 · 有明確成本歸屬
還沒想通的事。這區每個月更新一次。
Paperclip 的 Governance 真的能卡住一個 agent 的 runaway call 嗎？還是只是事後 audit？
我一個人管一家「公司」，是不是意味著我同時是 Board + CEO + 所有 agent 的 manager？會不會反而比直接開 Claude Code 慢？
Heartbeat 的間隔設太長 → agent 不及時；設太短 → 成本累積。有沒有普遍經驗法則？
embedded Postgres 裡的 conversation history 會不會成為隱私風險？（如果我讓 agent 讀我的私人筆記）
如果 Paperclip 官方版跳得太快，上游 breaking change 頻繁，我要不要 fork 一份釘版本？
用 Paperclip 管理 Mac 本地 conda 環境的 Python agent（docutranslate / blog-image-gen）可行嗎？heartbeat 要走 HTTP 還是 bash wrapper？