文件 v1.0.9

介紹

讓 AI 不只聊天,而是在你的電腦上把事做完

開源、單一 Go 執行檔,直接在你的電腦上運作。從查資料、處理檔案到建立自動化,Agenvoy 會實際執行工作;並可透過 MCP 與 Claude Code、Codex 等 Agent 共用安全沙箱工具。

台灣自研 AI Agent Harness

Agenvoy 為台灣自研的 AI Agent Harness,將對話轉化為在你的電腦上實際完成的工作。它在同一套流程中協調模型、工作脈絡、工具、即時資料、任務路由、記憶、排程與執行,同時讓檔案與環境的控制權留在你手上。透過 Web 介面,Agenvoy 也支援免持語音互動,包括自然說話、喚醒詞與可打斷的語音回覆;完整結果則會保留在聊天內容中。

為什麼選擇 Agenvoy

聊天能給答案,工作需要成果。Agenvoy 在你的個人電腦上把請求拆成步驟、呼叫工具並交付結果;檔案、工具、排程與工作脈絡始終由你掌控。

被驗證的設計

以下是 Agenvoy 已實作的設計方向,之後陸續也有其他團隊採用相近做法,印證這些方向能解決 Agent 在實際工作中遇到的問題。每個節點都附上公開的 commit 或發布紀錄,可自行對照。

你可以用它做什麼

問即時問題,拿到即時答案(Web Search/Tool Generate)

台北現在天氣如何?

Agent 會找即時資料、呼叫工具,再整理成答案回覆你。

如果缺工具,它會自己建立。

網路搜尋/工具生成示範

一句話變成自動化流程(Scheduler)

每天早上 8 點回報台積電股價

Agent 會確認:

  • 要推送到哪裡
  • 你想要什麼格式
  • 何時執行

然後自動建立排程。

排程示範

直接詢問你的本機檔案(File Search/RAG)

找出去年所有發票

哪份文件提到 Prompt guide?

Agent 會搜尋你的本機檔案並直接回答。

檔案搜尋/RAG 示範

完成多步驟工作(Skills/Sub-agents)

幫我整理今天的 GitHub commits,並生成進度報告

Agent 會拆解任務、呼叫工具、整合結果,再回覆給你。

Skill/子代理示範

能跟你已經在用的 Agent 一起工作(MCP Server)

Agenvoy 也是一個 MCP server。

Claude Code、Codex、OpenCode 與其他 AI Agent 連上後,可以:

  • 使用你所有的沙箱工具
  • 在缺工具時自動建立新工具
  • 讓所有 Agent 共用同一套工具

一行設定,即時共享工具庫。 影片中建立的工具:fetch_weather · fetch_crypto_price

Claude Code 建立天氣工具 (1) Codex 重用它並建立加密貨幣工具 (2) Agenvoy 測試兩個工具 (3)
Claude Code 建立天氣工具 Codex 重用它並建立加密貨幣工具 Agenvoy 測試兩個工具

適合誰使用

如果你希望 AI 不只回覆,而是能在你掌握的環境中完成工作,Agenvoy 適合你:

從瀏覽器操控你的 Agent

在瀏覽器管理 session、工具、排程與記憶。儀表板內建於執行檔中 — 啟動 daemon 後開啟 http://127.0.0.1:17989。由你自己的機器提供服務,資料不離開你的裝置。

Agenvoy Web 儀表板示範

聊天機器人整合

目前支援 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

建議的模型設定

以下是一組容易上手、成本較低的配置:

  1. 選擇一個訂閱制模型作為日常主要模型,例如:
    • GitHub Copilot($10/月)—— 指定 gpt-5.6-luna,額度損耗夠慢、能力也夠日常使用
    • OpenAI ChatGPT Plus($20/月)
    • SuperGrok($30/月)
  2. 想免費嚐鮮,以下兩種都不需要訂閱:
    • NVIDIA NIM:申請免費 API token,加入 nvidia/nemotron-3.5-lightning-30b-a3b。它不是大型模型,但足以體驗 Agenvoy。
    • Ollama Cloud:建立免費 API key,在 /model add 選擇 Ollama Cloud 後加入 gemma4:31b。免費方案有用量上限,可用 Shift+U 查看剩餘額度。

核心能力

能力 說明
自動工具生成 缺工具時自行建立並保存
自我排程 一句話建立定時任務
長期記憶 保留重要資訊與上下文
知識筆記 回答前先讀你留下的筆記
檔案搜尋 從本機檔案回答問題
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

本專案採雙授權。

歡迎 開 issue 分享想法。

EN