介紹
讓 AI 不只聊天,而是在你的電腦上把事做完
開源、單一 Go 執行檔,直接在你的電腦上運作。從查資料、處理檔案到建立自動化,Agenvoy 會實際執行工作;並可透過 MCP 與 Claude Code、Codex 等 Agent 共用安全沙箱工具。
台灣自研 AI Agent Harness
Agenvoy 為台灣自研的 AI Agent Harness,將對話轉化為在你的電腦上實際完成的工作。它在同一套流程中協調模型、工作脈絡、工具、即時資料、任務路由、記憶、排程與執行,同時讓檔案與環境的控制權留在你手上。透過 Web 介面,Agenvoy 也支援免持語音互動,包括自然說話、喚醒詞與可打斷的語音回覆;完整結果則會保留在聊天內容中。
為什麼選擇 Agenvoy
聊天能給答案,工作需要成果。Agenvoy 在你的個人電腦上把請求拆成步驟、呼叫工具並交付結果;檔案、工具、排程與工作脈絡始終由你掌控。
- 把對話變成可交付的工作 — 從查即時資料、整理檔案到執行多步驟任務,Agent 會實際動手並回報結果。
- 能力不足時自己補上 — 找不到合適工具時,可建立、測試並保存新工具,下一次直接重用。
- 一套工具供所有 Agent 使用 — Agenvoy、Claude Code、Codex 等 Agent 可共用同一套沙箱工具庫,不必重複建立。
- 讓自動化持續運作 — 一句話建立排程,定期工作可在你的環境中執行並推送結果。
- 每一步都看得見、控得住 — 命令輸出同步顯示於 TUI 與 Web 儀表板;敏感路徑與受限操作仍須確認。
- 模型與外部服務可自由整合 — 依任務路由模型,支援圖片、STT、TTS、stdio/HTTP MCP 與 OAuth。
- 從任何地方私下存取 — Telegram 與 Discord 由本機 daemon 主動連線,不必公開主機或開放入站連接埠。
被驗證的設計
以下是 Agenvoy 已實作的設計方向,之後陸續也有其他團隊採用相近做法,印證這些方向能解決 Agent 在實際工作中遇到的問題。每個節點都附上公開的 commit 或發布紀錄,可自行對照。
你可以用它做什麼
能跟你已經在用的 Agent 一起工作(MCP Server)
Agenvoy 也是一個 MCP server。
Claude Code、Codex、OpenCode 與其他 AI Agent 連上後,可以:
- 使用你所有的沙箱工具
- 在缺工具時自動建立新工具
- 讓所有 Agent 共用同一套工具
一行設定,即時共享工具庫。 影片中建立的工具:
fetch_weather·fetch_crypto_price
適合誰使用
如果你希望 AI 不只回覆,而是能在你掌握的環境中完成工作,Agenvoy 適合你:
- 想把研究、檔案處理、例行回報轉成可重用自動化流程的人
- 想自架 AI Agent,同時保有本機資料與沙箱安全邊界的開發者
- 想讓 Claude Code、Codex 與其他 Agent 共用工具、避免重複建置的團隊
- 需要透過 Web、Telegram 或 Discord 私下存取本機 Agent 的技術工作者
從瀏覽器操控你的 Agent
在瀏覽器管理 session、工具、排程與記憶。儀表板內建於執行檔中 — 啟動 daemon 後開啟 http://127.0.0.1:17989。由你自己的機器提供服務,資料不離開你的裝置。
聊天機器人整合
目前支援 Telegram 與 Discord。Agenvoy 的本機 daemon 會主動連向這些平台,因此你只要設定 bot token:不必開放入站連接埠、不必架反向代理,也不必把自己的主機公開到網路上。
自 v0.34.4 起,Telegram 與 Discord 暫停「語音輸入後自動以語音回覆」的預設流程;仍可使用 STT/TTS 生成音訊,並將音訊檔傳送到頻道。
一鍵安裝
macOS/Linux 發行版
在終端機執行:
curl -fsSL https://agenvoy.com/scripts/install.sh | bash
macOS 提示: 若使用 MacBook 執行排程,建議額外執行:
sudo pmset -c sleep 0避免電腦休眠而中斷排程。
Windows(透過 WSL)
請先以系統管理員身分開啟 PowerShell,查看並安裝一個 Linux 發行版:
wsl --online --list
wsl --install <發行版名稱>
完成安裝、重新開機並進入 WSL 終端機後,執行:
curl -fsSL https://agenvoy.com/scripts/install.sh | bash
建議的模型設定
以下是一組容易上手、成本較低的配置:
- 選擇一個訂閱制模型作為日常主要模型,例如:
- GitHub Copilot($10/月)—— 指定
gpt-5.6-luna,額度損耗夠慢、能力也夠日常使用 - OpenAI ChatGPT Plus($20/月)
- SuperGrok($30/月)
- GitHub Copilot($10/月)—— 指定
- 想免費嚐鮮,以下兩種都不需要訂閱:
- NVIDIA NIM:申請免費 API token,加入
nvidia/nemotron-3.5-lightning-30b-a3b。它不是大型模型,但足以體驗 Agenvoy。 - Ollama Cloud:建立免費 API key,在
/model add選擇 Ollama Cloud 後加入gemma4:31b。免費方案有用量上限,可用Shift+U查看剩餘額度。
- NVIDIA NIM:申請免費 API token,加入
核心能力
| 能力 | 說明 |
|---|---|
| 自動工具生成 | 缺工具時自行建立並保存 |
| 自我排程 | 一句話建立定時任務 |
| 長期記憶 | 保留重要資訊與上下文 |
| 知識筆記 | 回答前先讀你留下的筆記 |
| 檔案搜尋 | 從本機檔案回答問題 |
| Sub-Agent | 多 Agent 協作 |
| MCP client | 以官方 go-sdk 連接外部 MCP 服務(工具清單即時刷新) |
| MCP server | 讓任何 MCP 相容 Agent 使用你的沙箱工具 |
| 推理指引 | 透過 reasoning_guide(topic=...) 按需載入規則 |
| Tool Market | 分享與安裝工具 |
| 圖片生成 | 透過已設定的 provider 生成圖片 |
| 即時命令輸出 | 將 run_command 進度串流至 TUI 與 Web 儀表板 |
| 安全檔案邊界 | 存取敏感路徑或 $HOME 外路徑前要求確認 |
| MCP OAuth | 登入 HTTP MCP server,並將 token 保存至作業系統 keychain |
| 語音轉錄 | 音訊與影片轉文字 |
| 自我改進 | 執行失敗後自動修正 |
文件
License
本專案採雙授權。
- 開源授權 — GNU Affero General Public License v3.0。可自由使用、修改與散布,但衍生作品與基於本專案提供的網路服務,須以相同授權釋出並提供原始碼。
- 商業授權 — 無法滿足 AGPL-3.0 原始碼公開義務的使用情境,可洽詢商業授權,詳見 COMMERCIAL.zh.md。
歡迎 開 issue 分享想法。


