跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaWeChatAIjava

OpenClaw Java 基于 Spring Boot 3.3 实现 AI Agent Gateway

OpenClaw Java 是一个基于 Spring Boot 3.3 的 AI Agent Gateway 开源项目。它通过 WebSocket 自定义帧协议提供全功能 Agent 接口,支持多模型接入(Claude、GPT、Ollama 等)、多渠道对话(即时通讯、微信公众号)、工具调用及会话管理。架构包含网关、Agent 引擎、渠道适配器等模块,采用插件化设计。项目旨在为 Java 开发者提供工程化的 AI Agent 运行时方案,具备持久化、用量追踪等功能。

菩提发布于 2026/4/6更新于 2026/9/982 浏览
OpenClaw Java 基于 Spring Boot 3.3 实现 AI Agent Gateway

项目简介

OpenClaw Java 是基于 Spring Boot 3.3 的 AI Agent Gateway 全栈实现,通过 WebSocket 自定义帧协议提供全功能 Agent 接口。

项目地址:https://github.com/yuenkang/openclaw-java

当前规模: 594 个 Java 源文件 + 17 个测试文件,约 88,500 行代码

为什么做这个项目?

目前 AI Agent 框架大多集中在 Python 和 TypeScript 生态,Java 社区相对缺少成熟的 Agent 运行时方案。OpenClaw Java 希望为 Java 开发者提供一个工程化的 AI Agent 运行时,支持多模型接入、多渠道对话、工具调用和会话管理等完整能力。

核心亮点

🤖 Agent 执行引擎

  • 多轮对话循环:用户 → 大模型 → 工具调用 → 大模型 → 回复
  • 多模型提供者:支持 Claude、GPT 系列、Ollama 本地模型、vLLM 等 OpenAI 兼容接口
  • 内置工具链:命令执行 (Exec)、文件读写 (File)、浏览器控制 (Browser)、图片分析 (Image)
  • 指令处理:快速回复、队列验证、Follow-up
  • Hooks 系统:内置 Hook + Workspace Hook + 优先级管理
  • Memory 系统:记忆索引、关键字搜索

📱 多渠道接入

支持通过即时通讯渠道与 AI Agent 对话,已实现的渠道适配器:

  • 即时通讯 Bot — 私聊/群聊、图片收发、流式输出、会话管理、白名单
  • 微信公众号 — SHA-1 签名验证、access_token 缓存、客服消息 API

渠道适配器采用插件化架构,方便扩展更多平台。

🌐 WebSocket 自定义协议

采用 req/res/event 三种帧类型的自定义协议:

// 请求帧
{"type":"req","id":"1","method":"agent.message","params":{"message":"你好"}}

...

...
// 响应帧
{
"type"
:
"res"
,
"id"
:
"1"
,
"ok"
:
true
,
"payload"
:
{
}
}
// 事件帧
{
"type"
:
"event"
,
"event"
:
"agent.streaming"
,
"payload"
:
{
}
}

支持三步安全握手、会话管理、Cron 定时任务、配置热重载等。

🔌 OpenAI 兼容 HTTP API

提供标准的 /v1/chat/completions 和 /v1/models 接口,可作为现有 OpenAI 客户端的后端使用。

架构设计

┌────────────────────────────────────────────────────┐
│ openclaw-app                                       │
│ Spring Boot 入口 + OpenAI 兼容 REST API            │
├──────────┬──────────┬──────────┬──────────────────┤
│ gateway  │ agent    │ channel  │ plugin           │
│ WebSocket│ 大模型   │ 渠道适配 │ SPI              │
│ 会话管理 │ 工具链   │ 消息归一化│ 插件加载         │
│ Cron 调度│ Memory   │ 出站投递 │ 注册中心         │
├──────────┴──────────┴──────────┴──────────────────┤
│ common                                             │
│ Config · Models · Protocol · Auth · Media · CLI   │
└────────────────────────────────────────────────────┘

模块说明:

  • openclaw-common — 配置管理 (90+ 嵌套类型)、数据模型、协议、认证
  • openclaw-gateway — WebSocket 服务、会话管理、方法路由、Cron 调度
  • openclaw-agent — Agent 引擎、多模型提供者、内置工具、Hooks、Memory
  • openclaw-channel — 渠道适配器、消息归一化、出站投递
  • openclaw-plugin — SPI 插件加载器、注册中心
  • openclaw-app — Spring Boot 入口、模块桥接

