Agent-Z

Hermes-Brain + OpenClaw-Body 双核驱动的模块化 AI 智能助手

智能意图理解 · 自动学习进化 · 技能生命周期管理 · 多平台接入

agent-z — bash

$ python -m cli.main
Agent-Z 已启动 · 模型: claude
> 帮我总结一下今天的会议纪要

            ✔ 已读取 3 份文档，生成了 1200 字的会议纪要并保存到 output/meeting-summary.md
          

核心特性

Agent-Z 不只是对话机器人，而是一套完整的 Agent 生命周期系统

🧠

智能决策

LLM 驱动的意图理解与工具选择，自动判断何时调用工具、调用哪个工具。

📋

技能系统

技能加载、匹配、执行、追踪与生命周期管理（active → stale → archived）。

🔬

自我进化

用户对话 → 轨迹记录 → Curator 评估 → 技能合成，越用越聪明。

🛠️

工具生态

12+ 工具类别：文件、命令、网络、浏览器、多媒体、定时任务、记忆等。

🔌

多协议通信

ACP、A2A、JSON-RPC、HTTP 四种协议，覆盖 CLI、编辑器、平台多渠道接入。

🌍

国际化

内置中文、英文、日文、韩文四种语言，全链路 i18n 支持。

系统架构

五组件并行入口架构，全部通过标准化协议汇聚到 Agent Core

CLIcli/main.py · ACP

TUItui/main.py · JSON-RPC

ACP Serveragent/acp/ · ACP 协议

Gatewaygateway/server.py · HTTP

▼ 标准化协议

Agent Coreagent/agent.py · Agent Loop

▼ HTTP

Gateway 服务多渠道平台接入 · 认证 · 限流

入口组件核心服务

平台支持

通过 Gateway 统一接入多种即时通讯与协作平台

飞书

企业微信

钉钉

Microsoft Teams

IRC

Discord

Slack

WeCom

Matrix

● 支持 20+ 平台适配器，通过统一协议接入，消息 / 卡片 / 图片 / Webhook 全覆盖

快速开始

要求 Python 3.11+，三分钟跑起来

安装与启动

$ pip install -r requirements.txt
$ python -m cli.main setup
$ python -m tui            # TUI 界面（推荐）
$ python -m cli.main chat  # 交互式 CLI
$ python -m agent.acp.entry # ACP 服务
$ python -m gateway.server # 多渠道网关

四种方式使用 Agent-Z

CLI — 命令行交互，适合脚本与自动化
TUI — Textual 富终端界面，实时流式输出
编辑器 — 通过 ACP 协议接入 VS Code 等
多渠道 — 通过 Gateway 接入 IM 平台

查看完整指南

文档导航

从架构到开发规范，一站获取

🏛️

架构设计

五组件并行入口架构详解与通信协议设计

🚀

快速上手

5 分钟快速开始，CLI / TUI / Gateway 配置

🧩

模块文档

Agent / Skills / Gateway / Tools / CLI 模块说明

📐

详细设计

类图、时序图、数据库与 API 设计

📖

用户手册

完整功能使用说明与操作指南

📝

变更日志

版本更新记录与演进历史