zhayujie /chatgpt-on-wechat
Open-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
★ 47,944⑂ 10,435👁 310⑃ 1,404● 2,307▤ 86
+13
Daily
+172
Weekly
+529
Monthly
47,944
stars
10,435
forks
310
watchers
1,404
prs
2,307
issues
86
releases
README
[English] | [中文] | [繁體中文] | [日本語]
CowAgent is your own open-source personal AI agent. It plans tasks proactively, uses tools, skills and MCP, and gets to know you over time through long-term memory, a knowledge base and self-evolution. It's also an open, extensible Agent Harness.
CowAgent is multi-model, multi-channel and multi-agent, lightweight and built to extend. Plug in any major LLM provider, run it 24/7 on your computer or server, and reach it from the web and all major IM platforms.
🌐 Website ·
📖 Docs ·
🚀 Quick Start ·
🧩 Skill Hub ·
💻 Download ·
☁️ Try Online
🎬 Demo
Your browser can't play this video.
Watch the demo on our website →
🌟 Highlights
| Capability | Description |
| :--- | :--- |
| Planning | Decomposes complex tasks and executes them step by step, looping over tools until the goal is reached |
| Multi-Agent | Build a team of Agents, each with its own role, model, skills, and knowledge, collaborating within a shared conversation |
| Memory | Three-tier architecture (context → daily → core), automatic Deep Dream distillation, hybrid keyword + vector retrieval |
| Knowledge | Auto-curates structured knowledge into a Markdown wiki, builds an evolving knowledge graph with visual browsing |
| Evolution | Self-Evolution reviews conversations automatically to improve skills, follow up on unfinished tasks, and consolidate memory and knowledge, growing through everyday use |
| Skills | One-click install from Skill Hub, GitHub, ClawHub; or create custom skills via natural-language conversation |
| Tools | Built-in file I/O, terminal, browser, scheduler, memory retrieval, web search, and 10+ more tools — with native MCP integration |
| Channels | Integrates with Web, WeChat, Feishu, DingTalk, WeCom, QQ, Official Accounts, Telegram, and Slack |
| Multimodal | First-class support for text, images, voice, and files — recognition, generation, and delivery |
| Models | Claude, GPT, Gemini, DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao, and more — swap providers from the Web console with one click |
| Deploy | One-line installer or desktop client, unified Web console, multiple deployment modes (local, Docker, server) |
🏗️ Architecture
CowAgent is a complete Agent Harness: messages flow in through Channels; the Agent Core plans and reasons over memory, knowledge, and the available tools and skills; Models generate the response, which is sent back through the originating channel. Every layer is decoupled and independently extensible.
Read more in Architecture.
🚀 Quick Start
A one-line installer takes care of dependencies, configuration, and startup:
Linux / macOS:
bash
bash Deploying on a server? Set web_host to 0.0.0.0 in config.json to make the console reachable from outside, and set web_password to protect it. Don't forget to open port 9899 in your firewall or security group.
📖 Detailed guides: Quick Start · Install from SourceTop issues
#2998[Bug] CowAgent have risk leaking user's privacy and executing destruction commands on user's computer7 comments · 2026-07-31#3608[Feature] Images are never passed to the main model — every image goes through a text bottleneck in the toolvision5 comments · 2026-10-08#3628[Feature Request] 增强模型与能力管理:支持自定义 API 协议格式、各能力独立关闭开关、及思考强度自由调节4 comments · 2026-10-10#3202[Feature] wire up RuntimeIdentity.user_id — 5 consumer sites are already waiting for it4 comments · 2026-09-20#3136Desktop client: allow choosing install directory and data directory during installation4 comments · 2026-09-10#3852[Feature] Support model alias mapping so the model config page and selector no longer show raw model IDs2 comments · 2026-10-28#3766[Feature] Borg and pre-emptive digestion of existing toolsets2 comments · 2026-10-15#3923[Feature] add sandbox feature1 comments · 2026-11-10
Discussions
#3929胜算云|CowAgent 赞助沟通0 comments · 2026-11-13#3884分享:900 题上下文评测,长会话截断策略可量化0 comments · 2026-11-02#3841[配置分享] 在 chatgpt-on-wechat 中接入 Twinkle Model(OpenAI / Anthropic 兼容)0 comments · 2026-10-26#3211Using the Jev model in CowAgent1 comments · 2026-09-21#31382.1.80 comments · 2026-09-11#2981当前版本不支持小米mimo的asr模型以及其他tts模型配置1 comments · 2026-07-20#29462.1.30 comments · 2026-07-08#2921Really want Matrix channel support!1 comments · 2026-06-26
Latest release
2.2.2 2.2.2 2026-10-30🌐 English | 中文 💬 Guest Pages Share an Agent as a standalone chat page, or embed it in your website as a chat window. Visitors open the link and start chatting without signing in, which suits product inquiries, knowledge base Q&A, customer support, and similar scenarios: - Standalone pages: each page gets its own link, visitors keep their chat history, and the name, icon, theme color, welcome message, and suggested questions are all customizable. - Embedded chat window: a single code snippet embeds the page in your website, with a chat button in the bottom-right corner. Y