Harness 与 Agent 工程 · 运行控制与长任务 · 2026-05-27

AgentScope Builder 快速体验:用 Harness 框架快速构建企业自进化智能体

用 Harness 框架,轻松将个人智能体助手升级为企业级分布式智能体平台,实现从本机到云端的一键部署与团队协作。

核心内容:

  1. 基于Harness框架的个人智能体示例“MinQwenPaw”解析
  2. 企业级智能体平台AgentScope Builder的核心功能
  3. 从个人应用到企业级部署的平滑演进路径

在 AgentScope Java 1.1.0 版本[1]中,我们把 QwenPaw、OpenClaw、Coding Agent 那套「工作区即真理 + 自我进化」的体验,沉淀成了 HarnessAgent + AbstractFilesystem + 内置压缩与双层记忆的Harness Engineering 工程基础设施。当时我们留下了一个承诺:写一套 Agent 逻辑,按需切换形态,从个人本机一路扩到企业分布式部署。

HarnessAgent 版本发布后关注度非常高,很多开发者想要一个真实的应用场景。今天我们就同时发布了 Agentcope Claw 和 Agentcope Builder,它们既是实际发行的示例产品,也是 AgentScope Java Harness 的具体实践案例:

下面我们先把 AgentScope Claw 这个示例讲透 —— 因为 Builder 不是凭空出现的,它是被 Claw 没能解决的那一组问题企业级需求中催生出来的。

AgentScope Claw-用 Harness 框架

可以快速做出一个“MinQwemPaw”

Cloud Native

▍“MinQwenPaw”是什么

“MinQwenPaw”可以理解为是 [QwenPaw] 的轻量级 Java 版本示例:一款装在你自己电脑上的个人助手,下文有些部分,我们会直接叫做“MinQwenPaw”(简化版 Java QwenPaw 的意思)。

注意:“MinQwenPaw”只是 AgentScope Java Harness 的能力展示示例,如果你需要真正的本地可部署版本,请使用我们发布的 QwenPaw 产品。本文重点是下文的 AgentScope Builder 企业级智能体平台。

“MinQwenPaw”以你的身份、在你的文件系统和 shell 里干活,并且会随着使用慢慢“长大” —— 它学到的技能、孵化的子智能体、攒下的记忆,都是它自己在工作区里写的一堆文件。

“MinQwenPaw”在仓库里的位置:

agentscope-examples/agents/agentscope-claw/

它不是一段示意代码,而是一个完整的 Spring Boot 应用:JDK 17、一条 mvn package、一条 java -jar,浏览器打开 http://localhost:8080 就能用。所有的状态都落到 ~/.agentscope/ 工作区下,可以用 CLAW_HOME 环境变量改写;首次启动会自动生成一个内置的 default agent,让你不写一行代码就能开始对话。

▍“MinQwenPaw”三个核心能力

实际用过过 QwenPaw 正式产品的用户都知道,“MinQwenPaw”真正有意思的不是“能聊天”,而是下面三件事 —— 它们也正是 Harness 的设计承诺第一次完整地体现在一个真实产品里:

1. 工作区驱动的自我进化

“MinQwenPaw”的所有状态都不在数据库里,而是在 ~/.agentscope/claw/workspace/ 这个目录下:

每一次对话结束,都会有新事实被提炼出来追加到当日的记忆流水账,后台调度器再周期性地把它们合并进 MEMORY.md。调整 agent 的人格、知识、技能不需要动代码,只需要编辑工作区里的文件 —— 改一个文件就等于升级一次 Agent。做了,Java 现在也能做了,且是使用 AgentScope Harness 运行时在背后支撑。

2. 直接以你的身份在本机文件系统和 Shell 里干活

“MinQwenPaw”用的文件系统后端是 LocalFilesystemWithShell —— 没有沙箱、没有远端,所有的读写和命令都直接落到本机操作系统。这在你自己机器上不是 bug,是 feature:你让它“帮我把 ~/Downloads 下三个月前的文件挪到归档目录”,它真的能做到,因为它有 Shell。

Harness 的工具集是按“后端能力”条件性注册的 —— 在 Claw 这种本机模式下,execute Shell 工具会自动出现在 Agent 的工具集里;换到不可信环境(如后面会讲的 Builder 远端模式),同一段 Agent 代码里的 Shell 工具会自动消失。这是「同一份 Agent 逻辑、不同形态」的第一个具体体现。

3. 直接出现在你常用的 APP 上

“MinQwenPaw”开箱内置 6 种通道:

也就是说:你可以从一条钉钉 DM、或者一个 GitHub Issue 评论里 @claw,它会带着完整的工作区上下文回应你。每个 agent 在 bootstrap 时还会自动注册 outbound_send 工具,让它可以主动往任意通道发消息 —— 子任务跑完后,Channel 路由组件会自动复用入站时的地址,让“完成通知”自然地回到当初触发它的那个钉钉/企微会话。

