OpenFang
The Agent Operating System
Open-source Agent OS built in Rust. 137K LOC. 14 crates. 1,767+ tests. Zero clippy warnings.
One binary. Battle-tested. Agents that actually work for you.
Documentation • Quick Start • Twitter / X
v0.3.30-安全强化版本(2026年3月)
OpenFang功能完整,但仍然是1.0之前的版本。您可能会遇到小版本之间的粗糙边缘或破坏性更改。我们发货快,修理快。固定到特定的提交以供生产使用,直到v1.0。 在此处报告问题。
什么是OpenFang?
OpenFang是一个 开源代理操作系统 —它不是聊天机器人框架,也不是围绕LLM的Python包装器,也不是“多代理编排器”。它是一个用于自主代理的完整操作系统,用Rust从头开始构建。
传统的代理框架等待您键入内容。OpenFang跑步 为您工作的自主代理 —按计划,24/7,构建知识图,监控目标,生成潜在客户,管理社交媒体,并将结果报告到仪表板。
整个系统编译为 单个~32MB二进制文件一个安装,一个命令,你的代理就上线了。
BASH``` 1 2 3 4curl -fsSL https://openfang.sh/install | sh openfang init openfang start
Dashboard live at http://localhost:4200
**Windows**
POWERSHELL```
1
2
3irm https://openfang.sh/install.ps1 | iex
openfang init
openfang start
手:真正做事的代理人
“Traditional agents wait for you to type. Hands work for you.”
手 是OpenFang的核心创新——预先构建的自主功能包,可以按计划独立运行,无需提示。这不是聊天机器人。这是一个代理,它在早上6点醒来,研究你的竞争对手,构建知识图,对结果进行评分,并在你喝咖啡之前向你的Telegram发送一份报告。
每只手捆:
- HAND.toml —清单声明工具、设置、需求和仪表板指标
- 系统提示 —多阶段操作手册(不是一句话——这些是500多字的专家程序)
- 技能.md —在运行时将领域专业知识参考注入上下文
- 护栏 —敏感操作的审批门(例如,Browser Hand在任何购买前都需要获得批准)
全部编译成二进制文件。无需下载,无需pip安装,无需Docker拉取。
7捆手
| 手 | 它到底在做什么 |
|---|---|
| 剪辑 | 获取YouTube URL,下载它,识别最佳时刻,将其切成带有字幕和缩略图的垂直短片,可选择添加AI画外音,并发布到Telegram和WhatsApp。8相管道。FFmpeg+yt-dlp+5 STT后端。 |
| 铅 | 每天跑步。发现与您的ICP匹配的潜在客户,用网络研究丰富他们,评分0-100,根据您现有的数据库进行重复数据消除,并以CSV/JSON/Markdown格式提供合格的潜在客户。随着时间的推移建立ICP档案。 |
| 收集者 | OSINT级智力。你给它一个目标(公司、个人、主题)。它持续监控——变化检测、情绪跟踪、知识图构建,以及重要事物发生变化时的关键警报。 |
| 预测器 | 超级预测引擎。从多个来源收集信号,构建校准的推理链,使用置信区间进行预测,并使用Brier评分跟踪其自身的准确性。有一种逆向思维模式,故意反对共识。 |
| 研究员 | 深度自主研究者。交叉引用多个来源,使用CRAAP标准(货币、相关性、权威性、准确性、目的)评估可信度,生成APA格式的引用报告,支持多种语言。 |
| 推特 | 自主推特/X账户管理器。以7种轮换格式创建内容,安排帖子以获得最佳参与度,回应提及,跟踪绩效指标。有一个审批队列——没有你的同意,什么都不会发布 |
| 浏览器 | Web自动化代理。浏览网站、填写表单、点击按钮、处理多步骤工作流。使用具有会话持久性的Playwright桥。 强制性采购审批门 —没有明确的确认,它永远不会花你的钱。 |
BASH``` 1 2 3 4 5 6 7 8 9 10# Activate the Researcher Hand — it starts working immediately openfang hand activate researcher
Check its progress anytime
openfang hand status researcher
Activate lead generation on a daily schedule
openfang hand activate lead
Pause without losing state
openfang hand pause lead
See all available Hands
openfang hand list
**建立自己的。** 定义a `HAND.toml` 使用工具、设置和系统提示。发布到FangHub。
---
## OpenFang vs景观
### 基准:已测量,未上市
所有数据来自官方文件和公共存储库——2026年2月。
#### 冷启动时间(越短越好)
1 2 3 4 5 6ZeroClaw ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 10 ms OpenFang ██████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 180 ms ★ LangGraph █████████████████░░░░░░░░░░░░░░░░░░░░░░░░░ 2.5 sec CrewAI ████████████████████░░░░░░░░░░░░░░░░░░░░░░ 3.0 sec AutoGen ██████████████████████████░░░░░░░░░░░░░░░░░ 4.0 sec OpenClaw █████████████████████████████████████████░░ 5.98 sec
#### 空闲内存使用率(越低越好)
1 2 3 4 5 6ZeroClaw █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 5 MB OpenFang ████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 40 MB ★ LangGraph ██████████████████░░░░░░░░░░░░░░░░░░░░░░░░░ 180 MB CrewAI ████████████████████░░░░░░░░░░░░░░░░░░░░░░░ 200 MB AutoGen █████████████████████████░░░░░░░░░░░░░░░░░░ 250 MB OpenClaw ████████████████████████████████████████░░░░ 394 MB
#### 安装尺寸(越小越好)
1 2 3 4 5 6ZeroClaw █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 8.8 MB OpenFang ███░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 32 MB ★ CrewAI ████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 100 MB LangGraph ████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 150 MB AutoGen ████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░ 200 MB OpenClaw ████████████████████████████████████████░░░░ 500 MB
#### 安全系统(越高越好)
1 2 3 4 5 6OpenFang ████████████████████████████████████████████ 16 ★ ZeroClaw ███████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 6 OpenClaw ████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 3 AutoGen █████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 2 LangGraph █████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 2 CrewAI ███░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 1
#### 通道适配器(越高越好)
1 2 3 4 5 6OpenFang ████████████████████████████████████████████ 40 ★ ZeroClaw ███████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 15 OpenClaw █████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 13 CrewAI ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0 AutoGen ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0 LangGraph ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0
#### LLM提供者(越高越好)
1 2 3 4 5 6ZeroClaw ████████████████████████████████████████████ 28 OpenFang ██████████████████████████████████████████░░ 27 ★ LangGraph ██████████████████████░░░░░░░░░░░░░░░░░░░░░ 15 CrewAI ██████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 10 OpenClaw ██████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 10 AutoGen ███████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 8
### 逐个特征比较
| 功能 | OpenFang | OpenClaw | ZeroClaw | CrewAI | AutoGen | LangGraph |
| --- | --- | --- | --- | --- | --- | --- |
| **语言** | **锈** | TypeScript | **锈** | Python | Python | Python |
| **自主之手** | **7内置** | 无 | 无 | 无 | | |
| **安全层** | **16离散** | 3个基本 | 6层 | 1个基本 | Docker | AES加密 |
| **代理沙盒** | **WASM双计量** | 无 | 允许列表 | 无 | Docker | 无 |
| **通道适配器** | **40** | 13 | 15 | 0 | 0 | 0 |
| **内置工具** | **53+MCP+A2A** | 50+ | 12 | 插件 | MCP | LC工具 |
| **记忆** | **SQLite+矢量** | 基于文件 | SQLite FTS5 | 4层 | 外部 | 检查点 |
| **桌面应用** | **牛磺酸2.0** | 无 | 无 | 无 | Studio | 无 |
| **审计跟踪** | **Merkle哈希链** | 日志 | 日志 | 跟踪 | 日志 | 检查点 |
| **冷启动** | **<200ms** | ~6s | ~10ms | ~3s | ~4s | ~2.5s |
| **安装尺寸** | **约32 MB** | 约500 MB | 约8.8 MB | 约100 MB | 约200 MB | 约150 MB |
| **许可证** | MIT | MIT | MIT | Apache 2.0 | 麻省理工学院 | |
---
## 16安全系统——深度防御
OpenFang不会在事后加强安全措施。每一层都是可独立测试的,并且在没有单点故障的情况下运行。
| # | 系统 | 它做什么 |
| --- | --- | --- |
| 1 | **WASM双计量沙箱** | 工具代码在WebAssembly中运行,带有燃油计量+纪元中断。看门狗线程会杀死失控的代码。 |
| 2 | **Merkle哈希链审计追踪** | 每一个动作都与前一个动作有加密联系。篡改一个入口,整个链条就会断裂。 |
| 3 | **信息流跟踪** | 标签在执行过程中传播——秘密从源到汇被跟踪。 |
| 4 | **Ed25519签名代理人清单** | 每个代理身份和能力集都经过加密签名。 |
| 5 | **SSRF保护** | 阻止私有IP、云元数据端点和DNS重新绑定攻击。 |
| 6 | **秘密归零** | `Zeroizing<String>` 在不再需要API密钥时,自动从内存中清除这些密钥。 |
| 7 | **OFP相互认证** | 用于P2P网络的基于HMAC-SHA256随机数的恒定时间验证。 |
| 8 | **能力门** | 基于角色的访问控制——代理声明所需的工具,内核强制执行 |
| 9 | **安全标头** | 每个响应上都有CSP、X-Frame-Options、HSTS、X-Content-Type-Options。 |
| 10 | **健康端点补救措施** | 公共卫生检查返回的信息很少。完整的诊断需要身份验证。 |
| 11 | **子流程沙盒** | `env_clear()` +选择性变量传递。使用跨平台kill进行进程树隔离。 |
| 12 | **快速注射扫描仪** | 检测技能中的覆盖尝试、数据泄露模式和shell引用注入。 |
| 13 | **环路保护** | 基于SHA256的断路器工具调用回路检测。处理乒乓球图案。 |
| 14 | **会话修复** | 7阶段消息历史验证和从损坏中自动恢复。 |
| 15 | **路径穿越预防** | 规范化,防止符号链接逃逸。 `../` 这里不工作。 |
| 16 | **GCRA速率限制器** | 具有成本意识的令牌桶速率限制,具有每IP跟踪和过时清理功能。 |
---
## 建筑
14个生锈的板条箱。137728行代码。模块化内核设计。
1 2 3 4 5 6 7 8 9 10 11 12 13 14openfang-kernel Orchestration, workflows, metering, RBAC, scheduler, budget tracking openfang-runtime Agent loop, 3 LLM drivers, 53 tools, WASM sandbox, MCP, A2A openfang-api 140+ REST/WS/SSE endpoints, OpenAI-compatible API, dashboard openfang-channels 40 messaging adapters with rate limiting, DM/group policies openfang-memory SQLite persistence, vector embeddings, canonical sessions, compaction openfang-types Core types, taint tracking, Ed25519 manifest signing, model catalog openfang-skills 60 bundled skills, SKILL.md parser, FangHub marketplace openfang-hands 7 autonomous Hands, HAND.toml parser, lifecycle management openfang-extensions 25 MCP templates, AES-256-GCM credential vault, OAuth2 PKCE openfang-wire OFP P2P protocol with HMAC-SHA256 mutual authentication openfang-cli CLI with daemon management, TUI dashboard, MCP server mode openfang-desktop Tauri 2.0 native app (system tray, notifications, global shortcuts) openfang-migrate OpenClaw, LangChain, AutoGPT migration engine xtask Build automation
---
## 40个通道适配器
将您的代理连接到您的用户所在的每个平台。
**核心:** 电报、Discord、Slack、WhatsApp、信号、矩阵、电子邮件(IMAP/SMTP)
**企业:** Microsoft Teams、Mattermost、谷歌聊天、Webex、飞鼠/云雀、Zulip
**社会:** LINE、Viber、Facebook Messenger、Mastodon、Bluesky、Reddit、LinkedIn、Twitch
**社区:** IRC、XMPP、内疚、反抗、Keybase、话语、Gitter
**隐私:** Threema、Nost、Mumble、Nextcloud Talk、Rocket。聊天室,Ntfy,Gotify
**工作场所:** Pumble、Flock、Twist、DingTalk、Zalo、Webhooks
每个适配器都支持每通道模型覆盖、DM/组策略、速率限制和输出格式。
---
## WhatsApp网络网关(二维码)
通过二维码将您的个人WhatsApp帐户连接到OpenFang,就像WhatsApp Web一样。不需要Meta Business帐户。
### 先决条件
- **Node.js>=18** 已安装([下载](https://nodejs.org/))
- OpenFang已安装并初始化
### 设置
**1.安装网关依赖项:**
BASH```
1
2cd packages/whatsapp-gateway
npm install
2.配置 config.toml:
TOML``` 1 2 3[channels.whatsapp] mode = “web” default_agent = “assistant”
**3.设置网关URL(选择一个):**
添加到您的shell配置文件中以实现持久性:
BASH```
1
2
3# macOS / Linux
echo 'export WHATSAPP_WEB_GATEWAY_URL="http://127.0.0.1:3009"' >> ~/.zshrc
source ~/.zshrc
或者在启动网关时将其设置为内联:
BASH``` 1export WHATSAPP_WEB_GATEWAY_URL=“http://127.0.0.1:3009”
**4.启动网关:**
BASH```
1node packages/whatsapp-gateway/index.js
网关监听端口 3009 默认情况下。覆盖 WHATSAPP_GATEWAY_PORT.
5.启动OpenFang:
BASH``` 1 2openfang start
Dashboard at http://localhost:4200
**6.扫描二维码:**
打开仪表板→ **频道** → **WhatsApp**。将出现一个二维码。用手机扫描:
> **WhatsApp** → **设置** → **链接设备** → **链接设备**
扫描后,状态将更改为 `connected` 传入的消息会被路由到您配置的代理。
### 网关环境变量
| 变量 | 描述 | 默认值 |
| --- | --- | --- |
| `WHATSAPP_WEB_GATEWAY_URL` | OpenFang要连接的网关URL | *(空=禁用)* |
| `WHATSAPP_GATEWAY_PORT` | 网关监听的端口 | `3009` |
| `OPENFANG_URL` | 网关向其报告的OpenFang API URL | `http://127.0.0.1:4200` |
| `OPENFANG_DEFAULT_AGENT` | 处理传入消息的代理 | `assistant` |
### 网关API端点
| 方法 | 路线 | 描述 |
| --- | --- | --- |
| `POST` | `/login/start` | 生成二维码(返回base64 PNG) |
| `GET` | `/login/status` | 连接状态(`disconnected`, `qr_ready`, `connected`) |
| `POST` | `/message/send` | 发送消息(`{ "to": "5511999999999", "text": "Hello" }`) |
| `GET` | `/health` | 健康检查 |
### 备选方案:WhatsApp云API
对于生产工作负载,请使用 [WhatsApp云API](https://developers.facebook.com/docs/whatsapp/cloud-api) 拥有Meta Business帐户。看 [云API配置文档](https://openfang.sh/docs/channels/whatsapp).
---
## 27位法学硕士提供者——123位以上的模特
3名本地司机(Anthropic、Gemini、OpenAI兼容)前往27家供应商:
Anthropic、Gemini、OpenAI、Groq、DeepSeek、OpenRouter、Together、Mistral、Fireworks、Cohere、Perplexity、xAI、AI21、Cerebras、SambaNova、HuggingFace、Replicate、Ollama、vLLM、LM Studio、Qwen、MiniMax、Zhpu、Moonshot、Qianfan、Bedrock等。
具有任务复杂性评分、自动回退、成本跟踪和按型号定价的智能路由。
---
## 从OpenClaw迁移
已经在运行OpenClaw?一个命令:
BASH```
1
2
3
4
5
6# Migrate everything — agents, memory, skills, configs
openfang migrate --from openclaw
# Migrate from a specific path
openfang migrate --from openclaw --path ~/.openclaw
# Dry run first to see what would change
openfang migrate --from openclaw --dry-run
迁移引擎导入您的代理、对话历史、技能和配置。OpenFang原生读取SKILL.md,并与ClawHub市场兼容。
OpenAI兼容的API
插入替换。将您现有的工具指向OpenFang:
BASH```
1
2
3
4
5
6
7curl -X POST localhost:4200/v1/chat/completions
-H “Content-Type: application/json”
-d ’{
“model”: “researcher”,
“messages”: [{“role”: “user”, “content”: “Analyze Q4 market trends”}],
“stream”: true
}’
140多个REST/WS/SSE端点,涵盖代理、内存、工作流、通道、模型、技能、A2A、Hands等。
---
## 快速开始
BASH```
1
2
3
4
5
6
7
8
9
10
11
12
13
14# 1. Install (macOS/Linux)
curl -fsSL https://openfang.sh/install | sh
# 2. Initialize — walks you through provider setup
openfang init
# 3. Start the daemon
openfang start
# 4. Dashboard is live at http://localhost:4200
# 5. Activate a Hand — it starts working for you
openfang hand activate researcher
# 6. Chat with an agent
openfang chat researcher
> "What are the emerging trends in AI agent frameworks?"
# 7. Spawn a pre-built agent
openfang agent spawn coder
Windows (PowerShell) POWERSHELL``` 1 2 3irm https://openfang.sh/install.ps1 | iex openfang init openfang start
---
## 发展
BASH```
1
2
3
4
5
6
7
8# Build the workspace
cargo build --workspace --lib
# Run all tests (1,767+)
cargo test --workspace
# Lint (must be 0 warnings)
cargo clippy --workspace --all-targets -- -D warnings
# Format
cargo fmt --all -- --check
稳定性通知
OpenFang v0.3.30是1.0之前的版本。架构坚实,测试套件全面,安全模型全面。上面说:
- 突破性变化 可能发生在v1.0之前的次要版本之间
- 一些手 比其他人更成熟(浏览器和研究人员是最久经考验的)
- 边缘案例 存在——如果你找到一个, 打开一个问题
- 固定到特定的提交 适用于v1.0之前的生产部署
我们发货快,修理快。目标是在2026年中期推出坚如磐石的v1.0。
安全
要报告安全漏洞,请发送电子邮件至 jaber@rightnowai.co。我们认真对待所有报告,并将在48小时内作出回应。
许可证
麻省理工学院——随心所欲地使用它。
链接
由RightNow建造
OpenFang is built and maintained by Jaber, Founder of RightNow.
Website •
Twitter / X •

Built with Rust. Secured with 16 layers. Agents that actually work for you.