README.md
July 17, 2026 · View on GitHub
ClawMate:主动式端侧智能体系统
ClawMate: A Proactive On-Device Agent System
| MobiAgent Paper | MobiMem Paper | Huggingface | MobiInfer |
新闻
- [2026.7.18] 🔥 我们开源了 ClawMate HarmonyOS App 和 ClawMate Desktop !
演示视频
|
自动采集并整理手机数据 |
“碰一碰”快速交换个人画像 |
点一杯最喜欢的奶茶 |
与千问协同购买华为Pura X手机 |
前置要求
- HarmonyOS NEXT > 6.0
- 华为开发者平台:DevEco Studio
- Python > 3.10
安装
HarmonyOS App
HarmonyOS App 源码通过 Git submodule 管理,路径为 clawmate-harmonyAPP/。首次使用时使用以下命令更新submodule:
git submodule update --init clawmate-harmonyAPP
源码仓库:clawmate-harmonyAPP
开发环境
- 安装 DevEco Studio,建议使用支持 HarmonyOS NEXT / API 20+ 的版本。
- 在 DevEco Studio 的
Settings/Preferences > SDK > HarmonyOS > SDK Platforms中勾选并安装对应 API 版本的 Native SDK。 - 把
hdc对应目录加入PATH,确认命令行可执行hdc list targets。 - Python 3.10+。
编译运行
使用 DevEco Studio:
- 打开
clawmate-harmonyAPP/目录。 - 首次构建时让 DevEco Studio 生成根目录
build-profile.json5,并配置 自动签名或手动签名。 - 选择
entry模块和目标设备。 - 点击 Run / Debug 安装到 HarmonyOS NEXT 手机(需要手机打开开发者模式)。
桌面应用
桌面应用可以直接从Release页面下载。
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | ClawMate-desktop-mac-arm64.dmg |
| Windows | ClawMate-desktop-windows-x64.exe |
| Linux | ClawMate-desktop-linux-x64.AppImage |
- Windows:运行
.exe安装包。 - macOS:打开
.dmg,将应用拖入 Applications。 - Linux:给
.AppImage添加执行权限后直接运行。
安装后首次启动会把随包配置复制到用户数据目录。模型文件、日志和缓存会保存在系统用户数据目录,覆盖安装或升级应用时不会写入安装目录。
用户也可以从源码构建桌面应用,方式记录在 build.md 文档中。
模型推理
ClawMate 使用 MobiAgent作为模型推理框架,使用 MobiInfer 作为 HarmonyOS NEXT 设备侧推理引擎。MobiInfer 负责在手机端加载量化后的端侧模型,并为 ClawMate 的 GUI Agent、个人数据理解和推荐能力提供本地推理服务。
推荐使用项目默认配置的模型与运行时组合:
- 推理框架:MobiAgent
- 推理引擎:MobiInfer
- 量化工具:mobi-autoround
- 模型来源:MobiMind
桌面端会负责模型下载、运行时启动、日志查看和 HDC 连接管理。通常不需要手动替换推理引擎;如果需要从源码构建 MobiInfer 或调试运行时,可以参考 MobiInfer 仓库。
引用
如果你觉得我们的工作有帮助,欢迎引用
@article{zhang2025mobiagent,
title={MobiAgent: A Systematic Framework for Customizable Mobile Agents},
author={Zhang, Cheng and Feng, Erhu and Zhao, Xi and Zhao, Yisheng and Gong, Wangbo and Sun, Jiahui and Du, Dong and Hua, Zhichao and Xia, Yubin and Chen, Haibo},
journal={arXiv preprint arXiv:2509.00531},
year={2025}
}
@article{liu2025beyond,
title={Beyond Training: Enabling Self-Evolution of Agents with MOBIMEM},
author={Liu, Zibin and Zhang, Cheng and Zhao, Xi and Feng, Yunfei and Bai, Bingyu and Feng, Dahu and Feng, Erhu and Xia, Yubin and Chen, Haibo},
journal={arXiv preprint arXiv:2512.15784},
year={2025}
}