10分钟上手 JiuwenSwarm:开源多智能体蜂群协作框架安装与实战

多智能体协作不是概念了——华为开源的 JiuwenSwarm 刚刚推出了鸿蒙 PC 版本,一套支持多 Agent 分工协商、Skill 自演进的完整框架。更关键的是:pip install jiuwenswarm 就能跑起来。

这篇文章带你从零部署、配置模型、到跑通一个实际的多智能体任务,全程实战。


一、JiuwenSwarm 是什么

JiuwenSwarm 是华为 openJiuwen 开源社区推出的蜂群智能体框架。它不是又一个单 Agent 玩具——核心差异在于三大能力:

  • 多 Agent 协作:Leader 自动拆解任务、召集专业 Agent 团队,各角色分工协商
  • Skill 自演进:Agent 在执行中检测错误和用户反馈,自动迭代自身能力
  • 多端覆盖:桌面 Web UI / TUI 终端 / 飞书 IM 均可接入,HarmonyOS PC 原生适配

目前开源在 GitHub(openJiuwen-ai/jiuwenswarm),1678 次提交,Apache 2.0 协议。实测在 PinchBench 上综合得分 94.2%,比 OpenClaw 高近 3 个点,token 消耗反而降了 34.8%。


二、三步部署

Step 1:安装


# 推荐用清华源加速
pip install jiuwenswarm -i https://pypi.tuna.tsinghua.edu.cn/simple

# 首次初始化
jiuwenswarm-init

初始化会让你配置模型服务。目前支持:华为云 MaaS、OpenAI、DeepSeek、DashScope、SiliconFlow、OpenRouter、以及任何 OpenAI 兼容接口。本地模型也支持(通过 Ollama 等部署)。

示例配置(以 DeepSeek 为例):


[Model]
provider = openai-compatible
base_url = https://api.deepseek.com
api_key = sk-your-key
model = deepseek-chat

Step 2:启动


jiuwenswarm-start

访问 http://localhost:5173 进入 Web 界面。也可以用 TUI 模式:


pip install jiuwenswarm-tui
jiuwenswarm-tui

Step 3:配置执行模式

JiuwenSwarm 有三种模式,按任务复杂度切换:

模式说明适用场景
集群模式(默认)Leader 编排多 Agent 分工协同大型复杂任务、多角色协作
规划模式分步拆解,逐步执行需确认每一步结果的复杂任务
性能模式灵活并行,快速响应简单任务、一次性查询

三、实战:让一个 Agent 团队帮你搭博客

来看最具代表性的一类任务——「一句话让 Agent 团队开发完整应用」

输入指令


帮我开发一个个人博客网站,从技术选型、页面设计、前后端开发到部署上线,制定完整的开发计划并逐步执行。

发生了什么?

  1. Leader Agent 收到指令,自动拆解任务:技术选型 → 架构设计 → 前端 → 后端 → 联调 → 部署
  2. 召集团队:动态组建「架构师 + 前端开发 + 后端开发 + 测试」四位 Agent
  3. 并行开发:前端写 React/Vue 页面,后端写 API,测试自动跑用例
  4. 迭代合并:每个阶段完成后自动汇总,如果中间出现报错,Leader 会指挥相关 Agent 修复

全程你只需要在关键决策点介入(比如选择技术栈),其余交给蜂群。


四、深入:Swarm Skills + 自演进

真正让 JiuwenSwarm 区别于其他框架的是 Skill 体系

  • Swarm Skills:把 Agent 团队协作的最佳实践(角色搭配、SOP、工具链)封装成可复用的「团队技能包」
  • Swarm Skills Hub:社区共享的技能市场,开发者可以搜索、安装、组合别人的技能
  • 自演进引擎:Agent 执行出错或检测到用户不满时,自动分析根因并优化 Skill 定义

举个例子:写一个「代码审查 Skill」,包含 Reviewer Agent 的审查规则、报告格式、自动化 PR 流程。发布到 Hub 后,整个社区都能复用,且每次执行都会反馈数据帮 Skill 迭代。

Skill 配置示例(JSON)


{
  "name": "code-reviewer",
  "description": "自动代码审查,覆盖安全、性能、风格三个维度",
  "agents": [
    {
      "role": "security-reviewer",
      "model": "deepseek-chat",
      "prompt": "关注 SQL 注入、XSS、权限校验等安全问题"
    },
    {
      "role": "performance-reviewer",
      "model": "claude-sonnet-5",
      "prompt": "分析算法复杂度、数据库查询效率、内存泄漏"
    },
    {
      "role": "style-reviewer",
      "model": "gpt-5.6-mini",
      "prompt": "检查代码风格、命名规范、注释质量"
    }
  ],
  "workflow": "并行审查 → 汇总报告 → 生成 PR Review"
}

五、HITS / HOTS:人怎么参与

在多智能体协作过程中,你不是旁观者。

  • HOTS(Human on the Swarm):作为「指挥官」,实时监控团队状态,随时调整任务优先级、切换 Agent 角色
  • HITS(Human in the Swarm):作为「团队一员」直接参与任务——比如在狼人杀游戏中和 AI 玩家共同推理投票

在 TUI 中按 P 键可以弹出审批面板,随时暂停工作流、查看中间结果、决定下一步方向。


实践建议

  1. 从小任务开始:先用性能模式跑单次任务(天气查询、信息检索),熟悉后再上集群模式
  2. 配置多模型:不同 Agent 用不同模型——Leader 用强推理模型(Claude / DeepSeek),执行 Agent 用快速便宜的模型(GPT-4o-mini / Flash)
  3. 利用 Skill Hub:别从零写技能——先看看社区有没有现成的,再按需定制
  4. 注意权限:生产环境中开启「工具执行前审批」和「文件访问白名单」,JiuwenSwarm 内置了这些安全控制
  5. HarmonyOS PC 用户:这是目前首个支持鸿蒙 PC 的原生开源 AI 工作台,直接下载桌面版即可

资源链接


JiuwenSwarm 的意义在于:把「多 Agent 协作」从一个架构论文概念变成了pip install就能用的工程工具。无论你是想快速搭一套自动化工作流,还是研究多智能体协同的底层机制,都值得花 10 分钟跑一遍。

滚动至顶部