通道层还自带了一组默认的可靠性机制 —— 幂等去重、Bot-loop 防护、企微签名校验、AES-256-CBC 解密、access-token 续签,这些在企业 IM 集成里“不写就出事”的细节,框架都已经做好了。

▍“MinQwenPaw”的边界

“MinQwenPaw”本质上还是一个本地助手应用,只要你试着把这套东西放到一个团队里,问题就会接连出现:多个人怎么共享同一个进程?每个人自进化出来的工作区怎么互不污染?多副本部署时同一个用户的记忆怎么跨节点共享?让 agent 跑用户输入的代码怎么不出事?做出来的好 Agent 怎么分享给同事但又不让别人改坏?

这五个问题,每一个单独看都不大,但合起来意味着“MinQwenPaw”必须被重新装进一个不一样的容器里。这就是 AgentScope Builder 的起点。

从“MinQwenPaw”到

Builder-QwenPaw 的企业级部署形态

Cloud Native

Claw 假设的是“一台机器、一个用户、一个工作区”。把这套假设直接套到团队场景,会同时崩掉五个地方 —— 每一个都不是"再开几个 Claw 进程"能补上的:

1. 多人共用一个进程,但每个人要看到自己的视图。“MinQwenPaw” 只认本机当前用户。多人登录、按 token 鉴权、按用户分会话 —— 这些都不在 claw 的范围内。2. 每个用户的工作区必须互不污染。Agent 自进化的副作用是它会写文件 —— 学到的技能、生成的子 Agent、攒下的 MEMORY.md。Alice 调教过的 agent 不能让 Bob 看到他不该看到的东西,更不能让 Bob 的对话覆盖掉 Alice 的记忆。但 claw 用的是一个全局工作区。3. 多副本部署时,同一个用户必须看到一致的工作区。把“MinQwenPaw”起两个进程在两台机器上,各自的本机磁盘是隔离的;同一个用户的请求落到不同副本上,看到的是两份不同的记忆。4. 服务端跑用户输入的代码必须有 OS 级隔离。“MinQwenPaw” 默认开了本机 Shell —— 这在你自己电脑上是核心体验,在多租户服务上就是直接的攻击面。5. 做出来的好 Agent 要能被分享,但不能被改坏。团队里需要的不是“整份导出再让别人导入”,而是细粒度的“我授权给某个组用、但他们不能改”。这五个问题归结到一件事:「一个用户、一台机器、一个工作区」要被换成「多个用户、多台机器、多组被命名空间隔离的工作区」。这不是给“MinQwenPaw”加几个补丁能解决的 —— 它需要在 Harness 这一层工作空间之上,重新搭一层多租分布式户隔离的体系。

Builder 把“MinQwenPaw”的核心体验装进了一个面向团队和企业的 Web 平台。一句话定位:

Builder 是 OpenClaw 的分布式版本 —— 同样的自我进化、同样的工作区驱动、同样的 Harness 运行时;只是从“一个人”变成“一个组织”,从“一台笔记本”变成“一组横向扩容的服务”。

作为一款平台产品,它的核心能力有如下两点:

  1. QwenPaw 的多租户、可分布式版本,支持多人共用一个平台,每个人的 Agent 互不干扰,支持多副本部署,用户工作区跨节点一致。2. 零代码智能体开发平台,用户不需要写一行代码,就能在 Web UI 上创建、调教、分享自己的 Agent,Agent 的所有状态都落在工作区里,自动驱动自我进化。

▍Builder 产品定位 1 —— QwenPaw 的多租户、可分布式版本

Builder 的产品设计有一条底层核心设计 —— workspace 是 Agent 的资产。所有的隔离、所有的共享、所有的多租户能力,全部围绕这一点展开。

这个模型直接来自团队协作的真实需求 —— “做出好东西后能分享、但不必交出控制权”。它也意味着:只要 workspace 这个抽象设计得足够干净,所有上层产品能力(创建、编辑、分享、fork、计费、审计)都能以同一种方式表达。这正是 Builder 的产品骨架。

▍Builder 产品定位 2 —— 零代码智能体开发平台

随着模型能力的不断提升,智能体构建的边界也在不停的拓展。不止是开发人员,非开发者也期望能在网页上点几下就能搭出一个能干活的 Agent。这类产品的核心体验要求:选模板 → 配参数 → 连工具 → 发布,降低了 Agent 开发的入口门槛。

Builder 同样也是一款智能体开发平台:用户从浏览器登录,不写代码就能搭出自己的 Agent。在 UI 上挑模板(或从空白脚手架起步)、选模型、写 system prompt、勾选技能 / 子 Agent / 工具 / MCP 服务,保存即可直接对话 —— 门槛低、上手快、所见即所得。

真正的差异:创…

— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/shuziyuangong/2026052793158.html