共计 3988 个字符,预计需要花费 10 分钟才能阅读完成。
更新:Open Duet 在 2026 年 11 月 9 日发布 0.8.5 时改名为 Suparagent,仓库搬到了 Anil-matcha/suparagent,旧地址目前仍会自动跳转。
Suparagent(原名 Open Duet)可以在自己的电脑上建立几个分工不同的 AI 助手,用来起草文字、保留常用信息、按计划生成内容。我这次接了一个本地运行的小模型,试着让它帮我换算时差、写一段约家人视频的微信。
它适合想尝试本地 AI 助手、愿意花一点时间安装的人,不是下载后就能代办一切的软件。先提醒一句:我这次接法能聊天、能运行定时任务,但不能替我操作电脑或发送微信,模型还算错了时间。涉及日期、金额等内容,仍要自己核对。
项目介绍:助手界面和回答问题的模型,要分别准备
Suparagent 负责管理助手、对话、记忆和例行任务;真正生成回答的 AI 需要另外连接。我用 Ollama 在本机运行 Qwen2.5 3B,没用付费模型订阅,但仍需要电脑空间、电力和下载流量。
这次是 2026 年 11 月 4 日下午(北京时间)的测试:Linux 电脑,8 核 CPU、15 GB 内存、没有独立显卡,Open Duet 0.8.1 预发布版。当前最新是 0.8.5,下面步骤是 0.8.1 时的 Linux 网页版路线。模型文件约 2.1 GB,项目装好后约 1.6 GB,下载前先留出空间。
安装步骤:先启动界面,再接上本地模型
第 1 步:准备工具并安装项目
需要 Git、Node.js 22 或以上版本、uv,以及 Ollama。Git 用来下载项目,Node.js 和 uv 负责准备运行环境,Ollama 用来运行本地 AI。先在终端检查:
git --version
node --version
uv --version
ollama --version
四条命令都显示版本号后再继续。缺哪项就先按对应工具的官方安装说明补齐;安装 Ollama 时若提示缺少 zstd,补装后再运行安装即可。
git clone --depth 1 https://github.com/Anil-matcha/suparagent.git
cd suparagent/desktop
npm run setup
npm run doctor
npm run build
等每条命令结束再执行下一条。setup 会下载需要的组件,doctor 用来检查缺什么,build 准备网页。我当时 setup 约 58 秒、build 约 34 秒,实际时间看网速和电脑。
在 build 之前,检查提示页面尚未构建,可以先完成 build。找不到 Claude 或 Codex,并不代表本地模型这条路不能继续,后面会单独连接 Ollama。项目仍在更新,若当前版本的步骤与这里不同,以仓库说明为准。
第 2 步:下载本地模型
ollama pull qwen2.5:3b
下载完成后,执行 ollama list,能看到 qwen2.5:3b,说明模型已经准备好。这个步骤可能比较久,不要把正在下载误当成卡死。
如果和我一样,报错里出现 redirect target not allowed 和 198.18.0.1,可以改用下面的本地文件方案。正常下载成功的人跳过这段。
下载失败时:从官方模型页面下载文件再导入
在单独的目录里完整执行下面这段。文件来自 Qwen 的 Hugging Face 仓库,约 2.1 GB;最后创建的模型名叫 qwen2.5-3b-local。
curl -L -o qwen2.5-3b-instruct-q4_k_m.gguf \
https://huggingface.co/Qwen/Qwen2.5-3B-Instruct-GGUF/resolve/main/qwen2.5-3b-instruct-q4_k_m.gguf
# 2,104,932,768 字节,我这边 1 分 36 秒
cat > Modelfile <<'EOF2'
FROM ./qwen2.5-3b-instruct-q4_k_m.gguf
TEMPLATE """{{- if .System }}<|im_start|>system
{{ .System }}<|im_end|>
{{ end }}{{- range .Messages }}<|im_start|>{{ .Role }}
{{ .Content }}<|im_end|>
{{ end }}<|im_start|>assistant
"""
PARAMETER stop <|im_end|>
PARAMETER num_ctx 8192
EOF2
ollama create qwen2.5-3b-local -f Modelfile # 5 秒
执行完再运行 ollama list,预期能看到 qwen2.5-3b-local。后面连接时选择这个名字,不要和正常下载的模型名混用。

