mhand79/open-swarm

Open-Swarm智能体框架Docker镜像文档

镜像概述

本Docker镜像基于GitHub开源项目https://github.com/matthewhand/open-swarm%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E9%83%A8%E7%BD%B2%E6%96%B9%E5%BC%8F%EF%BC%8C%E7%94%A8%E4%BA%8E%E8%BF%90%E8%A1%8COpen-Swarm%E6%99%BA%E8%83%BD%E4%BD%93%E6%A1%86%E6%9E%B6%E3%80%82%E8%AF%A5%E6%A1%86%E6%9E%B6%E4%B8%93%E6%B3%A8%E4%BA%8E%E7%AE%80%E5%8C%96%E6%99%BA%E8%83%BD%E4%BD%93%E5%BA%94%E7%94%A8%E7%9A%84%E5%BC%80%E5%8F%91%E4%B8%8E%E8%BF%90%E8%A1%8C%E6%B5%81%E7%A8%8B%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E6%99%BA%E8%83%BD%E4%BD%93%E5%8D%8F%E4%BD%9C%E3%80%81%E4%BB%BB%E5%8A%A1%E8%87%AA%E5%8A%A8%E5%8C%96%E5%8F%8A%E6%A8%A1%E5%9D%97%E5%8C%96%E6%89%A9%E5%B1%95%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%90%84%E7%B1%BB%E9%9C%80%E8%A6%81%E6%99%BA%E8%83%BD%E4%BD%93%E5%8F%82%E4%B8%8E%E7%9A%84%E8%87%AA%E5%8A%A8%E5%8C%96%E5%9C%BA%E6%99%AF%E3%80%82

核心功能与特性

• 模块化架构：采用组件化设计，支持自定义智能体逻辑与任务流程
• 多智能体协作：内置智能体通信机制，支持多智能体协同完成复杂任务
• 任务自动化：提供任务调度与执行引擎，支持定时任务、事件触发等自动化模式
• 可扩展配置：支持通过环境变量、配置文件灵活调整框架参数
• 轻量部署：基于Docker容器化部署，简化依赖管理与环境一致性维护

使用场景

• AI应用开发：快速搭建智能体原型，验证多智能体协作逻辑
• 自动化工作流：构建基于智能体的自动化办公、数据处理流程
• 多智能体系统原型验证：学术研究或企业级多智能体系统的快速部署与测试
• 任务调度平台：实现复杂业务逻辑的智能分发与执行监控

使用方法与配置

快速启动

通过以下命令快速启动Open-Swarm智能体框架容器：

bash
docker run -d \
  --name open-swarm-agent \
  -p 8080:8080 \
  -v ./config:/app/config \
  -e LOG_LEVEL=info \
  -e AGENT_COUNT=3 \
  matthewhand/open-swarm:latest

Docker Compose配置示例

创建docker-compose.yml文件进行多容器协同部署：

yaml
version: '3.8'
services:
  open-swarm:
    image: matthewhand/open-swarm:latest
    container_name: open-swarm-core
    ports:
      - "8080:8080"  # API端口
      - "9000:9000"  #监控端口
    volumes:
      - ./config:/app/config  # 配置文件挂载
      - ./data:/app/data      # 数据持久化
    environment:
      - LOG_LEVEL=debug
      - AGENT_COUNT=5
      - TASK_TIMEOUT=300
      - API_KEY=your_secure_api_key
    restart: unless-stopped

环境变量配置说明

持久化数据

为保证配置与任务数据不丢失，建议挂载以下目录：

• /app/config: 存放框架配置文件（如agents.yaml、tasks.yaml）
• /app/data: 存储任务执行日志、智能体状态数据等

注意事项

1. 首次使用前建议通过docker pull matthewhand/open-swarm:latest拉取最新镜像
2. 生产环境中需配置API_KEY等安全相关环境变量，避免未授权访问
3. 复杂场景下建议结合Docker Swarm或Kubernetes进行集群部署
4. 详细配置与高级功能请参考GitHub项目文档：https://github.com/matthewhand/open-swarm