zhayujie--cowagent/README.md

Note

本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

[English] | [中文] | [繁體中文] | [日本語]

CowAgent 是一款开源超级 AI 助手，可主动规划任务、控制你的计算机与外部服务、创建并运行 Skills、构建个人知识库与长期记忆，并通过自我进化与你共同成长——是 Agent Harness（智能体驾驭层）工程的一套参考实现。

CowAgent 轻量、易部署、易于扩展。可接入任意主流 LLM 提供商，在个人电脑或服务器上 7×24 运行，覆盖 Web 与所有主流 IM 平台。

🌐 官网  ·  📖 文档  ·  🚀 快速开始  ·  🧩 Skill Hub  ·  💻 下载  ·  ☁️ 在线试用

🌟 亮点

能力	说明
规划	将复杂任务拆解并逐步执行，循环调用工具直至达成目标
记忆	三层架构（context → daily → core），自动 Deep Dream 蒸馏，混合关键词 + 向量检索
知识	自动将结构化知识整理为 Markdown wiki，构建可视觉浏览的演进知识图谱
进化	Self-Evolution 自动回顾对话以改进技能、跟进未完成任务并巩固记忆与知识，在日常使用中持续成长
技能	一键从 Skill Hub, GitHub、ClawHub 安装；或通过自然语言对话创建自定义技能
工具	内置文件 I/O、终端、浏览器、调度器、记忆检索、网络搜索等 10+ 工具——原生集成 MCP
通道	集成 Web、微信、飞书、钉钉、企业微信、QQ、公众号、Telegram、Slack
多模态	全面支持文本、图像、语音与文件——识别、生成与投递
模型	Claude、GPT、Gemini、DeepSeek、Qwen、GLM、Kimi、MiniMax、Doubao 等——在 Web 控制台一键切换提供商
部署	一行安装、统一 Web 控制台、多种部署模式（本地、Docker、服务器）

🏗️ 架构

CowAgent 是一套完整的 Agent Harness（智能体驾驭层）：消息经 Channels（通道） 流入；Agent Core（智能体核心） 结合记忆、知识与可用工具/技能进行规划与推理；Models（模型） 生成回复，再经原通道发回。各层解耦、可独立扩展。

延伸阅读：架构.

🚀 快速开始

一行安装命令即可完成依赖、配置与启动：

Linux / macOS:

bash <(curl -fsSL https://cdn.link-ai.tech/code/cow/run.sh)

Windows (PowerShell):

irm https://cdn.link-ai.tech/code/cow/run.ps1 | iex

Docker:

curl -O https://cdn.link-ai.tech/code/cow/docker-compose.yml
docker compose up -d

启动后，打开 http://localhost:9899 访问 Web 控制台——一站式与 Agent 对话、配置模型、连接通道、安装技能。

在服务器上部署？在 config.json 中将 web_host 设为 0.0.0.0，以便从外网访问控制台，并设置 web_password 进行保护。别忘了在防火墙或安全组中开放端口 9899。

📖 详细指南：快速开始 · 从源码安装 · 升级

安装后，使用 cow CLI: 管理服务。

cow start | stop | restart        # service control
cow status | logs                  # status and logs
cow update                         # pull latest code and restart
cow skill install <name>           # install a skill
cow install-browser                # install browser automation

💻 桌面客户端：下载 CowAgent 桌面客户端（macOS / Windows）——后端已内置，开箱即用。

🤖 模型

CowAgent 支持所有主流 LLM 提供商。对话、视觉、图像生成、ASR/TTS 与 Embedding 可分别路由到不同厂商。提供商直接在 Web 控制台配置——无需手动编辑文件。

提供商	推荐模型	对话	视觉	图像生成	ASR	TTS	Embedding
Claude	claude-sonnet-5	✅	✅
OpenAI	gpt-5.5, o-series	✅	✅	✅	✅	✅	✅
Gemini	gemini-3.5-flash	✅	✅	✅
DeepSeek	deepseek-v4-flash / pro	✅
Qwen	qwen3.7-plus	✅	✅	✅	✅	✅	✅
GLM	glm-5.2, glm-5v-turbo	✅	✅		✅		✅
Doubao	doubao-seed-2.1 series	✅	✅	✅			✅
Kimi	kimi-k2.7-code	✅	✅
MiniMax	MiniMax-M3	✅	✅	✅		✅
ERNIE	ernie-5.1	✅	✅
MiMo	mimo-v2.5 / pro	✅	✅			✅
LinkAI	One key for 100+ models	✅	✅	✅	✅	✅	✅
Custom	Local models / third-party proxy	✅

各提供商详情见 模型概览.

💬 通道

单个 Agent 实例可并行服务多个通道。大多数通道可直接在 Web 控制台接入。

通道	文本	图像	文件	语音	群组
Web 控制台 (default)	✅	✅	✅	✅
Telegram	✅	✅	✅	✅	✅
Slack	✅	✅	✅		✅
Discord	✅	✅	✅		✅
微信	✅	✅	✅	✅
飞书 / Lark	✅	✅	✅	✅	✅
钉钉	✅	✅	✅	✅	✅
企业微信机器人	✅	✅	✅	✅	✅
QQ	✅	✅	✅		✅
企业微信应用	✅	✅	✅	✅
微信客服	✅	✅	✅	✅
微信公众号	✅	✅		✅

配置详情请参阅 频道概览。

Web 控制台是默认频道，也是配置模型、频道、技能、记忆等功能的统一入口。

🧠 记忆与知识库

长期记忆（Long-term memory） 采用三层架构：对话上下文（短期）→ 每日记忆（中期）→ MEMORY.md（长期）。每晚运行的 Deep Dream 会将零散记忆提炼为精炼的长期条目和叙事日记。详见 长期记忆 · Deep Dream.

个人知识库（Personal knowledge base） 按主题组织结构化知识，与时间线记忆互为补充。Agent 会自动从对话中整理有价值的信息，维护交叉引用和索引；Web 控制台还提供交互式知识图谱视图。详见 个人知识库.

长期记忆 · 三层架构 + Deep Dream

知识库 · 自动整理的 Markdown 维基

🔧 工具与技能

工具（Tools） 是 Agent 用于与系统资源交互的原子能力。技能（Skills） 是由清单文件定义的更高层工作流，通过组合多个工具完成复杂任务。

工具系统

内置工具 涵盖文件 I/O（read / write / edit / ls）、终端（bash）、文件发送（send）、记忆检索（memory）、环境变量（env_config）、网页抓取（web_fetch）、调度（scheduler）、网页搜索（web_search）、视觉（vision）和浏览器自动化（browser）。

MCP 协议 集成了 Model Context Protocol 开放生态中的服务器。只需一个 mcp.json 即可——支持 stdio / SSE 传输、热重载和零代码集成。

了解更多：工具概览 · MCP 集成.

技能系统

• Skill Hub — 开放技能市场：浏览、搜索、一键安装
• GitHub / ClawHub / URL 等 — 从任意来源安装技能
• 对话式创作 — 通过与 skill-creator 对话生成自定义技能；将任意工作流或第三方 API 转化为可复用技能

/skill list                   # list installed skills
/skill search <keyword>        # search the marketplace
/skill install <name>          # one-click install

了解更多：技能概览 · 创建技能.

🏷 更新日志

2026.07.08： v2.1.3 — 桌面客户端（macOS / Windows）、知识库文档管理、按需 MCP 工具检索、繁体中文支持、新模型。

2026.06.18： v2.1.2 — Web 控制台升级（定时任务管理、知识库分类、多个自定义模型提供商）、Self-Evolution 改进、新模型（kimi-k2.7-code、glm-5.2）、安全加固与优化。

2026.06.09： v2.1.1 — Self-Evolution、Web 控制台升级（消息管理、并行会话）、跨平台 MCP 增强（支持并发调用）、新模型（MiniMax-M3、qwen3.7-plus）、Python 3.13 支持。

2026.06.01： v2.1.0 — 国际化、新频道（Telegram、Discord、Slack、微信客服）、CLI 交互升级、精简的一行安装、MCP Streamable HTTP 支持、新模型（claude-opus-4-8、MiMo）。

2026.05.22： v2.0.9 — 模型管理、MCP 协议支持、持久化浏览器会话、新模型（gpt-5.5、gemini-3.5-flash、qwen3.7-max）、部署加固。

2026.05.06： v2.0.8 — 飞书频道重构（语音、流式、二维码接入）、DeepSeek V4 和百度千帆支持、调度工具升级。

2026.04.22： v2.0.7 — 内置图像生成（GPT Image 2、Nano Banana）、新模型（Kimi K2.6、Claude Opus 4.7、GLM 5.1）、记忆与知识库增强。

2026.04.14： v2.0.6 — 知识库、Deep Dream 记忆提炼、智能上下文压缩、多会话 Web 控制台。

2026.04.01： v2.0.5 — Cow CLI、Skill Hub 开源、浏览器工具、企业微信机器人二维码接入。

2026.02.03： v2.0.0 — 重大升级：具备多步任务规划、长期记忆和技能框架的超级 Agent 助手。

完整历史：发布说明

🤝 社区与支持

在 GitHub 提交 Issue，或扫描下方二维码加入我们的微信社群：

🔗 相关项目

• Cow Skill Hub — 面向 AI Agent 的开放技能市场；兼容 CowAgent、OpenClaw、Claude Code 等
• bot-on-anything — 轻量级 LLM 应用框架，集成 Slack、Telegram、Discord、Gmail 等
• AgentMesh — 开源多 Agent 框架，通过团队协作解决复杂问题

🏢 企业服务

LinkAI 是面向企业和开发者的一体化 AI Agent 平台，为 CowAgent 提供托管部署和企业级支持：

• 🚀 零部署托管运行时 — 一分钟内启动 CowAgent 在线助手，无需自备服务器
• 🧠 Agent 基础设施 — 统一访问 LLM、知识库、数据库、技能和工作流；即插即用的构建模块，扩展 CowAgent 能力
• 🏢 团队与企业功能 — 工作空间、基于角色的访问控制、审计日志和生产场景的私有化部署

企业咨询：sales@simple-future.tech，或扫描二维码通过微信联系我们的团队。

🛠️ 开发与贡献

欢迎各类贡献——新功能、Bug 修复、性能优化、文档，或在 Skill Hub. 分享你的技能。请参阅 CONTRIBUTING.md 入门，然后开启 Issue 讨论或直接提交 PR。

⭐ Star 本项目以表示支持，并选择 Watch → Custom → Releases 以接收新版本通知。随时欢迎 PR 和 Issue。

🌟 贡献者

⚠️ 免责声明

1. 本项目采用 MIT License 许可，仅供技术研究与学习。你须自行遵守所在地区的适用法律法规；维护者不对使用本项目产生的任何后果承担责任。
2. 成本与安全： Agent 模式消耗的 token 远多于普通对话——请选择兼顾质量与成本的模型。Agent 可访问本地操作系统，因此仅在可信环境中部署。
3. CowAgent 是纯开源项目，不参与、不授权、不发行任何加密货币。

📌 项目更名公告

本项目此前名为 chatgpt-on-wechat，现已正式更名为 CowAgent。旧的 GitHub URL 会自动重定向；现有用户可选择运行 git remote set-url origin https://github.com/zhayujie/CowAgent.git 以更新本地 remote。