第 3 步:准备本机配置并打开网页
回到下载的 suparagent 项目根目录。它和刚才的 desktop 不是同一层;如果终端仍停在 desktop,先执行 cd ..。
我这次在 backend/.env 中用了下面三项设置。已有其他配置请保留,不要整份覆盖。文件中系统自动生成的加密配置也要保留,不要复制别人的值。
DATABASE_BACKEND=sqlite
LOCAL_EXECUTION_ENABLED=true
LOOPBACK_TRUST=all
这组配置仅用于自己电脑上的本地试用。其中最后一项允许本机访问时免登录,不要拿去部署公网服务器,也不要把页面转发给别人访问。
bash scripts/dev.sh --no-bot
保持这个终端运行,在同一台电脑的浏览器打开 http://localhost:3000。预期看到新手引导页面。如果直接执行脚本提示 Permission denied,使用上面带 bash 的完整命令即可。
第 4 步:把 Suparagent 连接到模型
在连接 AI 的页面,选 OpenAI-compatible,也就是可以连接兼容服务的那张卡。地址填 http://127.0.0.1:11434/v1;我这次本机 Ollama 没设验证,Key 留空。点 Check again,状态变成 Ready 后,选择前面下载或导入的模型。

这条接法显示 Chat only; no tool calls,意思是能生成回答,但不能调用工具做事。我测试的这个版本里,本地兼容模型不支持工具、审批和团队主管;需要这些功能,就要按项目支持情况换用相应引擎,不能只看见 Ready 就当作全部能力都开了。

使用方法:建一个助手,先让它写一段草稿
第 1 步:写清助手负责什么
创建第一个助手时,可以选写作伙伴等模板,也可以自己填。我建立的是「时差管家」,用途是换算时间、起草约家人视频的微信,并要求用中文回答。

点「打开聊天」后,先检查输入框里的请求,再按发送。预期聊天页出现回复,我这次的小模型通常要等十几秒到二十多秒。这里的发送只是把问题发给模型,不是向微信联系人发消息。
第 2 步:用已知答案检查它靠不靠谱
我问的是:2026 年 11 月 7 日,多伦多周六晚上 8 点,在北京是几点?正确答案是北京时间 11 月 8 日周日早上 9 点,但它答成了 7 点。把时差直接告诉它以后,它还是加错了。


所以我不会直接拿它的结果约人。试用时先选一个自己能核对的小问题,检查日期、地点和数字,再决定要不要使用它写的文字。换一个模型也需要重新检查,不能把这次结果当成所有模型的表现。
第 3 步:保存常用信息,但仍要检查回答
我给助手的记忆文件写了三条信息:家人在北京、我假设住在多伦多、发给家人的时间统一写北京时间。我的测试助手文件位于 ~/.open-dots/local/workspace/agents/1/MEMORY.md,其中数字是这个助手的编号,其他助手不一定相同。
保存后开新对话再问,预期它能获得这些背景。实际测试里,页面出现 Recalled 2 passages,表示引用了两段旧对话,但旧对话里的错答也被带了回来。

如果历史对话里错误很多,可以先归档这些对话再开新对话,减少重复引用。这样不保证答案就正确,我归档后它仍把时间算成 7 点。记忆能保存信息,不等于模型一定会正确使用。
第 4 步:试跑例行任务
在例行任务中填写名称、执行时间、时区和要生成的内容。我试的是每周五晚生成一段约视频的微信草稿。先点 Run now 手动运行,预期出现一次任务记录,并能打开结果检查。电脑和后端需要保持运行,关掉后不会继续执行。
如果通过表单或请求填写星期时报 422,我这次的解决办法是把周五填成数字 5,不要填 fri;这一版本以 0 表示周日、6 表示周六。时间和时区按自己实际所在地选择。

我的任务约 7.3 秒完成,计划时间也算对了,但生成的草稿仍把约定时间改错。因此这一步只能证明任务能运行,不能证明写出的内容能直接发给家人。

想尝试的话,先做到「界面能打开、模型能回复、草稿能核对」就好。Suparagent 可以帮我组织几个不同用途的助手,但这次的 3B 模型还不足以让我放心交出需要准确计算的事情。项目说明和更新请看 官方仓库。




