爱意满满的作品展示区。
veotax

OpenAgent:单文件版龙虾——仅有一个文件,双击就能跑的高性能 Agent

  •  
  •   veotax ·
    PRO
    · May 16 · 14739 views

    Hi V 友们,我是 OpenAgent 团队的开发者。

    今天想给大家介绍一个我们打磨了很久的项目 —— OpenAgent,一个面向个人开发者和极客的开源本地 AI Agent 。定位跟 OpenClaw 、Hermes 类似,都是「个人本地助手」这个赛道,但我们走了一条完全不同的路:用 Go 语言写成一个单文件二进制,下载 exe 双击就能跑,零配置开箱即用

    一句话定位:开箱即用的单文件本地 Agent ,效果更稳、延迟更低、资源占用更少。

    GitHub:github.com/the-open-agent/openagent(求 Star ⭐)

    官网:openagentai.org


    一、为什么做这件事

    现在用 AI 干活的人越来越多 —— 不只是写代码,做 PPT 、跑脚本、查资料、整理文档,大家都在用 Agent 。但用过一段时间,绝大多数人都会撞上同一堵墙:部署成本

    市面上不少「知名」 Agent 是结构性的依赖怪兽 —— 一个完整环境下来,Node.js 、Python 、Docker 、WSL 层层嵌套。问题往往不在模型本身,而在 Agent 的交付形态:依赖膨胀、文件散落数万、配置繁琐、迁移困难。每一层都在消耗用户耐心,月底还要被账单教育一次。

    OpenAgent 的取舍从第一天就很明确:把「单文件零配置」做成顶层设计目标,而不是事后打的补丁。我们选了一条更硬核的路 —— 用 Go 从零写成一个单二进制文件,没有运行时依赖,没有安装器,没有 Docker 。前端的 React 直接 embed 进二进制里,后端就是纯 Go ,一个进程监听 14000 端口。

    这就是今天的 OpenAgent 。


    二、不止轻量 —— 这是一个完整的 Agent 工作平台

    OpenAgent 不只是一个跑得快的单文件,配套的是一整套日常工作流要用的能力:

    • 🤖 30+ 模型提供商:OpenAI 、Claude 、DeepSeek 、Gemini 、Mistral 、Grok……随时切换,无需改代码
    • 🌐 Browser-Use:驱动真实浏览器,导航、点击、填表、截图
    • 🖥️ Shell Execution:本地命令执行,支持 PTY 交互式会话
    • 📄 Office 自动化:读写 Word 、Excel 、PowerPoint
    • 🔗 MCP 集成:任意 MCP 兼容服务器即插即用
    • 📚 RAG 知识库:PDF/Word/Excel 自动切片、嵌入、索引
    • ⚡ 工作流编排:BPMN 风格可视化拖拽编排
    • 📊 管理后台:Token 用量统计、活动监控、工具管理、请求日志

    三、直接亮数据:效果与延迟横评 OpenClaw

    架构做完了,效果到底怎么样?我们花了十多天做横向评测,把 OpenAgent 和 OpenClaw 拉到同一条起跑线。统一用 deepseek/deepseek-v4-flash 作为底层模型,这是目前性价比较高的模型,最容易暴露各家 Agent Harness 的真实水平。

    3.1 Agent Tool 调用对标(核心效果)

    12 个任务 × 3 轮 = 36 次计分,统一模型、统一 prompt:

    指标 OpenAgent OpenClaw
    成功率 **83.33%**( 30/36 ) 61.11%( 22/36 )
    平均耗时 14,183 ms 26,128 ms
    平均 Token 1,312 2,362
    合规率 90.0 76.67
    覆盖率 97.5 91.67
    综合分 91.14 78.41

    一句话总结:成功率更高、速度更快、Token 更省。OpenAgent 每轮平均耗时比 OpenClaw 少约 11.9 秒,Token 消耗少约 1,050 。36 轮真实执行,判分由自动化脚本完成,无人工干预。

    3.2 对话场景性能

    指标 OpenAgent OpenClaw
    完成率 100% 95%
    格式正确率 100% 82.5%
    事实准确率 100% 92.5%
    平均延迟 3,991 ms 26,781 ms

    OpenAgent 在对话场景下完成率、格式正确率、事实准确率均达到 100%,平均延迟约 4 秒; OpenClaw 平均延迟约 26.8 秒。

    3.3 项目本体性能

    维度 OpenAgent OpenClaw
    冷启动就绪 ~2.7 s ~29.2 s
    常驻内存 ~110 MB ~215–307 MB
    安装体积 exe ~23 MB ~382 MB / 42,000+ 文件
    TTFT (首包延迟) ~23 ms ~44 ms

    冷启动:OpenAgent 中位数 2.7 秒就能通过 health 检查返回 HTTP 200 ,OpenClaw 需要 29.2 秒。

    体积:OpenAgent 单文件约 23 MB ,OpenClaw 整块目录约 382 MB ,文件数超过 4 万。这不是「精简功能换体积」,而是 Go 静态编译 + 前端 embed 的架构优势。

    内存:空闲状态下 OpenAgent 约 110 MB ,OpenClaw 约 215–245 MB 。压测后 OpenAgent 约 120 MB ,OpenClaw 约 307 MB 。


    四、凭什么效果更好、延迟更低 —— 3 个工程决策

    不是「砍功能换性能」,是每一层都做对了选择。

    ① Single Binary:一个文件,零依赖

    Go 静态编译,前端 React build 后直接 embed 进二进制。Windows 用户下载 exe 双击就能跑,不需要 WSL 、不需要 Docker 、不需要 Node.js 。Mac/Linux 一条命令安装。这才是「个人本地 Agent 」该有的交付形态。

    ② Shell 执行带边界,安全可控

    源码层面,tool/shell.go 定义了默认超时 30 秒、最大 300 秒、PTY 可选、会话式 poll/write/submit 等机制。Shell 能力在默认实现上是强约束的生产向工具,而非无限制远程执行。同时支持审计日志、SSO 、请求日志等企业级可观测性。

    ③ Go 原生并发,内存可控

    Go 的 goroutine + channel 模型让高并发场景下的内存增长非常克制。80 路并发 health 压测,内存仅增长 10 MB 。对比 Node.js 的内存曲线,这是语言层面的结构性优势。


    五、坦白说几句,欢迎来挑战

    离「完美」还有多远,先把几件事说清楚:

    1. Lighthouse 综合分:OpenClaw 87 分,我们 45 分。这是前端加载性能,我们用的 Lighthouse 11 版本与 OpenClaw 测试版本可能不同,分数不宜跨版本强比。但确实说明我们的前端还有优化空间。
    2. 顺序 health P50:OpenClaw 约 20 ms ,我们约 33 ms 。毫秒级差距,对个人本地 Agent 参考意义有限。
    3. 配置前提:聊天 API 需要 Authorization: Bearer <provider_key>,不是「完全零步骤」。但相比装 Node.js 、配 Docker 、拉数万文件,我们的摩擦已经降到极低。

    欢迎你来挑战

    • 下载 OpenAgent ,用你自己的 OpenRouter Key
    • 跑同样的 prompt 对比账单
    • 跑出比我们更快/更省的,欢迎 PR ;跑出我们更贵的,提 issue 我们改

    六、关于 Go 重写

    可能有朋友会问:做 AI Agent 不是 Python 的天下吗,怎么用 Go ?

    Agent 的瓶颈在 LLM 调用而非语言性能 —— 决定一个 Agent 跑得好不好的,是 Harness 层的架构设计,不是底层语言的执行速度。Go 的优势在于:静态编译单文件、内存可控、并发模型简洁、跨平台原生支持。这些特性对于「个人本地 Agent 」这个场景来说,比 Python 的动态灵活性更重要。

    我们用 Go 写了三个月,从零到一,做出了这个内核。


    七、谁用谁爽 —— 几类典型场景

    🔧 程序员 / 开发者:CLI 形态直接替代 Claude Code ,BYOK 用自己的 Key ,本地 Shell 、Browser 、Office 工具一键调用。

    🏠 个人用户 / 极客:同样的机器配置,原本跑一个 Agent 就卡,现在能轻松跑多个 —— 内存占用不到同类的一半。

    💼 自由职业者 / 一人公司:做客户提案、写咨询报告、出竞品分析、整理材料 —— 本地跑,数据不出本机,省下来的就是安全感。


    八、怎么上手

    Windows (最省心,推荐)

    • GitHub Releases 下载 openagent_windows_x86.exe
    • 双击即用,环境/依赖全自动就位
    • 打开 http://localhost:14000

    macOS / Linux / WSL

    curl -fsSL https://raw.githubusercontent.com/the-open-agent/openagent/master/scripts/install.sh | bash
    

    Windows PowerShell

    irm https://raw.githubusercontent.com/the-open-agent/openagent/master/scripts/install.ps1 | iex
    

    模型怎么接

    • 项目启动前端界面一键配置,支持几乎所有主流大模型,包括本地部署的模型。
    • 下载与文档:openagentai.org

    九、最后

    OpenAgent 是 Apache 2.0 开源项目,代码全在 GitHub 上,欢迎审阅、欢迎 Star 、欢迎提 issue 。

    我们坚信:个人本地 Agent 的未来,不是越来越重,而是越来越轻。 一个文件,双击即用,这才是用户真正想要的。

    GitHub:github.com/the-open-agent/openagent

    测评集代码:github.com/the-open-agent/agentbench

    QQ 群:963536134

    47 replies    2026-06-02 10:22:28 +08:00
    zisen
        1
    zisen  
       May 16
    自选 baseurl 的情况下,openai 兼容格式的 DeepSeek 或者 GLM 都不支持呀
    xinyana
        2
    xinyana  
       May 16 via Android
    支持,openclaw 太重了
    coosir
        3
    coosir  
       May 17
    支持!一直觉得这种 Agent 场景关键在于架构设计,在实现上非常适合用 Go 来做不需要消耗本地太多资源
    zgs1983
        4
    zgs1983  
       May 17
    有没自主学习功能?
    glouhao
        5
    glouhao  
       May 18 via Android
    是不是更适合塞优盘偶尔做下系统维护
    spediacn
        6
    spediacn  
       May 19 via iPhone
    浓浓的 Gpt 味道
    scyuns
        7
    scyuns  
       May 19 via Android
    我发现我居然给你点过 star 了
    zzl22100048
        8
    zzl22100048  
       May 19
    不支持自定义模型,统计 token 的逻辑没有给降级
    xml123
        9
    xml123  
       May 19
    这个支持 llama.cpp 的本地模型吗?
    veotax
        10
    veotax  
    OP
    PRO
       May 20
    @zisen @zzl22100048 最新版本已经修复了自定义 Open AI 兼容模型的支持,token 统计逻辑也完善了
    veotax
        11
    veotax  
    OP
    PRO
       May 20
    @xml123 支持,选择“自定义 Open AI 兼容模型”就行

    @zgs1983 有,已完成会话会作为新的 skill 保存

    @glouhao 这个可以有
    qxmqh
        12
    qxmqh  
       May 20
    刚才我下载源码跑了一下,有几个问题,我用的 Safari 打开前端直接报错,504 ,我用 Chrome 打开,没问题,点击左侧菜单容易出现报错一闪而过 在页面上,并且容易出现菜单跳动,点击 A 菜单,然后再点击 B 菜单,页面刷新还是 A 菜单。配置的模型页面这里我感觉有些状态判断有问题,知识库这里文件上传之后,向量这里配置,所有的问号都没法显示出来帮助说明。一头雾水,这个知识库在本地如何使用。我搭建过其他知识库,说明很清晰,这里我感觉你们需要仔细优化细节。
    zuokanyunqishi
        13
    zuokanyunqishi  
       May 20
    能和 hermes 比嘛,有没有适配接入各个 IM
    dong706
        14
    dong706  
       May 20
    意思这是一个可以放到 U 盘上的龙虾?
    chnwine
        15
    chnwine  
       May 20
    现在 go 语言版的 openclaw 也有比较活跃的
    https://github.com/sipeed/picoclaw
    https://github.com/nextlevelbuilder/goclaw

    想知道咱们这边是侧重的哪块
    darksword21
        16
    darksword21  
    PRO
       May 20
    再加个多租户....
    kkwwuuww
        17
    kkwwuuww  
       May 21
    支持 Github Enterprise 吗
    veotax
        18
    veotax  
    OP
    PRO
       May 22
    @zuokanyunqishi #13 已经适配了,pipes 就是龙虾的 channels

    @dong706 对的
    sunzhuo
        19
    sunzhuo  
       May 23
    有意思,试试看看
    openaii
        20
    openaii  
       May 23
    最新模型为什么都不支持 gpt5.5 ,opus4.7
    openaii
        21
    openaii  
       May 23
    feat: add GPT-5.5 model support
    直接被 close 了
    liuxyon
        22
    liuxyon  
       May 23
    为什么不能自动获取模型列表,必须要手工设置模型?
    sunzhuo
        23
    sunzhuo  
       May 23
    不能添加 openrouter 中的任意模型吗?只能添加内置的几种模型,比较旧了
    liuxyon
        24
    liuxyon  
       May 23
    应该是加入 API 后可以自动获取所有模型列表,使用的时候可以选择使用哪个提供商和什么模型
    liiuyr
        25
    liiuyr  
       May 24
    gpt 5.5 配不了。。
    ala2008
        26
    ala2008  
       May 25
    别的不说,为什么没有中文 readme 啊。这还是中国吗
    veotax
        27
    veotax  
    OP
    PRO
       May 25
    @openaii @liiuyr GPT 5.5 已经支持了
    skuuhui
        28
    skuuhui  
       May 26
    @ala2008 claude code 没给生成中文版的 readme 啊
    skuuhui
        29
    skuuhui  
       May 26
    我觉得这个也是重复造轮子。让 ai 分析一下所有你觉得是特点的地方,其实都是 1 ~ 99 ,没有什么革新性的变化。这种产品,近似完成度,我一个月能生成 10 个,用不同语言。
    01802
        30
    01802  
       May 26 via Android
    感觉类似之前火的 picoclaw ,那个也能用
    lel020
        31
    lel020  
       May 27 via Android
    找不准竞品的项目我通通看衰,
    明明是 picoclaw 的赛道你不和 picoclaw 比,甚至只字不提,只能认为没有优点,
    veotax
        32
    veotax  
    OP
    PRO
       May 27
    @chnwine @01802 @lel020 PicoClaw 主要是面向嵌入式设备,受限于硬件运行环境,功能较精简,比如缺乏 RAG 知识库功能,工具调用部分也缺乏浏览器和 Office 文件操作。OpenAgent 则更多面向 PC 端用户,主打傻瓜式部署、全功能平台。支持作为个人 AI 助手,也可以对接企业 SSO 变成企业级工具,工具调用也更强大,内置浏览器、Office (写 word 文档、写 PPT )等常见办公功能,同时 web UI 也更强大、美观
    lel020
        33
    lel020  
       May 28
    @veotax #32 你这种语句通顺内容空洞的 AI 回复很让人怀疑你的专业性,真的是有坑你就踩,
    veotax
        34
    veotax  
    OP
    PRO
       May 28
    @lel020 麻烦不要无脑喷,有技术问题可以讨论,谢谢
    cheese
        35
    cheese  
       May 28   ❤️ 1
    你好歹把文档中文化一下,用 llm 翻译下又不费劲。
    windows 下运行结束之后,一点引导都没有,运行过程也没让配置任何东西,默认密码也不知道,翻半天文档也没看见,最后去翻源码发现居然是 123 。
    webUI 界面点击文档,打开的是 http://localhost:14000/swagger/index.html 然后报错
    5k star 的项目做成这样我是没想到的 就这个首次打开不强制引导更改默认密码这件事,就让我不敢再用了
    cheese
        36
    cheese  
       May 28
    @cheese 命令行里回答完整生成了,webUI 里截断了
    utodea
        37
    utodea  
       May 28
    我这个 DeepSeek native CLI 也是 Go: https://github.com/usewhale/DeepSeek-Code-Whale

    但回头看,用 Go 并不是一个好的选择,特别是 TUI 上很多问题,也不够成熟。
    5wunian
        38
    5wunian  
       May 28
    5K star 之前公司花钱买 star ,刷星数。只需要提供几百个邮箱注册 star ,你可以刷上去。这就是灰产。有些比赛也是这样,暗箱操作。
    01802
        39
    01802  
       May 29 via Android
    @veotax 面向嵌入式也只是 pico 早期的某个行为,现在你说得那些 pico 哪个没有啊....
    bbis
        40
    bbis  
       May 29 via iPhone
    我新开了个 qnap 的插件 qnap-agent ,用的 picoclaw 单文件二进制版本,这个和你们的产品有什么区别?说不定后期可以改用这个
    veotax
        41
    veotax  
    OP
    PRO
       May 29
    @bbis picoclaw 好像是主打嵌入式部署的?跟 openagent 的定位也不一样呀。picoclaw 它们主打轻量,目前功能/工具什么的就做不到很全。比如 browser-use 它们就没有: https://github.com/sipeed/picoclaw/issues/293
    而且貌似开发也没有很活跃,像这个浏览器工具的 issue 二月份提的,现在还没有做好
    zuokanyunqishi
        42
    zuokanyunqishi  
       May 30
    试用了下,就卸载了,
    whyiyhw
        43
    whyiyhw  
       4 days ago   ❤️ 1
    @utodea 我也做了一个类似的,seek 我觉得体验还行,TUI 有瑕疵,但是目前来说没什么好办法, 体验还可以,不要用 cmd 跟 powershell, 用 microsoft/terminal ,体验跟 mac 类似,也可以做 web/ app 包一层,目前 人力实在是不够
    utodea
        44
    utodea  
       3 days ago
    感谢。很久不用了 wins, 我看看 microsoft/terminal 。

    “目前 人力实在是不够”,同感,势单力薄。要做到可用,工程量还挺大的。我这折腾了一个月,感觉终于快走出 Demo 期了。
    Nois9527
        45
    Nois9527  
       3 days ago
    单文件的话配置放哪? 支持外部配置文件吗。一点都不想搭想拿到新环境就直接用
    unknow1
        46
    unknow1  
       3 days ago
    前几天做知识库项目选型,发现了这个 openAgent ,但是 ollama 本地模型对接后几乎无法使用,就是目前的版本,测试了好几次都不行,后来换了其他知识库 Agent 。目前来看这个项目还不太成熟,不过你们的定位还是挺吸引人的:开箱即用的单文件本地 Agent ,希望你们越做越好~
    unknow1
        47
    unknow1  
       3 days ago
    简单看了下,在查询模型列表时,local.go 里 ListModels 方法:if p.typ == "Ollama" 分支没有进去,具体原因没有继续探查。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   1061 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 108ms · UTC 23:11 · PVG 07:11 · LAX 16:11 · JFK 19:11
    ♥ Do have faith in what you're doing.