技术栈

  • Spring Boot 3.3 — Web + WebSocket + Scheduling
  • Jackson — JSON 序列化
  • OkHttp — HTTP 客户端
  • Caffeine — 本地缓存
  • Lombok — 代码简化
  • docker-java — 沙箱执行
  • JUnit 5 + Mockito — 测试

快速体验

# 环境要求:Java 17+, Maven 3.8+
# 克隆并构建
git clone https://github.com/yuenkang/openclaw-java.git
cd openclaw-java
mvn clean install
# 配置模型(二选一)
export OPENAI_API_KEY=sk-xxx
export OLLAMA_BASE_URL=http://127.0.0.1:11434/v1
# 启动服务
mvn spring-boot:run -pl openclaw-app

服务启动后监听 ws://127.0.0.1:3578/ws,通过 WebSocket 客户端即可与 Agent 对话。

持久化设计

  • 会话历史 — JSONL 格式对话记录,Bot 重启自动恢复最近 50 条上下文
  • 用量追踪 — 多模型 token 用量统计和成本估算
  • 会话元数据 — JSON 原子写入,保证数据一致性

开发历程

项目经历了 33 个迭代 Phase:

  • Phase 1–6 — 基础框架 + Gateway + Agent + 渠道 + 测试
  • Phase 7–18 — Agent 高级功能 + Gateway 深度扩展
  • Phase 19–23 — 工具链 + 认证 + CLI + 渠道类型定义
  • Phase 24–28 — 编译修复 + 基础设施补齐
  • Phase 29–31 — 渠道 Bot 完整层 + 微信公众号
  • Phase 32–33 — 集成测试 + 浏览器控制 + 图片处理 + 持久化

未来计划

  • 更多渠道适配(飞书、钉钉等)
  • 向量数据库 Memory 后端
  • 插件市场
  • Web 管理面板
  • Docker 一键部署

总结

OpenClaw Java 致力于成为 Java 生态中功能完整的 AI Agent Gateway。无论你是想在生产环境部署 AI Agent,还是想学习 Agent 架构设计,都欢迎来看看源码。

目录

  1. 项目简介
  2. 为什么做这个项目?
  3. 核心亮点
  4. 🤖 Agent 执行引擎
  5. 📱 多渠道接入
  6. 🌐 WebSocket 自定义协议
  7. 🔌 OpenAI 兼容 HTTP API
  8. 架构设计
  9. 技术栈
  10. 快速体验
  11. 环境要求:Java 17+, Maven 3.8+
  12. 克隆并构建
  13. 配置模型(二选一)
  14. 启动服务
  15. 持久化设计
  16. 开发历程
  17. 未来计划
  18. 总结

更多推荐文章

查看全部
  • Git 版本控制入门及 Gitee 远程仓库协作指南
  • 基于 Rokid AR 眼镜的会议纪要助手开发实践
  • MixAIHub 提供 ChatGPT Claude Sora 等 AI 官网镜像服务
  • OpenClaw 本地 AI 智能体安装与配置教程
  • HarmonyOS Stage 模型架构解析与应用指南
  • Java 众包招聘系统设计与零工任务智能匹配方案
  • 使用 Copilot 制定 60 天系统学习 AI 计划
  • Python 分支结构详解:if、elif、else 与 match-case
  • llama.cpp 大模型部署指南:CPU/GPU 兼容与 Docker 快速启动
  • 大模型工具函数调用(Function Calling)实战指南
  • Java 背景零基础入门大模型学习路线与核心知识梳理
  • 大模型分布式训练与高效调参技术实战
  • DeepSeek-R1 大模型基于 MS-Swift 框架的部署、推理与微调实战
  • macOS 清理:用免费开源工具 Pearcleaner 彻底卸载应用
  • MindAR 多目标追踪实战:构建交互式乐队 AR 应用
  • Claude Code Rules 配置详解
  • Ubuntu 22.04 系统安装 MuJoCo 完整指南
  • 大模型技术详解:定义、架构、主流模型及应用场景分析
  • Go Web 开发:网络通信、Socket 与数据库实战
  • Python YAML 模块实战:接口测试参数存储与配置

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online