前言
LLM 催生了 AI Agent 这类新物种——它们不再是简单的命令响应,而是一种能自己推理、规划、执行的实体。openJiuwen 正是为此而生的开源平台,它试图把 Agent 开发从'手工作坊'拉进工程化轨道。我花了一个下午,在私有服务器上把它跑了起来,并顺手做了个 Rust 编程导师,下面是整个过程的记录。
架构概览
在动手之前,先理清它的架构。openJiuwen 分成三层:
- 底层:对接各种 LLM(Pangu、Qwen、DeepSeek 等)和向量数据库、图数据库。这层决定了它能跟上模型迭代的节奏。
- 核心层:openJiuwen Core,是 Agent 的'大脑'。它内置 ReAct 和 Workflow 两种运行模式,管理上下文、记忆和工具调用。另外提供 Python SDK,供代码级精细化控制。
- 应用层:openJiuwen Studio——拖拽式可视化编排;openJiuwen Ops——负责监控、Prompt 管理和自动评测,让线上 Agent 不再是黑盒。
架构图中有一部分灰虚框,代表还在孵化中的功能模块,可见项目是有长期演进计划的。
(上面的图就是整体架构,我把关键部分标了出来。)
部署实战:Docker 一键起服
我用的是一台 x86 服务器,系统是 Linux。全程容器化,省去环境折腾。
docker version
docker-compose version
确认版本:Docker 20.10.x,Compose 1.29.x,没问题。
接着拉部署包。官方提供了打包好的脚本和配置,一条 wget 下来:
wget [部署包下载地址]
解压后看到 service.sh、docker-compose.yaml 和一堆配置文件,这就是启动骨架了。
unzip deployTool_0.1.3_amd64.zip
启动前,保险起见看看 Docker 服务状态:
sudo systemctl start docker
sudo systemctl status docker
active (running) 字样亮着,就可以执行启动脚本了:
./service.sh up
脚本会自动检查镜像、拉取缺失的,然后按顺序启动数据库、缓存、API 和前端。看到 Started 或 Up,说明各组微服务已经就绪。
默认端口是 3000,浏览器访问 https://你的IP:3000,会先进入登录页。可以邮箱注册,企业环境里也能接 LDAP 或 SSO。


