cow-go

CowAgent 的 Go 实现 — 基于 Origin v2 与 eino ADK 的多渠道超级 AI 助理

GitHub · 文档 · CowAgent 文档 · 功能差距

---

cow-go 是开源 CowAgent 的 Go 语言重写（基于 CowAgent 的产品与架构设计，遵循 MIT 许可证）。在单进程内运行多个 Origin Service，通过 RPC 连接 Agent 核心、工具、记忆、知识库与 14+ 消息渠道，支持流式对话、MCP 工具、Skills 与自进化（Evolution）。

适合需要 Go 性能、服务化边界、Origin 跨节点 RPC 的二次开发与平台化部署；完整产品体验与生态仍以 Python 版 CowAgent 为参考。

---

特性

能力	说明
多渠道	Web、飞书、钉钉、企微、微信、Telegram、Slack、Discord、QQ 等
Agent 核心	eino ADK：多轮 tool-call、LLM 路由（OpenAI / Claude / Gemini / Qwen / DeepSeek 等）
工具	文件、终端、浏览器、调度、网页抓取、MCP 协议
记忆与知识	向量记忆（Redis）、知识库 RAG、会话持久化（Redis + SQLite）
自进化	空闲扫描、审查 Agent、工作区备份与回滚
流式 RPC	RPC_RunStream、Bridge SSE、统一取消与 request_id
控制台	嵌入式 Web UI（http://localhost:8081/console/）
进程管理	cow-go start / stop / status / logs / update

功能覆盖率约 82–85%（相对 Python CowAgent），详见 doc/gap-analysis.md。

---

架构

┌─────────────────────────────────────────────────────────┐
│  Channel Services  (Web / 飞书 / 钉钉 / Telegram …)   │
└────────────────────────┬────────────────────────────────┘
                         │ ChannelMessage
┌────────────────────────▼────────────────────────────────┐
│  BridgeService  —  RPC_Chat / ChatStream (流式 RPC)      │
└────────────────────────┬────────────────────────────────┘
                         │
┌────────────────────────▼────────────────────────────────┐
│  AgentService  —  eino Runner · MCP · Skills · SSE       │
└───┬────────────┬────────────┬────────────┬──────────────┘
    │            │            │            │
 ToolService  MemoryService  SessionService  EvolutionService …

• 框架：Origin v2（node + service.Service + RPC）
• 详细设计：doc/cowagent-go-design.md · doc/README.md

---

快速开始

环境要求

• Go 1.26+
• Redis（会话 / 记忆，按配置可选）
• LLM API Key（在 config/agentservice.json 等中配置）

构建

git clone https://github.com/rhinewg/cow-go.git
cd cow-go
go build -o cow-go .

配置

1. 参考 config/README.md 准备 config/cluster.json 与各 *service.json
2. 填写 agentservice.json 中的 api_key、model 等（勿提交含密钥的文件）
3. 可选：在 config/skills/、config/prompts/system.md 自定义技能与系统提示词

运行

./cow-go                  # 前台
./cow-go start            # 后台（写入 PID 文件）

入口	地址
管理控制台	http://localhost:8081/console/
Agent API	http://localhost:8081/api/v1/
Origin RPC	127.0.0.1:8801（默认）

验证

go test ./... -count=1

---

文档

文档	说明
doc/README.md	文档总索引（架构、模块、开发指南）
doc/cowagent-go-design.md	Python → Go 设计对照
doc/gap-analysis.md	功能差距与优先级
doc/rpc-stream/	流式 RPC 设计与实现
config/README.md	配置文件说明

---

技术栈

类别	技术
服务框架	Origin v2
Agent	CloudWeGo eino ADK
HTTP	Gin（origin ginmodule）
MCP	modelcontextprotocol/go-sdk
存储	Redis、SQLite
前端控制台	Vue 3 + Vite

---

与 CowAgent (Python) 如何选择

选 CowAgent	选 cow-go
开箱即用、Docker、Skill Hub	Go 单体二进制、Origin RPC
功能最全、文档与社区成熟	服务边界清晰、流式 RPC、易扩展节点
个人助理默认首选	同 monorepo 二次开发 / 平台集成

---

相关项目

• CowAgent — Python 主实现
• Origin — 分布式 Go 服务框架
• eino — LLM 应用开发框架
• eino-ext — eino 扩展组件（模型、MCP、Embedding 等）

---

致谢

cow-go 建立在以下开源项目之上，衷心感谢各项目作者与社区贡献者：

项目	在本仓库中的角色	致谢
Origin v2	服务框架：node、service.Service、RPC 与流式 RPC	感谢 duanhf2012 及全体 Origin 贡献者
eino	Agent 引擎：ADK、Runner、工具与中间件	感谢 CloudWeGo 团队及 eino 社区贡献者
eino-ext	扩展能力：OpenAI / Claude / Gemini / Qwen 等模型适配、MCP 工具、DashScope Embedding、Redis 检索与索引	感谢 eino-ext 各模块维护者与贡献者

没有上述项目的持续维护与开放，cow-go 的服务化架构与 Agent 能力无法实现。若你在使用中发现问题，也欢迎向上游项目反馈或参与贡献。

---

许可

本项目基于 CowAgent 的 Go 重写实现，采用与 CowAgent 相同的 MIT License。

• cow-go 版权：Copyright (c) 2026 rhinewg
• 上游 CowAgent：Copyright (c) 2022 zhayujie（MIT）

使用、修改与分发时请保留本仓库 LICENSE 中的版权与许可声明。

贡献

欢迎 Issue 与 Pull Request。开发前请阅读 doc/README.md 中的贡献指引与测试说明。