Firecrawl Open Agent Builder

Open Agent Builder - 完整的本地开发栈

使用可视化无代码界面构建、测试和部署AI代理工作流

  ](https://docker.com)

快速入门 • 建筑 • 文档

______________________________________________________________________

🚀 维什瓦吉特的贡献

这个增强型存储库提供了一个 完整的本地开发环境栈 适用于Open Agent Builder，实现无缝Docker集成并绕过认证，即刻提升生产力。

解锁 本地开发时的认证移除

• 完全绕过身份验证 为了实现无缝本地开发
• 无需登录 - 用户可以立即开始构建工作流
• 职员集成功能已禁用 带有适当的备用方案
• 简化凸认证配置 仅限本地使用
• “本地开发模式”指示器 在用户界面中，以清晰展示开发上下文

🐳 这个表情符号在中文里通常被理解为“海豚”或“小海豚”的意思，它并没有直接对应的中文翻译，但在网络交流中常被用来表达与海豚相关的情境或情感。 Docker优先本地设置

• 全面的Docker集成 使用本地运行的 Firecrawl 实例
• 自托管的Firecrawl 运行在 localhost:3002 通过 Docker Compose
• Firecrawl MCP 服务器 运行于 localhost:3000 经过适当配置
• 轻松设置 （与）一起，带着 docker-compose up 为了完整的本地环境
• 环境变量配置 为了实现无缝的Docker网络连接

🤖 表示机器人。 共同人工智能融合

• 原生集成AI支持 使用与OpenAI兼容的API调用
• 多个联合人工智能模型 可用的：

- Llama 3 8B/70B Instruct Turbo - Qwen 2.5 7B Instruct Turbo（可译为“通义千问2.5 70亿参数指令版涡轮版”） - Mixtral 8x7B 指令模型 - Llama 4 Maverick 17B 指令FP8（注：此处“FP8”可能指的是某种特定的格式、精度或配置，具体含义需根据上下文确定，直译为“FP8指令”可能不够准确，但在此提供直译以保持原文结构）

• 妥善管理API密钥 通过“设置”→“API密钥”
• MCP工具兼容性 （功能有限但可用）

🎯（靶心） 自定义模型输入支持

• “自定义模型…”选项 在所有大型语言模型（LLM）选择下拉菜单中
• 自由形式模型输入 允许任何 provider/model-name 格式
• 实时验证 附有实用示例
• 无缝切换 在预定义模型和自定义模型之间
• 视觉指示器 在用户界面中用于自定义模型
• 提供的示例 对于常见提供商（Together AI、Anthropic、OpenAI、Groq）

🔧 修理工具或螺丝刀的象征 关键错误修复与优化

• 修复LangGraph中的UnreachableNodeError - 添加了边缘验证以防止无效节点连接
• TypeScript 编译错误已解决 - 修复了baseURL属性问题和类型不匹配问题
• 边缘清理自动化 - 在工作流执行过程中，无效边将被自动移除
• 实时边缘验证 - 防止因连接格式错误导致的工作流执行失败
• 强大的错误处理 - 更好的错误信息和优雅降级

______________________________________________________________________

📁 仓库结构

此存储库包含三个主要组件，用于构建完整的Open Agent Builder设置：

openai-agents-sdk/
├── 🔥 firecrawl/                    # Self-hosted Firecrawl web scraping engine
│   ├── docker-compose.yaml         # Docker setup for local Firecrawl
│   ├── apps/                        # Firecrawl API and services
│   └── SELF_HOST.md                 # Self-hosting documentation
│
├── 🔌 firecrawl-mcp-server/         # MCP server for Firecrawl integration
│   ├── Dockerfile                   # Docker configuration
│   ├── local_server_setup.md        # Local setup guide
│   └── src/                         # MCP server source code
│
└── 🎨 open-agent-builder/           # Visual workflow builder application
    ├── app/                         # Next.js application
    ├── components/                  # React components
    ├── lib/                         # Core libraries and utilities
    ├── convex/                      # Database schema and functions
    └── README.md                    # Detailed application documentation

______________________________________________________________________

🚀 快速入门

先决条件

• Node.js 18及以上版本 安装了
• Docker 已安装并运行
• 至少一个大型语言模型（LLM）API密钥 （Anthropic、OpenAI、Groq 或 Together AI）
• 凸账户 - 免费注册

5步完成设置

选项A：快速设置（自动化）

git clone https://github.com/firecrawl/firecrawl-open-agent-builder.git
cd firecrawl-open-agent-builder
chmod +x setup.sh
./setup.sh

选项B：手动设置

1. 克隆并安装

git clone https://github.com/firecrawl/firecrawl-open-agent-builder.git
cd firecrawl-open-agent-builder/open-agent-builder
npm install

2. 设置数据库（Convex）

# Install Convex CLI globally
npm install -g convex

# Initialize Convex project
cd open-agent-builder
npx convex dev

这会打开您的浏览器以创建/链接一个Convex项目，并生成 NEXT_PUBLIC_CONVEX_URL 在 .env.local。

3. 在本地启动 Firecrawl（使用 Docker）

# Navigate to Firecrawl directory
cd ../firecrawl

# Start Firecrawl with Docker Compose
docker-compose up -d

# Verify Firecrawl is running
curl http://localhost:3002/health

4. 启动Firecrawl MCP服务器（Docker）

# Navigate to Firecrawl MCP Server directory
cd ../firecrawl-mcp-server

# Build and run MCP server
docker build -t firecrawl-mcp-server .
docker run -d --name firecrawl-mcp-server \
  -p 3000:3000 \
  -e FIRECRAWL_API_URL=http://host.docker.internal:3002 \
  -e FIRECRAWL_API_KEY=local-dev-key \
  firecrawl-mcp-server:latest

# Verify MCP server is running
curl http://localhost:3000/health

5. 配置并启动Open Agent Builder

# Back to open-agent-builder directory
cd ../open-agent-builder

# Create .env.local with your configuration
cat > .env.local << EOF
# Convex Database (Required)
NEXT_PUBLIC_CONVEX_URL=your-convex-url-here

# Optional: Default LLM API keys (can also be added in UI)
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
GROQ_API_KEY=gsk_...
TOGETHER_API_KEY=...
EOF

# Start the application
npm run dev

🎉 参观 http://localhost:3001 翻译为中文是：“本地主机上的3001端口”。不过，通常我们不会直接这样翻译URL，而是根据上下文可能将其描述为“访问本地运行的3001端口服务”或“打开本地3001端口网页”，具体取决于使用场景。在这里，为了简洁明了，直接翻译为“本地主机上的3001端口”即可 - 无需登录！

______________________________________________________________________

🏗️ 建筑学

Architecture

______________________________________________________________________

🎯 你可以构建什么

可视化工作流构建器

• 拖放式界面 用于构建代理工作流
• 实时执行 带有实时更新
• 8种核心节点类型开始，代理，MCP 工具，转换，如果/否则，循环（While），用户批准，结束
• 模板库 带有预构建的工作流
• MCP协议支持 用于可扩展的工具集成

网页抓取与数据提取

• 原生Firecrawl集成 用于网页抓取和搜索
• 结构化数据提取 使用JSON模式验证
• 多页面爬取 支持分页功能
• 内容转换 和分析
• 人参与的循环（或闭环） 敏感操作的审批

AI代理流水线

• 多步骤人工智能工作流 带有条件路由
• 自定义模型支持 对于任何提供商
• MCP工具集成 用于外部服务
• 实时流媒体 执行更新
• 错误处理 以及重试机制

______________________________________________________________________

🔧 配置

环境变量

要求：

NEXT_PUBLIC_CONVEX_URL=your-convex-url-here

可选（也可在用户界面中添加）：

ANTHROPIC_API_KEY=sk-ant-...          # Claude models (Recommended for MCP)
OPENAI_API_KEY=sk-...                 # GPT models
GROQ_API_KEY=gsk_...                  # Fast inference models
TOGETHER_API_KEY=...                  # Open models (Llama, Qwen, Mixtral)

Docker 服务

Firecrawl（端口3002）：

• 网络爬虫API
• 用于JavaScript渲染的Playwright服务
• Redis 用于缓存
• PostgreSQL用于队列管理

Firecrawl MCP 服务器（端口 3000）：

• MCP协议服务器
• 工具发现与执行
• HTTP流式传输模式

______________________________________________________________________

📚 文档

• Firecrawl 自托管指南 - 完成Firecrawl的设置
• MCP服务器设置 - MCP服务器配置

______________________________________________________________________

🚀 主要功能

🔓 解锁 无需认证

• 立即访问所有功能
• 非常适合本地开发和测试
• 无外部服务依赖

🐳 表示“海豚”或“海豚脸”的表情符号。在中文里，可以直接用“海豚”或“海豚脸”来描述这个表情符号的含义，但具体使用时，根据上下文和语境，也可以灵活表达为“一个海豚的表情”或“海豚的可爱模样”等。不过，为了简洁明了，通常直接说“海豚”即可。 Docker优先架构

• 使用 Docker Compose 自托管 Firecrawl
• MCP服务器容器化
• 轻松部署和扩展

机器人 多模型（Multi-LLM）支持

• Anthropic Claude（推荐用于MCP）
• OpenAI GPT模型
• Groq快速推理
• Together AI 开放模型
• 自定义模型输入 对于任何提供商

🔌（电源插头/插座） MCP协议集成

• 原生MCP服务器支持
• 可扩展的工具生态系统
• 符合协议的集成

🎨（颜料/绘画相关的表情符号，无直接对应文字，可理解为“绘画”或“艺术创作”） 可视化工作流构建器

• 拖放界面
• 实时执行监控
• 模板库
• 出口能力

______________________________________________________________________

🛠️ 开发

运行测试

cd open-agent-builder
npm run test
npm run test:e2e

构建生产环境（或“为生产构建”）

cd open-agent-builder
npm run build

Docker 管理

# Start all services
cd firecrawl && docker-compose up -d
cd ../firecrawl-mcp-server && docker run -d --name firecrawl-mcp-server ...

# Stop services
cd firecrawl && docker-compose down
docker stop firecrawl-mcp-server && docker rm firecrawl-mcp-server

# View logs
cd firecrawl && docker-compose logs -f
docker logs firecrawl-mcp-server

______________________________________________________________________

🙏 致谢

• 火行者（或火焰爬行者，根据上下文具体含义可能有所不同） - 网络数据抓取和爬取引擎