前言:打造 AI 零人力公司的第一道關卡

最近我在實驗 Paperclip 這個開源專案,希望透過多個 AI 代理建立一套接近「零人力運作」的公司系統。過程雖然有趣,但一開始就卡在 OpenCode 最常見的權限錯誤上。

好消息是:這個問題完全不需要寫任何程式碼,用 MacBook 內建的 Finder 就能輕鬆解決。以下分享完整無代碼解決步驟,適合不熟悉終端機的朋友。

什麼是 Paperclip?

Paperclip 是一個開源的 AI 代理編排平台,被稱為「Open-source orchestration for zero-human companies」。

它能讓多個 AI 代理組成一個虛擬公司:

  • 設定 CEO、工程師、行銷等不同角色
  • 透過 Heartbeat(心跳機制)讓 AI 定期自動醒來檢查任務
  • 自動委派工作、更新記憶、追蹤進度
  • 提供完整 Dashboard 監控成本與執行情況

核心目標是實現真正的 AI 團隊自動化,而非單純的聊天工具,非常適合想探索被動系統與 AI 自動化的人。

遇到的問題

當我使用 OpenCode (local) 作為 CEO Agent 時,每次執行「Run Heartbeat」都會出現以下錯誤:

permission requested: external_directory (…/instructions/*); auto-rejecting

Error: The user rejected permission to use this specific tool call.

導致代理無法讀取 SOUL.md、TOOLS.md、HEARTBEAT.md 等關鍵設定檔案,整個 Agent 無法正常初始化。

無代碼解決方法(MacBook 超簡單版)

問題核心在於 OpenCode 對「外部目錄」的權限限制。我們只需要告訴 OpenCode 允許存取 Paperclip 的資料夾即可。

步驟 1:顯示隱藏資料夾

  1. 打開 Finder
  2. 點擊上方選單 前往 → 前往資料夾…(或按快捷鍵 Shift + Command + G
  3. 輸入以下路徑後按「前往」:
    ~/.config
  4. 如果裡面沒有 opencode 資料夾,請在空白處右鍵 → 新增資料夾,並命名為 opencode

小技巧: 在 Finder 中按 Command + Shift + .(句點鍵),可以快速顯示或隱藏所有隱藏檔案。

步驟 2:建立並編輯 opencode.json

  1. 進入剛才建立的 opencode 資料夾
  2. 在空白處右鍵 → 新增文件,命名為 opencode.json(注意副檔名必須是 .json)
  3. 用「文字編輯」App 打開這個檔案
  4. 把以下內容完整複製貼上(保留你原本的設定,只在最下方加入 permission 區塊):
{
  "permission": {
    "external_directory": {
      "/Users/你的使用者名稱/.paperclip/**": "allow"
    }
  }
}

重要提醒: 請將 /Users/你的使用者名稱/ 改成你 Mac 的實際家目錄名稱(例如 /Users/siuleeboss/)。

步驟 3:套用設定

  1. 保存 opencode.json 檔案
  2. 完全關閉 Paperclip(在「活動監視器」中搜尋並結束所有 Paperclip 相關程序)
  3. 重新開啟 Paperclip
  4. 進入 CEO Agent 的 Configuration 頁面,點擊 Run Heartbeat 測試

完成後,權限錯誤應該會消失,CEO Agent 即可正常運作並開始使用 para-memory-files 等技能。

為什麼這個方法更好?

  • 無需使用危險的 dangerously skip 設定
  • 一次設定,全域生效
  • 未來招聘其他 AI Agent 時較不容易再出現相同問題
  • 完全使用 Mac 內建工具操作,適合新手

結語

Paperclip 是一個極具潛力的開源專案,讓我們可以用較低門檻開始實驗 AI 團隊自動化與被動系統建置。雖然設定過程會遇到一些技術小坑,但用正確的方法就能快速突破。

如果你也在 MacBook 上探索 AI 自動化與零人力運作,建議優先把 OpenCode 的 permission 設定做好,能節省大量時間。

有興趣的朋友歡迎到 GitHub 搜尋 paperclipai/paperclip 了解更多。

2026 AI 自動化實戰分享|零人力公司實驗|MacBook 無代碼教學

Share this content: