agentcookie
您的代理程式在非日常使用的 Mac 上執行。agentcookie 持續將工作階段與您實際瀏覽的 Mac 同步,並透過 Tailscale 加密傳輸。
agentcookie 是什麼?
您的代理程式在非日常使用的 Mac 上執行。agentcookie 持續將工作階段與您實際瀏覽的 Mac 同步,並透過 Tailscale 加密傳輸,因此 OpenClaw、Hermes 或其他代理程式執行環境啟動時皆已通過驗證。macOS 專用,點對點架構,無需雲端中介。
agentcookie 概覽
這是什麼
agentcookie 是一個 macOS 到 Linux 的 Cookie 同步工具。它會持續將 Mac(來源端)的 Chrome Cookie 複製到 Linux 機器(接收端),並透過 Tailscale 傳輸。傳輸過程使用 AES-256-GCM 加密,採用點對點通訊,無需雲端中介。接收端透過 Chrome DevTools Protocol (CDP) 將 Cookie 直接注入 Chrome 的記憶體儲存,讓 Linux 上的代理程式(例如 browser-use、Puppeteer、Playwright)無需手動登入即可使用已認證的工作階段。本專案以 Go 語言撰寫,採用 MIT 授權。
主要功能
- 持續、無人值守的單向 Cookie 同步,從 Mac 到 Linux,透過 Tailscale 進行。
- 使用 AES-256-GCM 加密,經由 Tailscale WireGuard 通道傳輸。
- 配對衍生每對等金鑰,確保通訊安全。
- 來源端與接收端皆支援 Cookie 政策過濾(允許清單/封鎖清單)。
- 接收端採用即時 CDP 注入,無需改寫 Chrome SQLite,Linux 上無需 Keychain。
- 支援 macOS arm64 與 Linux amd64/arm64 二進位檔。
使用情境
- 在 Linux VM 或自架伺服器上執行 AI 代理程式(例如 OpenClaw、Hermes、browser-use),這些代理程式需要以使用者身份存取需要 Cookie 認證的網站。
- 讓遠端代理程式執行環境的瀏覽器工作階段與使用者日常使用的 Mac 保持同步,無需手動匯出/匯入 Cookie。
- 從無頭 Linux 機器自動化操作 GitHub、Instacart 或 Google Workspace(非 DBSC 工作階段)等網站。
快速開始
在 Mac 與 Linux 上安裝二進位檔。先決條件:兩台機器皆需執行 Tailscale、安裝 Chrome,且 Linux 上的 Chrome 需以 --remote-debugging-port=9223 啟動。 bash # 在 Mac 上下載並安裝 curl -LO https://github.com/mvanhorn/agentcookie/releases/download/v1.0.0/agentcookie_1.0.0_darwin_arm64.tar.gz tar -xzf agentcookie_1.0.0_darwin_arm64.tar.gz sudo mv agentcookie /usr/local/bin/ # 在 Linux 上下載並安裝 curl -LO https://github.com/mvanhorn/agentcookie/releases/download/v1.0.0/agentcookie_1.0.0_linux_amd64.tar.gz tar -xzf agentcookie_1.0.0_linux_amd64.tar.gz sudo mv agentcookie /usr/local/bin/ # Mac 來源端設定:執行精靈 agentcookie wizard install --as source --peer # Linux 接收端設定:手動撰寫設定檔(詳見 README),然後啟動 agentcookie sink 詳細設定與 systemd 服務設定請參閱儲存庫 README。
授權與價格
本專案為開放原始碼,採用 MIT 授權。未提供價格資訊,可免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。