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

CowAgent is an open-source super AI assistant that proactively plans tasks, operates your computer and external services, creates and runs Skills, and grows alongside you with a personal knowledge base and long-term memory — a reference implementation of Agent Harness engineering.

CowAgent is lightweight, easy to deploy, and built to extend. Plug in any major LLM provider, run it across Web and major IM platforms, 24/7 on a personal computer or server.

🌐 Website  ·  📖 Docs  ·  🚀 Quick Start  ·  🧩 Skill Hub  ·  ☁️ Try Online

🌟 Highlights

Capability	Description
🤖 Autonomous Task Planning	Decomposes complex tasks and executes them step by step, looping over tools until the goal is reached
🧠 Long-term Memory	Three-tier architecture (context → daily → core), automatic Deep Dream distillation, hybrid keyword + vector retrieval
📚 Personal Knowledge Base	Auto-curates structured knowledge into a Markdown wiki, builds an evolving knowledge graph with visual browsing
🧩 Skills System	One-click install from Skill Hub, GitHub, ClawHub; or create custom skills via natural-language conversation
🔧 Tool System	Built-in file I/O, terminal, browser, scheduler, memory retrieval, web search, and 10+ more tools — with native MCP integration
💬 Multi-channel Integration	A single Agent simultaneously serves Web, WeChat, Feishu, DingTalk, WeCom, QQ, and Official Accounts
🎨 Multimodal Messaging	First-class support for text, images, voice, and files — recognition, generation, and delivery
⚙️ Pluggable Models	Claude, GPT, Gemini, DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao, and more — swap providers from the Web console with one click
📦 Batteries Included	One-line installer, 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 decides using memory, knowledge, and the available tools/skills; Models generate the response; results are sent back through the originating channel. Every layer is decoupled and independently extensible.

Read more in Architecture.

🚀 Quick Start

The project ships with a one-line installer that handles dependencies, configuration, and startup automatically:

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

Once started, open http://localhost:9899 to access the Web console — a single place to configure models, connect channels, and install skills.

📖 Detailed guides: One-line Installer · Manual Install from Source · Upgrade

After installation, manage the service with the 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

🤖 Models

CowAgent supports all mainstream LLM providers. Chat, vision, image generation, ASR/TTS, and embeddings can each be configured against a different vendor.

Provider	Featured Models	Chat	Vision	Image Gen	ASR	TTS	Embedding
Claude	claude-opus-4-7	✅	✅
OpenAI	gpt-5.5, o-series	✅	✅	✅	✅	✅	✅
Gemini	gemini-3.5-flash	✅	✅	✅
DeepSeek	deepseek-v4-flash / pro	✅
Qwen	qwen3.7-max	✅	✅	✅	✅	✅	✅
GLM	glm-5.1, glm-5v-turbo	✅	✅		✅		✅
Doubao	doubao-seed-2.0 series	✅	✅	✅			✅
Kimi	kimi-k2.6	✅	✅
MiniMax	MiniMax-M2.7	✅	✅	✅		✅
Qianfan	ernie-5.1	✅	✅
LinkAI	100+ models, unified gateway	✅	✅	✅	✅	✅	✅
Custom	Local models / third-party proxy	✅

The Web console is the recommended way to configure providers — no manual file editing required. For manual setup, see each provider's docs and the Models overview.

💬 Channels

A single Agent instance can serve multiple channels at once. Switch with the channel_type config or run several channels in parallel.

Channel	Text	Image	File	Voice	Group
Web Console (default)	✅	✅	✅	✅
WeChat	✅	✅	✅	✅
Feishu / Lark	✅	✅	✅	✅	✅
DingTalk	✅	✅	✅	✅	✅
WeCom Bot	✅	✅	✅	✅	✅
QQ	✅	✅	✅		✅
WeCom App	✅	✅	✅	✅
WeChat Official Account	✅	✅		✅

Feishu and WeCom Bot can be onboarded by scanning a QR code right inside the Web console — no public IP required. See the Channels overview.

The Web console doubles as the default channel and the unified place to configure and manage your Agent.

🧠 Memory & Knowledge Base

Long-term memory uses a three-tier architecture: conversation context (short-term) → daily memory (mid-term) → MEMORY.md (long-term). A nightly Deep Dream pass distills scattered memories into refined long-term entries and a narrative journal. See Long-term Memory · Deep Dream.

