MTClaw × BossAgents 数字员工集成验证报告
一、项目概述
1.1 目标
为HICOOL开发者挑战赛·MTClaw智能体赛道完成数字员工与MTClaw的完整集成验证,证明三场景流程能走通,具备进入复赛资格。
1.2 三场景定义
- 场景A:MTClaw调度 + Ollama端侧模型(gemma3:4b)
- 场景B:MTClaw调度 + 云端模型(deepseek-r1:8b)
- 场景D:无MTClaw,BossAgents直接执行
1.3 核心认知
- MTClaw是工具路由代理,不是工作流引擎
- MTClaw只路由到worker入口,不干预worker内部执行
- BossAgents负责worker内部的多步骤工作流编排(规则引擎+LLM)
- MTClaw的加速收益来自"把高频确定性操作从大模型链路中剥离出来"
二、技术架构
2.1 架构图
用户请求
↓
【场景A/B】MTClaw路由层
├─ 匹配工具? → 本地执行wrapper → 调用BossAgents API → 返回结果
└─ 不匹配? → 透传给上游大模型 → 返回结果
【场景D】BossAgents直接执行
└─ 规则引擎判断 → LLM推理 → 返回结果
2.2 关键组件
- MTClaw配置:
C:\Users\Administrator\.function-router\config.json
- routing.model: gemma3:4b(调度模型,快速路由)
- upstream.model: deepseek-r1:8b(上游模型,处理复杂请求)
- BossAgents配置:
D:\bossagents\server\data\demo\config.json
- mtclaw.enabled: true
- mtclaw.base_url: http://127.0.0.1:18790/v1
- Wrapper脚本:
C:\Users\Administrator\.function-router\scripts\*.js
- 8个数字员工对应的wrapper脚本
- 每个wrapper调用BossAgents API并返回结果
三、集成过程
3.1 已解决的问题
#### 问题1:编码问题
现象:BossAgents传递中文给MTClaw时编码错误,MTClaw收到乱码无法理解意图
解决方案:
headers: { 'Content-Type': 'application/json; charset=utf-8' },
body: new TextEncoder().encode(JSON.stringify({...}))
#### 问题2:Wrapper脚本问题
现象:原始wrapper脚本只返回路由决策,没有真正调用BossAgents API
解决方案:修改wrapper脚本,真正调用https://ylxt.chat/api/digital-staff/run
示例:
const result = await makeRequest('https://ylxt.chat/api/digital-staff/run', {
staff_id: 'procurement_assistant',
input: input
});
3.2 已完成的工作
- ✅ MTClaw编码修复
- 添加UTF-8编码头
- 使用TextEncoder确保中文正确传递
- ✅ Wrapper脚本创建/修复(8个数字员工)
- procurement_assistant.js
- vendor_manager.js
- cost_optimizer.js
- SCSAI_creator.js
- ecr_reviewer.js
- data_clerk.js
- system_health.js
- content_generator.js
- ✅ BossAgents MTClaw配置
- 启用MTClaw:
enabled: true - 配置base_url:
http://127.0.0.1:18790/v1
- ✅ 三场景验证
- 场景A:MTClaw路由成功,业务执行成功
- 场景B:MTClaw路由成功,业务执行成功
- 场景D:BossAgents直接执行成功
- ✅ 批量测试脚本
- mtclaw-benchmark.js
- mtclaw-three-scenario-benchmark.js
- mtclaw-quick-benchmark.js
- verify-three-scenarios.js
四、验证结果
4.1 服务状态
- BossAgents服务:✅ 正常运行(https://ylxt.chat)
- MTClaw服务:✅ 正常运行(http://localhost:18790)
4.2 三场景验证结果
测试用例:采购助手(procurement_assistant)
测试输入:请帮我查询今天的采购订单
| 场景 | 状态 | 耗时 | 说明 |
|------|------|------|------|
| 场景A | ✅ 成功 | 15974ms | MTClaw + Ollama端侧调度 |
| 场景B | ✅ 成功 | 15572ms | MTClaw + 云端调度 |
| 场景D | ✅ 成功 | 6189ms | BossAgents直接执行 |
4.3 性能分析
#### 路由性能
- gemma3:4b(调度模型):平均路由时间 5-70ms
- deepseek-r1:8b(上游模型):平均路由时间 300-1300ms
#### 场景对比
- 场景D最快:无MTClaw路由开销,直接执行
- 场景A/B较慢:包含MTClaw路由开销 + LLM推理时间
- 加速场景:高频确定性操作(如系统健康检查、数据查询)通过MTClaw本地执行可显著加速
4.4 关键发现
- MTClaw路由本身很快:5-70ms
- 主要耗时在LLM推理:10-15秒
- 场景D适合:需要完整工作流编排的复杂任务
- 场景A/B适合:需要工具路由 + 工作流编排的混合场景
五、演示页面
5.1 访问地址
https://ylxt.chat/demo/unified-demo.html
5.2 演示功能
- 三场景切换(A/B/D)
- 8个数字员工选择
- 实时执行结果展示
- 性能指标对比
六、竞赛材料
6.1 代码仓库
- BossAgents主仓库:
D:\bossagents - MTClaw配置:
C:\Users\Administrator\.function-router\
6.2 关键文件
- 配置文件
- MTClaw主配置:
config.json - 工具定义:
function-builtin.jsonl - BossAgents配置:
server/data/demo/config.json
- Wrapper脚本(8个)
- 位于:
C:\Users\Administrator\.function-router\scripts\
- 测试脚本(4个)
- 位于:
D:\bossagents\scripts\
- 演示页面
D:\bossagents\public\demo\unified-demo.html
6.3 验证命令
# 启动BossAgents服务
cd D:\bossagents
node server.js
# 启动MTClaw服务
cd C:\Users\Administrator\.function-router
node server.js
# 运行三场景验证
node scripts/verify-three-scenarios.js
# 运行性能测试
node scripts/mtclaw-quick-benchmark.js
七、结论
7.1 完成情况
✅ 三场景验证全部通过
- 场景A(MTClaw + Ollama端侧):成功
- 场景B(MTClaw + 云端):成功
- 场景D(BossAgents直接执行):成功
7.2 技术价值
- 证明了MTClaw × BossAgents集成的可行性
- 实现了工具路由 + 工作流编排的分层架构
- 提供了三场景的完整实现和验证
- 具备进入复赛的资格
7.3 后续优化方向
- 性能优化:优化LLM推理速度,减少端到端延迟
- 工具扩展:添加更多数字员工和工具
- 监控告警:添加执行监控和异常告警
- 文档完善:补充API文档和使用指南
报告生成时间:2026-07-22
验证环境:Windows 11, Node.js v18+
服务版本:BossAgents v1.0, MTClaw v1.0
BossAgents