统一的 AI Agent 命令行工具与可复用 Go 核心库,支持 CLI、Daemon、Web Console 及 Telegram/Slack Bot 多种运行模式,内置安全审计、凭据管控与可扩展技能系统。
项目简介#
Mister Morph 是一个用 Go 语言编写的 AI Agent 框架,旨在解决 AI Agent 在工程落地中的碎片化与安全失控问题。它既可作为独立的命令行工具使用,也可作为库嵌入到其他 Go 应用中,提供统一的任务执行接口。
核心能力#
多运行模式#
- CLI 模式:单次任务执行,适合脚本集成
- Daemon 模式:HTTP 守护进程,接受队列任务提交
- Console 模式:本地 Web UI,提供任务列表、TODO/联系人/Persona 编辑器及诊断功能
- Telegram Bot 模式:长轮询聊天机器人
- Slack Bot 模式:Socket Mode 聊天机器人
LLM 提供商支持#
原生支持广泛的 LLM 后端:
- OpenAI GPT (gpt-5*)
- Anthropic Claude (claude-3.5+)
- Google Gemini (gemini-2.5+)
- DeepSeek (deepseek-3*)
- Grok (grok-4+)
- Kimi (kimi-2.5+)
- MiniMax、GLM、Cloudflare Workers AI
- Azure OpenAI、AWS Bedrock
内置工具#
read_file/write_file:本地文件读写bash:Shell 命令执行(默认禁用)url_fetch:带认证配置的 HTTP 抓取web_search:DuckDuckGo Web 搜索plan_create:生成结构化计划- Telegram 专用:
telegram_send_file,telegram_send_voice,telegram_react
安全机制#
- 基于配置的凭据注入
- Guard 脱敏与出站策略控制
- 异步审批流程与审计追踪(
guard_audit.jsonl)
技能系统#
自动发现 file_state_dir/skills 下的 SKILL.md 文件并注入系统提示,支持远程技能安装。
开发者工具#
--inspect-prompt:转储最终系统/用户/工具提示--inspect-request:转储完整 LLM 请求/响应 JSON
安装与快速开始#
安装方式#
# 推荐:脚本安装
curl -fsSL -o /tmp/install-mistermorph.sh https://raw.githubusercontent.com/quailyquaily/mistermorph/refs/heads/master/scripts/install-release.sh
sudo bash /tmp/install-mistermorph.sh
# 或从源码安装
go install github.com/quailyquaily/mistermorph/cmd/mistermorph@latest
初始化与运行#
# 安装技能到 ~/.morph/skills/
mistermorph install
# 设置 API Key
export MISTER_MORPH_LLM_API_KEY="YOUR_API_KEY"
# 运行任务
mistermorph run --task "Summarize this repo"
典型应用场景#
- 自动化任务执行:通过自然语言描述任务,代理自动分解并执行
- 多平台聊天机器人:在 Telegram/Slack 中与代理对话,处理文件和消息
- 开发辅助:代码仓库总结、TODO 管理、联系人管理
- 工程审计:可审计的执行链,每步可见可测试
- 嵌入式 AI 能力:将 Go 核心嵌入到自有产品中
- 安全敏感场景:凭据保护、出站访问控制、审批流程
扩展生态#
- Aqua 协作网络:基于 MAEP 演进的独立网络,用于多代理协作
- 消息总线:统一的 in-process bus,支持 Telegram/Slack/Aqua/Discord 等通道