allenpeng0705/EnvoyMesh

Decentralized P2P mesh for autonomous AI agents — self-sovereign identity, peer-to-peer chat, and on-device AI that negotiates tasks on your behalf. No central server.

EnvoyMesh – 面向 AI 代理的私有去中心化網格

是什麼 – EnvoyMesh 是一個在使用者自己裝置上運行的點對點（P2P）社交平台。它讓您聊天、通話、分享檔案，並托管個人知識庫，完全不需要任何中心化伺服器。每個節點都內建 AI 助手（EnvoyAI / OpenClaw），並可透過安全橋接連接外部 AI 引擎，使助手能代表您行動——例如協商任務、搜尋筆記或執行程式碼——同時您的加密身分（Ed25519 金鑰）始終由您掌控。

核心功能

類別	可執行操作
通訊	直接 P2P 文字聊天、群組房間、語音通話（WebRTC）、音訊筆記與內容位址檔案共享。所有訊息皆經過簽章，並通過四階段安全管道（真實性 → 信任清單 → 政策 → 重播防護）驗證。
AI 助手	內建的 EnvoyAI（OpenClaw）在節點上執行（埠 18789），可讀取您的保險庫、聯絡人並傳送訊息。您也可透過橋接連接一個外部 AI 引擎（HomeClaw、Hermes、OpenHuman 或任何 HTTP 相容代理），橋接會為每個請求簽章並執行政策檢查。
知識庫	應用內 Markdown 記錄，支援項目級別敏感度標籤，自動 RAG 重索引，以及可選的 Obsidian 插件，可將保險庫同步至網格中。公開筆記可被任何對等節點查詢；私有筆記則保留在本地。
代理網路	為團隊建立「艦隊」，向綁定的代理分配多階段任務，設定成本再平衡政策，並檢視詳細報告。市場可發現能力提供者並協商任務。
行動存取	EnvoyGo（Flutter）是 iOS/Android 的輕量型客戶端，透過 QR 碼與您的桌面主節點配對，讓您在行動裝置上實現聊天、AI、終端與語音通話。
家庭模式	一個主節點可托管多個使用者設定檔——每位家庭成員擁有獨立的 AI 歷史記錄與 UI 視圖，但共享相同的底層模型設定。

工作原理（概覽）

身分 – 每位使用者控制一個 Ed25519 金鑰對與 DID（去中心化識別碼）。金鑰永遠不會離開裝置。
網格 – 節點可直接連接或透過僅轉發加密信封的中繼連接；中繼從不讀取內容。
安全管道 – 每個信封皆經過簽章驗證、信任清單檢查、政策引擎過濾，並在交付前去重。
代理橋接 – 橋接將網格訊息轉換為一般 HTTP 供 AI 引擎使用。引擎永遠不會看到您的私鑰；EnvoyMesh 為所有出站訊息簽章並強制執行您的政策。
RAG – 當 AI 需要知識時，會查詢本地保險庫，並可將請求擴散至綁定節點的公開保險庫，再整合答案。

快速上手（使用者）

下載 – 從下載區域（或鏡像連結）取得 macOS、Windows 或 Linux 的桌面安裝檔。安裝並啟動後，應用會自動與專案作者綁定為初始聯絡人。
配對手機 – 從 App Store 或 Google Play 安裝 EnvoyGo，掃描桌面 UI 顯示的 QR 碼，即可在手機上獲得同步的個人檔案。
聊天與 AI – 使用社交 UI（從原始碼執行時為 http://localhost:5173）開始對話、建立房間，或向內建 AI 求助。
可選外部 AI – 執行相容的代理（如 hermes serve），並在 設定 → AI → AI 引擎 中啟用；橋接將把訊息轉發至外部服務。

快速上手（開發者）

# 克隆倉儲
git clone https://github.com/allenpeng0705/EnvoyMesh.git
cd EnvoyMesh

# 執行提供的設定腳本——它也會克隆兄弟倉儲 envoy-harness
./scripts/setup.sh   # Windows 上使用 .\scripts\setup.ps1

# 啟動節點與 Web UI
npm run node:dev      # P2P 節點
npm run social:dev    # 開啟 http://localhost:5173

此倉儲需要 Node ≥ 22.13、pnpm，以及兄弟倉儲 envoy-harness（編碼代理執行時）。桌面建置使用 Tauri（./scripts/build-desktop.sh）。

目前狀態

已準備就緒的 Beta 桌面應用 – 可下載的二進位檔已發布於 GitHub 發布頁。
行動客戶端（EnvoyGo） – iOS 18.6+ 與 Android 透過官方商店提供。
內建 AI（OpenClaw） 已可運作，以進程內方式執行；外部橋接支援已文件化，與三個內建預設相容。
知識庫整合（Markdown 編輯器、Obsidian 插件、聯邦 RAG）已實現。
路線圖項目 – 觀看通話、更豐富的市場功能、更多外部代理適配器已在指南書中列出。

哪些人可能需要？

希望社交網路與 AI 助手完全運行在自己硬體上的隱私導向使用者。
需要共享、自托管協作空間並具備 AI 驅動任務自動化的團隊或家庭。
對建構自訂 AI 代理或擴展網格（新知識庫外掛、替代外部代理等）感興趣的開發者。

TL;DR – EnvoyMesh 是一個全棧、自托管的 P2P 平台，結合了安全訊息、個人知識庫與可插拔 AI 代理，全部在使用者自己的加密身分下運行。