Foxwarm

合上电脑，它还在干活。

Foxwarm 把 AI Agent 跑在你自己的服务器上。一个任务可以连续跑好几天，分派到你的多台机器上，并在你所在的地方汇报：浏览器、手机，或者团队群聊。

curl -fsSL https://foxwarm.net/install-foxwarm.sh | bash

支持 Linux x64（包括 WSL）和 macOS arm64。下载预编译版本并在后台启动，有 tmux 时优先使用；系统没有兼容运行时则使用自带 .NET 的版本。 安装包和环境要求

一个周二，一个任务
  1. 笔记本

    你说：main 分支的 CI 挂了，查一下原因并修好。

  2. build-box

    它开了一个子会话，让它到构建服务器上跑测试。

  3. 你合上电脑去开会。活儿还在继续。

  4. 手机

    你在手机上打开子会话，插了一句：prorate() 里保留完整精度。

  5. 团队群

    它在团队群里发了两句话的总结。同事追问，它基于完整历史回答。

每一步都是一个会话，随时可以打开、查看、插话。 Foxwarm 如何工作 →

Foxwarm WebUI 的 Conversation 视图：用户请 Agent 修复失败的测试，Agent 汇报了原因、修复方式和提交记录。侧边栏列出了其他会话，其中一些带有子会话。
同一个任务在 Foxwarm WebUI 里的样子。真实截图，演示项目。
兼容
  • OpenAI 兼容 API
  • Anthropic
  • 本地网关
  • MCP
  • Telegram
  • Matrix
  • QQ
  • 微信
  • 企业微信

01长时间运行

对话再长，也不会失忆。

会话接近模型的上下文上限时，Foxwarm 会把较早的内容压缩成分层摘要，而不是直接丢掉。原始消息保留在归档里，某个细节重新变得重要时，Agent 可以把原文找回来。服务重启后，会话也会接着进行。

  • 分层摘要，每一层都能追溯到原文
  • 精确回溯归档中的消息
  • 可选的跨会话语义检索
了解压缩和回溯 →
压缩后的 Foxwarm 会话：用户要求给出某个工单背后的原始输出，Agent 用 recall 工具检索归档，并引用了之前命令打印的那一行。

02手脑分离

一个大脑，任意多双手。

Agent loop、记忆、模型、Skill 和 MCP 连接都在你的 Foxwarm 服务器上，只需配置一次。节点就是手：构建服务器、笔记本、容器或浏览器标签页，负责接收指令、回传结果。新增一台机器只需运行一个小客户端，不用在每台机器上配置 API Key、Skill 或 MCP。

  • 模型、Skill 和 MCP 集中在一处配置
  • 轻量节点，支持 Linux、macOS、Windows、Docker 和浏览器
  • 会话可以换到另一台机器上干活，对话留在原处
配置节点 →

需要更严格的控制时

凭据只留在大脑
可以配置成：Agent 正常使用模型和 MCP 工具，但始终读不到它们的凭据。
按 Agent 设置规则
在实例级授权规则之上，为每个 Agent 单独允许或禁止工具和节点。
让 Agent 自己分层
Agent 可以创建下级 Agent，把自己的一部分节点和权限分给它。每一层都不能超出上级给的范围。
Agent 把会话切换到远程节点 build-box，并在那里执行命令。

03会话与 Agent

派出去的活，随时看得见、管得住。

Agent 把任务交出去时，工作在一个真正的会话里进行：它有自己的历史，重启后还在，在侧边栏里挂在父会话下面。你可以随时点开看它在做什么，也可以直接给它发消息调整方向。任务还可以交给另一个 Agent，它有自己的记忆、规则和机器。

  • 每个委派的任务都是能打开、能插话的完整会话
  • 可以交给另一个 Agent，而不只是同一个 Agent 的分身
  • Agent 树和节点树，每一层只能在上级给的范围内再收窄
Agent、会话和记忆 →
一个会话并行启动两个子会话：一个在 build-box 节点上，一个在单独的文档 Agent 下；等两者完成后汇总它们的汇报。
子会话内部：它工作期间，用户直接给它发了一条指令，它随之调整了修复方式。

04渠道

在这里聊清楚，再拉进群里讲。

任何聊天都可以绑定到任何会话。先在 WebUI 里把问题理清楚，再把 bot 拉进团队群，执行 /attach：它带着前面完整的上下文回答，群里任何人都可以接着追问。支持 Telegram、Matrix、QQ、微信和企业微信。

  • 用 /attach 把聊天接到已有会话
  • Agent 知道是谁在问，上下文完整保留
  • 发送者白名单；可以对某个群放开追问，命令仍只限授权用户
接入渠道 →

Agent 需要的，都在一个地方。

终端和编辑器
真实终端直接在浏览器里运行，就在对话旁边；还可以选装基于 VS Code 的编辑器。
Agent 记忆
每个 Agent 都有长期保存的指令和知识，不依赖某一次对话。
Skill
把工作流程写成 Skill，Agent 只在任务需要时才加载。
模型随你选
支持 OpenAI 兼容和 Anthropic 接口，也支持本地网关，每个会话都可以选不同的模型。
ToolScript
Agent 可以用一段小脚本组合多次工具调用，省去来回往返。
定时任务
给会话设置一次性或周期性的定时器，让它按时检查、汇报或跟进。

几分钟就能跑起来。

  1. 安装

    运行对应平台的安装脚本。它会下载发布版本、启动 Foxwarm，然后输出 WebUI 的登录链接。

  2. 添加模型

    打开 Setup → Models，填写服务商、模型 ID 和 API Key。

  3. 开始会话

    和默认 Agent 对话，给它指定工作目录；需要时再添加节点或渠道。

程序文件和数据放在不同的目录里，升级和备份都很简单。 完整安装指南 →