Agenvoy Wiki

Agenvoy 是一個能自行建立、測試並重用工具的本地 AI agent。單一 Go daemon 以統一介面對接各家 LLM 供應商，透過 Telegram / Discord / TUI / 瀏覽器與你互動，排程週期性工作、搜尋本機檔案，並經由 MCP 將整套工具庫開放給其他 agent。

亮點

• 十二個 LLM 供應商 — OpenAI、Codex（OAuth）、Claude、Gemini、Grok（API key 或 OAuth）、GitHub Copilot、DeepSeek、NVIDIA NIM、OpenRouter、Cloudflare 與 Compat（任何 OpenAI 相容端點，Zed 風格 /v1 URL），全部由外部模組 go-llm-router 承載
• Dispatcher 路由 — dispatcher LLM 將各任務路由至最適配的 worker，並在供應商失敗時套用 per-model cooldown 與 fallback
• 三階段並行工具派送 — 讀取類工具並行扇出；寫入類工具為安全維持序列
• 多層記憶 — 滾動摘要（增量、以時間戳為游標）+ 24 則近期歷史 + 關鍵字／語意雙搜尋 + 90 天 TTL 的跨 session 錯誤記憶，另有依各模型 context window 調整的執行期壓縮管線
• 原生文件 RAG — KuraDB 子行程（list_rag / search_rag），透過 TUI /kuradb 啟用
• Skill 系統 — 可載入的 markdown skill 包，由 /skill-name 或 run_skill 觸發；同時掃描 Agenvoy 自身儲存與 Claude / Codex / OpenCode / OpenAI 的 skill 目錄
• 工具自我擴充 — 當現有工具無法涵蓋需求時，agent 會撰寫、沙箱測試並版本控管新的 script_* / api_* 工具
• OS 沙箱 — Linux bubblewrap / macOS sandbox-exec；argv-only 指令、裸名稱 allowlist、經解析的 sh -c 驗證
• MCP 客戶端與伺服器 — 建構於官方 modelcontextprotocol/go-sdk 的單一套件；對內即時刷新工具清單，對外以 mcp__<server>__<tool> 註冊
• 聊天平台整合 — Telegram（6 位數 OTP 首次接觸驗證）+ Discord（原生 select menu / modal）；透過 send_to_chatbot 跨 session 推播
• 語音與附件 — [SEND_VOICE:text] 送至 Gemini TTS（OGG/OPUS）；收到的附件存入 download 目錄
• Subagent — invoke_subagent 以 in-process 方式在只收集憲章下執行，最多 3 條並行，用量匯總回母 session
• 排程 — cron / 一次性任務、fsnotify 熱重載、輸出推回 Telegram / Discord
• 本機 HTTP API — 相容 OpenAI 的完成端點，加上僅限 localhost 的模型、session、MCP server、排程、允許清單與 KuraDB 管理

原始碼

• Repository：pardnchiu/Agenvoy