modelflare-ai/AnyModelBot · 上手攻略

  • 仓库：modelflare-ai/AnyModelBot
  • 链接：https://github.com/modelflare-ai/AnyModelBot
  • 分类：engineering / agent / llm-infra
  • 作者：spark
  • 更新：2026-11-03

一、它是什么

AnyModelBot 是一个本地优先的开源个人 AI 智能体应用（MIT 许可，TypeScript + Electron 桌面外壳）。它的定位是"常驻的个人 AI 智能体"——你在自己的电脑或服务器上养若干个"机器人"，每个机器人有自己的人设、默认模型、工作区和记忆；它能在后台替你跑长任务、定时规则，需要你拍板时再来问你。

项目自我定位为 xAI Grok Bot、OpenAI dots、Anthropic Claude Duet 这类"常驻智能体"的开源替代品。关键差异有三条：开源（MIT）、跑在你自己设备上、模型不绑定订阅——它自身没有订阅费，模型走 Modelflare 网关按 token 计费，支持 GPT、Claude、Gemini、Grok、DeepSeek、Kimi、GLM 等 70+ 模型。

技术栈是自研外壳 + 上游开源件拼装：界面用 Preact + htm（无构建步骤），后端 Node.js 22.13+ / TypeScript / node:sqlite，桌面外壳 Electron（带托盘），模型网关是随包编译的 Go 项目 magpie，智能体运行时是独立进程运行的 DeepSeek Harness，电脑操作由 Cua Driver 提供，记忆与上下文管家借鉴了 DS Bot。

截至 2026-11-03，最新 release 是 v0.1.18（发布于当天），README 里标注的成熟度为 experimental。仓库 star 数 1.6k+，但增速极快——Trendshift 记录显示 10-31 到 11-02 三天就涨了约 1,217 star，说明正处爆发期。

二、解决什么问题

市面上的"常驻智能体"（Grok Bot / dots / Claude Duet）全是闭源云端产品：智能体跑在厂商的云电脑里，模型锁死在自家订阅，账号体系在别人手上。AnyModelBot 想解决三件事：

  1. 智能体跑在哪：你希望它在你的机器上，能读写你的文件、执行你的命令、操作你的桌面，而不是在别人的云端容器里。
  2. 模型怎么选：你希望今天用 GPT、明天切 Claude、后天用 DeepSeek，而不是被绑死在一家。
  3. 渠道在哪聊：你希望它出现在你已经用的 IM 里（微信、飞书、Telegram、Slack、Discord），而不是再开一个网页。

它给的答案是：一个跑在你本机的多机器人智能体宿主，通过 Modelflare 这一个 Key 打通所有模型，通过 IM 渠道触达你。附带一整套"不打扰"的细节——免打扰时段、主动消息每日上限、任务/规则预算上限、30 天自动清理。

三、快速安装

方式 A：下载预编译包（推荐）

从 Releases 下载。当前 v0.1.18 提供六个平台包：

  • Windows：anymodel-bot-0.1.18-win-x64.exe / -win-arm64.exe
  • macOS：anymodel-bot-0.1.18-mac-arm64.dmg / -mac-x64.dmg
  • Linux：anymodel-bot-0.1.18-linux-x86_64.AppImage / -linux-arm64.AppImage

校验（每个 release 都附 SHA256SUMS）：

sha256sum -c SHA256SUMS --ignore-missing
# macOS 用 shasum -a 256 <文件名>
# Windows PowerShell 用 Get-FileHash <文件名>

首次打开会被系统拦：Windows 点"更多信息 → 仍要运行"，macOS 在"系统设置 → 隐私与安全性"点"仍要打开"，Linux 先 chmod +x 再运行。关闭窗口是收进托盘，不是退出，要真正退出得走托盘菜单。

方式 B：Docker 部署到 NAS / 服务器

docker run -d --name amb -p 3600:3600 -v amb-data:/data ghcr.io/modelflare-ai/anymodel-bot
docker exec amb cat /data/ui-token   # 打开 http://<主机>:3600/?token=<令牌>

容器内界面监听 0.0.0.0，因此强制令牌访问；README 明确警告不要把 3600 端口直接暴露到公网。Docker 场景下浏览器登录回调收不到，首次启动页改为手填 API Key（校验 GET https://modelflare.dev/v1/models）。

方式 C：从源码运行

需要 Node.js 22.13+ 和 Go 1.26.8+：

