README

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


CowAgent is an open-source super AI assistant that proactively plans tasks, controls your computer and external services, creates and runs Skills, builds a personal knowledge base and long-term memory, forms multi-agent teams, and grows alongside you through self-evolution — a reference implementation of Agent Harness engineering.

CowAgent is lightweight, easy to deploy, and built to extend. Plug in any major LLM provider and run it 24/7 on a personal computer or server, across 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, 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 gu