项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1186
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装 Docker 与 Docker Compose(README 的 Docker 快速开始依赖二者)
- 能访问 GitHub 拉取项目源码
- 本机 18080 端口未被占用(README 默认访问地址为该端口)
- 按需准备模型/渠道/工具服务的凭据,用于填入 .env
安装与启动步骤
-
1获取项目源码
从 README 给出的 GitHub 地址克隆仓库到本地,国内网络可按需使用镜像加速。
git clone https://github.com/mateaix/mateclaw.git -
2进入项目目录
切换到克隆下来的项目根目录,后续命令都在此目录执行。
cd mateclaw -
3复制环境变量模板
README 要求先把示例环境变量文件复制为 .env,供 Docker Compose 读取。
cp .env.example .env -
4填写必要配置
编辑 .env,按模板注释填写你要接入的模型、渠道(钉钉/飞书)或工具服务凭据;任务内容只会发给你显式配置的服务。
-
5启动服务
用 Docker Compose 后台拉起容器,README 默认服务地址为 http://localhost:18080。
docker compose up -d -
6访问控制台
在浏览器打开默认地址进入 MateClaw 控制台,可在此启用/验证运行时与配置渠道。
如何确认成功
浏览器访问 http://localhost:18080 能打开 MateClaw 控制台页面,且 docker compose ps 显示容器处于运行状态。
常见问题
Q:启动后 18080 端口打不开怎么办?
A:先确认容器是否正常运行(docker compose ps),若端口被占用,可修改 compose 文件中 18080 的宿主机端口映射后重新执行 docker compose up -d。
Q:不配置 .env 能直接用吗?
A:README 强调任务内容只发送给显式配置的模型、渠道或工具服务,因此使用对话与机器人能力前需在 .env 中填写相应服务的凭据。
Q:如何停止或清理服务?
A:在项目目录执行 docker compose down 停止并移除容器;如需同时清理数据卷再按需加参数。
Q:可以不用 Docker 部署吗?
A:README 提到产物为单个 JAR,可自行在环境中运行,但未给出具体启动命令,需要参考官网文档 https://claw.mate.vip/docs。
注意事项
- 持久化数据由你自己掌控,请按需备份 .env 与 Docker 数据卷。
- 钉钉、飞书等渠道各自独立隔离,单个渠道故障不会影响其他渠道。
- 内置 Spring Boot Actuator 健康监控,可用于确认服务状态。
- README 只提供了 Docker 这一条快速开始路径,其他部署方式请查阅官网文档。
核心亮点
- 基于Spring AI Alibaba,与Java生态无缝集成,企业级应用落地成本低
- 原生支持MCP协议,可标准化接入海量外部工具和API,扩展性强
- 内置多智能体编排和记忆系统,支持复杂任务分解与长期知识积累
不足之处
- 早期项目,文档和社区生态尚待完善
- 依赖Spring生态,对非Java技术栈的开发者不够友好
适用场景
- 企业内部知识库问答和自动化流程处理
- 在钉钉或飞书群中部署多智能体协作助手
- 构建需要长期记忆和持续学习的个性化AI助理
替代项目
LangChain、AutoGen、CrewAI
上一篇:swapper-toolkit
下一篇:golf
同类项目推荐
openInvest
开源
让 AI 代理做投资决策时,可审计、防作弊、敢认错
Research-grade investment decision engine for AI agents: isolated multi-agent commit···
servicenow-mcp
开源
让任何 AI 直接操作 ServiceNow,450+ 工具开箱即用
ServiceNow MCP server: 500+ tools and 26 AI capabilities for any AI (Claude, ChatGPT···
awesome-copilot-studio-agents
开源
103 个现成 Copilot 智能体,粘贴即用
103 paste-ready declarative agents for Microsoft 365 Copilot. No coding. No Azure. D···
EpicStaff
开源
拖拽搭建 AI 智能体流程,自托管更安心
Source-available, self-hosted platform for building AI agent flows - visual editor o···
MathModelAgent
开源
一键自动完成数学建模,直接生成可提交的竞赛论文。
专为数学建模设计的 Agent & skills ,自动完成数学建模,生成一份完整的可以直接提交的论文···
VillagerAgent-Minecraft-multiage···
开源
让多个AI村民在Minecraft里组队干活,还能听你指挥
(VillagerAgent ACL 2024) A Graph based Minecraft multi agents framework
dsh-desktop
开源
本地桌面 AI 工作台,让智能体直接读写项目、查网页、出 Office 文档
DeepSeek Harness Desktop App: a local AI desktop workspace for DSH Sessions, project···
ktx
开源
让 AI 智能体带着公司上下文,准确查数不再瞎猜
ktx is an executable context layer for data and analytics agents Allow Claude Code,···
Awesome-GUI-Agent
开源
一站式获取 GUI 智能体论文与资源,快速入门研究
A curated list of papers and resources for multi-modal Graphical User Interface (GUI···