git clone https://github.com/modelflare-ai/AnyModelBot.git
cd AnyModelBot
npm install
npm run setup   # 拉取并编译内置网关（vendor/magpie 子模块）
npm run init    # 可选：终端首次设置（登录 Modelflare 或粘贴 Key、飞书凭据）
npm start       # 管理界面 http://127.0.0.1:3600/

开发模式跑桌面版用 npm run electron:dev；构建镜像前需 git submodule update --init --depth 1 vendor/magpie 再 docker build -t anymodel-bot .。

四、核心用法

登录与模型选择。 首次启动会打开浏览器让你登录（或注册）Modelflare，授权回调到本机 127.0.0.1 的临时端口（OIDC 授权码 + PKCE，RFC 7636 / RFC 8252 公共客户端模式，client_id 为 anymodel-bot，无客户端密钥），之后应用自动为这台设备签发专用 API Key 并连接，不需要你复制粘贴。模型选择器里每个模型都标注上下文长度、视觉/工具/推理能力标记，以及每百万 tokens 输入输出的参考价。可按对话临时切模型，也可给机器人设默认模型。

建机器人。 一个机器人 = 人设 + 默认模型 + 工作区 + 记忆。人设就是一段话，六个头像只管长相。权限三档：只读 / 工作区（默认，只能写自己的文件夹，越界先问你）/ 完全权限（不进沙箱，但递归删除仍会先问）。

在 IM 里找它。 设置 › 连接 里添加账号（全局一份，所有机器人共用，同一服务可加多个并起别名）。微信扫码连接（收发图片和文件），飞书走长连接 + 流式卡片，Telegram/Slack/Discord 填 token 即可，不需要公网地址（分别是长轮询、Socket Mode、Gateway）。在聊天软件里发 /bot 名字 切换机器人。斜杠命令如 /model、/reset 在应用和各渠道通用。

后台任务。 说一句"后台做"就开一个后台任务，你可以接着聊别的；做完把结果发回原对话。在微信里引用结果、在飞书里回复那条消息，就是继续追问这个任务。

规则（定时任务）。 "每天早上 8 点看看 X 的价格，低于 200 告诉我"会建成一条规则。有个"先观察"模式：只记下本会说什么，不发消息、不改文件，看过几次再改成执行。

"需要你"面板。 所有机器人等你回答、批准或重试的事都聚在这一行，没事时这行不出现。越界操作会停下来等你点头。

电脑操作。 由内置 Cua Driver 提供，默认自动执行；把机器人切到"改变界面前先问我"，每次点击和输入都要你点头。读取屏幕内容永远不需要审批。

命令与预算。 每个任务、每条规则都有预算（任务默认 $1，规则每次 $0.1、每月 $3），快用完时停下问你。生图/生视频默认直接生成，只有预计花费超过 $0.5 才先问你（附模型、提示词、参考价），10 分钟内不答就不生成。

其它运行方式：命令行 npm start、Docker、以及 127.0.0.1:3600 本地网页控制台，四种共用一套代码。

五、典型适用场景

  • 多模型并行的私人助理团：写稿用 Claude、审稿用 GPT、跑数据用 DeepSeek，每个机器人独立算钱。
  • IM 里的自动化值班：在微信/飞书上交代调研任务，后台跑完推结果；用规则盯价格、盯监控、盯发布状态。
  • 本地文件流水线：机器人读你的工作区、整理文档、生成报告（图片/视频结果存到工作区 media/ 再交付到聊天）。
  • NAS / 服务器常驻：Docker 起在 NAS，微信随时能找到它。
  • 多语言/多角色团队演练：应用内群聊可以拉多个机器人一起聊，@ 谁谁回答。

