项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 18243
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- macOS 或 Linux 系统(官方安装脚本仅标注支持这两个平台)
- 网络可访问 https://openfang.sh 安装脚本地址
- 如使用 WhatsApp 网关,需要 Node.js 与 npm 环境
- 如需从源码跑测试,需要 Rust 的 cargo 工具链
安装与启动步骤
-
1安装 OpenFang
在 macOS 或 Linux 终端执行官方一行安装脚本,脚本会下载并安装 OpenFang 二进制文件。
curl -fsSL https://openfang.sh/install | sh -
2初始化
运行初始化命令,会以交互方式引导你完成 LLM 提供商的配置。
openfang init -
3安装网关依赖
如果要使用 WhatsApp 网关,先进入仓库中的 packages/whatsapp-gateway 目录再安装 npm 依赖。
cd packages/whatsapp-gateway npm install -
4配置渠道
在 config.toml 中写入 channels.whatsapp 段,指定运行模式和默认智能体名称。
[channels.whatsapp] mode = "web" default_agent = "assistant" -
5迁移旧数据
如果此前使用 OpenClaw,可先试运行迁移命令查看将会导入哪些内容,确认无误后再正式迁移。
openfang migrate --from openclaw --dry-run -
6跑测试验证
在源码工作区根目录执行全量测试,确认安装与构建环境正常。
cargo test --workspace
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
channels.whatsapp.mode | 是 | WhatsApp 渠道的运行模式 | web |
channels.whatsapp.default_agent | 是 | 该渠道默认绑定的智能体名称 | assistant |
如何确认成功
openfang init 按提示完成提供商配置后即可使用;cargo test --workspace 应显示 1,767+ 测试通过。
常见问题
Q:安装脚本支持 Windows 吗?
A:README 中的安装命令明确标注为 macOS/Linux,未提供 Windows 安装方式,Windows 用户建议使用 WSL 或查阅官方文档确认。
Q:现在适合上生产环境吗?
A:官方说明当前为 v0.5.10,功能已完整但仍是 pre-1.0,次要版本间可能有破坏性变更,生产使用建议固定到具体 commit。
Q:如何从 OpenClaw 迁移过来?
A:使用 openfang migrate --from openclaw --dry-run 先试跑,确认要导入的智能体、会话历史、技能和配置无误后再正式执行。可原生读取 SKILL.md,并兼容 ClawHub 市场。
Q:WhatsApp 网关依赖装不上怎么办?
A:确认已进入仓库的 packages/whatsapp-gateway 目录,并已安装 Node.js 与 npm,然后在网络正常的环境下重新执行 npm install。
注意事项
- 项目仍处于 pre-1.0 阶段,小版本之间可能出现破坏性变更,生产环境请固定到特定 commit。
- 安装包体积约 32 MB,空闲内存占用约 40 MB,资源开销远低于常见 Python 智能体框架。
- README 中关于网关 URL 的设置说明被截断,具体环境变量或配置项请以官方文档 openfang.sh/docs 为准。
核心亮点
- 采用 Rust 实现,内存安全且性能高,适合底层系统级智能体管理
- 内置 MCP 协议支持,能无缝对接主流 LLM 和外部工具生态
- 提供进程式智能体生命周期管理,支持状态持久化和资源隔离
不足之处
- Rust 学习曲线较陡,对非 Rust 开发者不友好
- 项目较新,生态和文档仍在完善中,社区待观察
适用场景
- 构建需要长期运行、状态可恢复的复杂 AI 智能体服务
- 多智能体协作场景,需要统一调度和资源隔离
- 需要将智能体与外部工具安全集成的企业级应用
替代项目
AutoGen、LangGraph、CrewAI
上一篇:pydantic-ai
下一篇:eigent
同类项目推荐
openclaw-docs
开源
中文一站式搞定 OpenClaw 智能体,多平台机器人快速上手
OpenClaw 中文文档站:767 篇安装教程与源码剖析
claude-code-blueprint
开源
让 Claude Code 项目从混乱到有序,渐进式落地最佳实践
A battle-tested, framework-agnostic reference architecture for Claude Code. Beginner···
claude-code-guide
开源
从入门到精通 Claude Code,一份指南全搞定
Claude Code Guide - Setup, Commands, workflows, agents, skills & tips-n-tricks from ···
open-cowork
开源
一键装好 Claude Code 和 MCP 工具,沙箱隔离,多模型切换,飞书 Slack 协作。
Open-source AI agent desktop app for Windows & macOS. One-click install Claude Code,···
MCPHub-Desktop
开源
本地一键管理 MCP 服务器、Skills 和 RAG 知识库
MCPHub Desktop 是一款基于 Tauri 2 构建的桌面客户端,用于在个人电脑上统一管理 MCP服务···
drunk-claude
开源
给 Claude 灌点酒,创意不设限,灵感不断片
Intensity slider from tipsy (0.1) to blackout (1.0). 5 moods, 8 creative techniques.···
open-index
开源
给AI智能体装上结构化记忆,让上下文感知更聪明
Deterministic memory layer for your agents
OpenRath
开源
像搭积木一样编排多智能体,轻松搞定复杂会话流程。
An open-source, PyTorch-like runtime for dynamic multi-agent and multi-session workf···
Agent-Execution-Partnership
开源
给AI代理装上安全阀门,动作先审批、全程可追踪、事后可审计。
Agent Execution Partnership AEE is an open-source control plane that ensures every A···