Personal knowledge base complements the time-ordered memory by organizing structured knowledge by topic. The Agent automatically curates valuable information from conversations, maintains cross-references and indexes, and the Web console offers an interactive knowledge-graph view. See Personal Knowledge Base.

Long-term Memory · Three-tier architecture + Deep Dream

Knowledge Base · Auto-curated Markdown wiki

🔧 Tools & Skills

Tools are atomic capabilities the Agent uses to interact with system resources. Skills are higher-level workflows defined by a manifest file that compose multiple tools to accomplish complex tasks.

Tool System

Built-in tools cover file I/O (read / write / edit / ls), terminal (bash), file delivery (send), memory retrieval (memory), environment variables (env_config), web fetching (web_fetch), scheduling (scheduler), web search (web_search), vision (vision), and browser automation (browser).

MCP protocol integrates the open ecosystem of Model Context Protocol servers. A single mcp.json is enough — supports stdio / SSE transports, hot reload, and zero-code integration.

Learn more: Tools overview · MCP integration.

Skills System

• Skill Hub — open skill marketplace: browse, search, install in one click
• GitHub / ClawHub — multiple skill sources, 40,000+ skills available
• Conversational authoring — generate custom skills through dialogue with skill-creator; turn any workflow or third-party API into a reusable skill

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

Learn more: Skills overview · Creating Skills.

🏷 Changelog

2026.05.22: v2.0.9 — Model management, MCP protocol support, persistent browser sessions, new models (gpt-5.5, gemini-3.5-flash, qwen3.7-max), deployment hardening.

2026.05.06: v2.0.8 — Feishu channel overhaul (voice, streaming, QR onboarding), DeepSeek V4 and Baidu Qianfan support, scheduler tool upgrades.

2026.04.22: v2.0.7 — Built-in image generation (GPT Image 2, Nano Banana), new models (Kimi K2.6, Claude Opus 4.7, GLM 5.1), memory and knowledge enhancements.

2026.04.14: v2.0.6 — Knowledge base, Deep Dream memory distillation, smart context compression, multi-session Web console.

2026.04.01: v2.0.5 — Cow CLI, Skill Hub open source, browser tool, WeCom Bot QR onboarding.

2026.02.03: v2.0.0 — Major upgrade to a super Agent assistant with multi-step task planning, long-term memory, and the Skills framework.

Full history: Release Notes

🤝 Community & Support

• 🐛 File an Issue · 💬 GitHub Discussions · 📖 FAQs

Scan the WeChat QR code to join the open-source community group:

🔗 Related Projects

• Cow Skill Hub — open skill marketplace for AI Agents; works with CowAgent, OpenClaw, Claude Code, and more
• bot-on-anything — lightweight LLM application framework with integrations for Slack, Telegram, Discord, Gmail, and more
• AgentMesh — open-source multi-agent framework for solving complex problems through team collaboration

🛠️ Development & Contributing

Contributions are welcome — add a new channel by following the Feishu channel reference, or contribute new skills to Skill Hub.

⭐ Star the project to follow updates, and feel free to open PRs and Issues.

🌟 Contributors

🏢 Enterprise Services

LinkAI is a one-stop AI Agent platform for enterprises and developers, offering managed hosting and enterprise-grade support for CowAgent:

• 🚀 Zero-deployment hosted runtime — spin up a CowAgent online assistant in under a minute, no server required
• 🧠 Aggregated models & skill marketplace — unified access to mainstream LLMs and an official skill marketplace, extending CowAgent's reach
• 🏢 Team & enterprise features — workspaces, role-based access, audit logs, and private deployment for production use cases

For enterprise inquiries: sales@simple-future.tech or scan the QR code to reach our team on WeChat.

⚠️ Disclaimer

1. This project is licensed under the MIT License and is intended for technical research and learning. You are responsible for complying with applicable laws and regulations in your jurisdiction; the maintainers assume no liability for any consequences arising from use of this project.
2. Cost & safety: Agent mode consumes substantially more tokens than plain chat — pick models that balance quality and cost. The Agent has access to your local operating system; deploy only in trusted environments.
3. CowAgent is a pure open-source project and does not participate in, authorize, or issue any cryptocurrency.

📌 Project Renaming Notice

This project was previously named chatgpt-on-wechat and is now officially CowAgent. The old GitHub URL redirects automatically; existing users may optionally run git remote set-url origin https://github.com/zhayujie/CowAgent.git to update the local remote.