六、坑与注意

  1. "本地优先"不等于"完全离线"。 项目自己在隐私表里说得很直白：凡是你发给模型的内容，都会离开你的设备。提示词、文件内容、工具结果都经 Modelflare 转发给你选定的供应商，且 Modelflare 会保留请求日志（保留什么、留多久见其信任中心）。这是全篇最重要的一条边界。
  2. Modelflare 是单一依赖点。 模型来源完全绑在这个网关上（70+ 模型、13 家供应商、自动路由回退）。它的可用性、定价、缓存补偿承诺（OpenAI 价格/稳定/高级三组分别保证每天 65%/75%/85% 缓存命中率）都是第三方商业承诺，不归本仓库控制。任何价格或可用性变动都直接影响 AnyModelBot 的可用性。
  3. 微信是第三方移植实现。 微信渠道来自腾讯的 openclaw-weixin 项目（MIT），不是官方接口，随时可能因平台策略变化而失效。飞书/Telegram/Slack/Discord 相对稳定。
  4. Windows 上 PowerShell 版本直接决定代理速度。 开发文档写得很具体：Windows PowerShell 5.1 沙箱下每条命令要二三十秒，PowerShell 7 约 1 秒。应用会按"系统可用 PS7 → 内置 PS7 → PS 5.1"的顺序选，没有 PS7 时后台自动下载官方 PowerShell 7.6.9 LTS（装到 %LOCALAPPDATA%\AnyModelBot\pwsh\，不需管理员、不改 PATH），下载后核对 SHA256 + Authenticode 签名再试运行。装失败会退回并提示原因，AMB_PWSH_AUTO_INSTALL=0 可关闭。如果你在 Windows 上跑代理模式且觉得慢，先查这一项。
  5. 端口暴露。 Docker 模式容器内监听 0.0.0.0，只靠 token 保护。README 明确说别把 3600 暴露公网——请放在反向代理 / VPN / Tailscale 后面。
  6. 渠道当前只处理单聊。 应用内群聊已上线，但"聊天渠道里的群聊"仍是探索项。Telegram/Slack/Discord 目前只处理一对一对话，审批和提问回复文字。
  7. 免打扰与配额会拦你。 默认 22:00–08:00 免打扰；主动消息每天有上限（微信 3 条，其他渠道 5 条），超了合成一条。
  8. 清理策略。 任务和运行记录留 30 天；任务文件夹 30 天没动过会自动删除，不问（删除日期写在任务详情里，想留就点保留）。
  9. 崩溃不自动重做。 应用退出或崩溃时未处理完的消息，下次启动会在原对话里说一声请你重新发送，不会自动重做。
  10. 遥测与自动更新已关闭。 内置电脑操作驱动的遥测已关，内置网关以关闭自动更新的方式运行；桌面版每 6 小时查一次 GitHub 最新版本号（请求里只带当前版本号），有新版只在侧栏提示，由你决定下载。
  11. macOS 电脑操作仍是 Beta，且需要桌面会话。
  12. 版本极不稳定。 v0.1.18，README 里的"正在探索"清单明确说：邮件/日历触发、常驻运行与备份迁移、自定义 MCP、机器人之间协作、语音转写、独立手机 App 都还没做。别按 roadmap 规划生产流程。

七、与同类对比

维度 AnyModelBot Grok Bot OpenAI dots Claude Duet
开源 ✅ MIT — — —
智能体跑在哪 你的电脑或服务器 xAI 云端电脑 OpenAI 云端电脑 Anthropic 云端
可用模型 70+（经 Modelflare） 以 Grok 为主 OpenAI 模型 Claude（Opus 5.5）
费用 应用免费，模型按 token 订阅 ChatGPT Pro / Business Premium Claude Pro / Max
入口 桌面 / Docker / 微信 / 飞书 / TG / Slack / Discord 桌面应用、iPhone ChatGPT、Slack、Teams iOS、Android、claude.ai
现状 直接下载 测试版 部分地区开放 研究预览，美国候补名单

对比表的"其他产品信息来自 2026 年 10 月的公开报道"，可能已过时，以各家官方说明为准。

同类里更值得一起看的还有 OpenClaw（同样自托管、模型无关的智能体执行网关）、Chatbox（本地优先多模型聊天桌面端）、TypingMind（高级 Web UI）、ChatBot UI（开源 AI 聊天）。相比这些纯聊天壳，AnyModelBot 的差异点是后台任务 + 定时规则 + 审批卡片 + IM 渠道这一整套"常驻"机制，以及机器人级的记忆与预算隔离。

八、一句话推荐结论

如果你想要一个跑在自己机器上、能在微信/飞书里随时叫唤、能后台干活并定时汇报、还想随时换模型的个人智能体，AnyModelBot 值得现在就下下来试试（v0.1.18，六平台包齐全，MIT）；但要清楚它目前是 0.1.x 的实验性项目，且"本地优先"实际意味着你的提示词仍会经过 Modelflare 与模型供应商——敏感内容请留在只读模式或换用本地模型方案。

本文基于 2026-11-03 抓取的仓库 README（master）、docs/development.md、Releases 页（v0.1.18）及 GitHub API tag/asset 列表撰写。版本号与命令均已核对仓库当前状态；Modelflare 的定价、缓存命中率与模型清单属于第三方商业信息，可能变动，请以其官方页面为准。