CowAgent

CowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任

📊 项目概览 tool

43648
⭐ Stars
9977
🔱 Forks
7
🎯 推荐指数
04/23
📅 采集日期
CowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任
🟡 展示页模式（无Web UI）

🏗️ 技术架构

架构图

🧠 思维导图

mindmap root((CowAgent)) 核心功能 CowAgent chatgpt-o.. 能主动思考和任 技术栈 未分类 应用场景 未分类 架构特点 未分类 生态 开源社区 插件扩展 持续更新

📱 小红书卡片

小红书卡片

💡 应用场景

🚀 快速启动

git clone https://github.com/zhayujie/CowAgent.git cd CowAgent pip install -r requirements.txt python main.py
📂 GitHub 仓库 →

📖 项目文档

README.md 查看完整文档 →

<p align="center"><img src= "https://github.com/user-attachments/assets/eca9a9ec-8534-4615-9e0f-96c5ac1d10a3" alt="CowAgent" width="550" /></p>

<p align="center">

<a href="https://github.com/zhayujie/CowAgent/releases/latest"><img src="https://img.shields.io/github/v/release/zhayujie/CowAgent" alt="Latest release"></a>

<a href="https://github.com/zhayujie/CowAgent/blob/master/LICENSE"><img src="https://img.shields.io/github/license/zhayujie/CowAgent" alt="License: MIT"></a>

<a href="https://github.com/zhayujie/CowAgent"><img src="https://img.shields.io/github/stars/zhayujie/CowAgent?style=flat-square" alt="Stars"></a> <br/>

[中文] | [<a href="docs/en/README.md">English</a>] | [<a href="docs/ja/README.md">日本語</a>]

</p>

CowAgent 是基于大模型的超级 AI 助理，能够主动思考和任务规划、操作计算机和外部资源、创造和执行 Skills、拥有长期记忆和知识库并不断成长，比 OpenClaw 更轻量和便捷。CowAgent 支持灵活切换多种模型，能处理文本、语音、图片、文件等多模态消息，可接入微信、飞书、钉钉、企微智能机器人、QQ、企微自建应用、微信公众号、网页中使用，7*24小时运行于你的个人电脑或服务器中。

<p align="center">

<a href="https://cowagent.ai/">🌐 官网</a> &nbsp;·&nbsp;

<a href="https://docs.cowagent.ai/">📖 文档中心</a> &nbsp;·&nbsp;

<a href="https://docs.cowagent.ai/guide/quick-start">🚀 快速开始</a> &nbsp;·&nbsp;

<a href="https://skills.cowagent.ai/">🧩 技能广场</a> &nbsp;·&nbsp;

<a href="https://link-ai.tech/cowagent/create">☁️ 在线体验</a>

</p>

简介

> 该项目既是一个可以开箱即用的超级 AI 助理，也是一个支持高扩展的 Agent 框架，可以通过为项目扩展大模型接口、接入渠道、内置工具、Skills 系统来灵活实现各种定制需求。核心能力如下：

  • ✅ **自主任务规划**：能够理解复杂任务并自主规划执行，持续思考和调用工具直到完成目标
  • ✅ **长期记忆：** 自动将对话记忆持久化至本地文件和数据库中，包括核心记忆、日级记忆和梦境蒸馏，支持关键词及向量检索
  • ✅ **个人知识库：** 自动整理结构化知识，通过交叉引用构建知识图谱，支持通过对话管理和可视化浏览知识库
  • ✅ **技能系统：** Skills 安装和运行的引擎，支持从 [Skill Hub](https://skills.cowagent.ai/)、GitHub 等一键安装技能，或通过对话创造 Skills
  • ✅ **工具系统：** 内置文件读写、终端执行、浏览器操作、定时任务等工具，Agent 自主调用以完成复杂任务
  • ✅ **CLI系统：** 提供终端命令和对话命令，支持进程管理、技能安装、配置修改等操作
  • ✅ **多模态消息：** 支持对文本、图片、语音、文件等多类型消息进行解析、处理、生成、发送等操作
  • ✅ **多模型支持：** 支持 OpenAI, Claude, Gemini, DeepSeek, MiniMax、GLM、Qwen、Kimi、Doubao 等国内外主流模型厂商
  • ✅ **多通道接入：** 支持运行在本地计算机或服务器，可集成到微信、飞书、钉钉、企业微信、QQ、微信公众号、网页中使用

声明

  1. 本项目遵循 [MIT 开源协议](/LICENSE)，主要用于技术研究和学习，使用本项目时需遵守所在地法律法规、相关政策以及企业章程，禁止用于任何违法或侵犯他人权益的行为。任何个人、团队和企业，无论以何种方式使用该项目、对何对象提供服务，所产生的一切后果，本项目均不承担任何责任。
  2. 成本与安全：Agent 模式下 Token 使用量高于普通对话模式，请根据效果及成本综合选择模型。Agent 具有访问所在操作系统的能力，请谨慎选择项目部署环境。同时项目也会持续升级安全机制、并降低模型消耗成本。
  3. CowAgent 项目专注于开源技术开发，不会参与、授权或发行任何加密货币。

    4. 演示

    • 使用说明( Agent 模式)：[CowAgent 介绍](https://docs.cowagent.ai/intro/features)
    • 免部署在线体验：[CowAgent](https://link-ai.tech/cowagent/create)
    • DEMO 视频(对话模式)：https://cdn.link-ai.tech/doc/cow_demo.mp4

    社区

    添加小助手微信加入开源项目交流群：

    <img width="140" src="https://img-1317903499.cos.ap-guangzhou.myqcloud.com/docs/open-community.png">

    <br/>

    企业服务

    <a href="https://link-ai.tech" target="_blank"><img width="650" src="https://cdn.link-ai.tech/image/link-ai-intro.jpg"></a>

    > LinkAI 是面向企业和个人的一站式 AI 智能体平台，聚合多模态大模型、知识库、技能、工作流等能力，支持一键接入主流平台并管理，支持 SaaS、私有化部署等多种模式，可免部署在线运行CowAgent 助理。

    >

    > LinkAI 目前已在智能客服、私域运营、企业效率助手等场景积累了丰富的 AI 解决方案，在消费、健康、文教、科技制造等各行业沉淀了大模型落地应用的最佳实践，致力于帮助更多企业和开发者拥抱 AI 生产力。

    产品咨询和企业服务 可联系产品客服：

    <img width="150" src="https://cdn.link-ai.tech/portal/linkai-customer-service.png">

    <br/>

    🏷 更新日志

    >2026.04.14： 2.0.6版本，知识库系统、梦境记忆模块、上下文智能压缩、Web 控制台多会话及多项优化。

    >2026.04.01： 2.0.5版本，Cow CLI 命令系统、Skill Hub 开源、浏览器工具、企微扫码创建、多项优化和修复。

    >2026.03.22： 2.0.4版本，新增个人微信通道（微信扫码即用）、新增 MiniMax-M2.7 和 GLM-5-Turbo 模型、run.sh 脚本重构、日文文档及多项修复。

    >2026.03.18： 2.0.3版本，新增企微智能机器人和 QQ 通道、支持 Coding Plan、新增多个模型、Web 端文件处理、记忆系统升级。

    >2026.02.27： 2.0.2版本，Web 控制台全面升级（流式对话、模型/技能/记忆/通道/定时任务/日志管理）、支持多通道同时运行、会话持久化存储、新增多个模型。

    >2026.02.13： 2.0.1版本，内置 Web Search 工具、智能上下文裁剪策略、运行时信息动态更新、Windows 兼容性适配，修复定时任务记忆丢失、飞书连接等多项问题。

    >2026.02.03： 2.0.0版本，正式升级为超级 Agent 助理，支持多轮任务决策、具备长期记忆、实现多种系统工具、支持 Skills 框架，新增多种模型并优化了接入渠道。

    更多更新历史请查看: 更新日志

    <br/>

    🚀 快速开始

    项目提供了一键安装、配置、启动、管理程序的脚本，推荐使用脚本快速运行，也可以根据下文中的详细指引一步步安装运行。

    在终端执行以下命令：

    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

    脚本使用说明：一键运行脚本。安装后可使用 cow start、cow stop 等 CLI 命令 管理服务。

    一、准备

    1. 模型API

    项目支持国内外主流厂商的模型接口，可选模型及配置说明参考：模型说明。

    > 注：Agent 模式下推荐使用以下模型，可根据效果及成本综合选择：MiniMax-M2.7、glm-5-turbo、kimi-k2.6、qwen3.5-plus、claude-sonnet-4-6、gemini-3.1-pro-preview、gpt-5.4、gpt-5.4-mini

    同时支持使用 LinkAI 平台 接口，支持上述全部模型，并支持知识库、工作流、插件等 Agent 技能，参考 接口文档。

    2.环境安装

    支持 Linux、MacOS、Windows 操作系统，可在个人计算机及服务器上运行，需安装 Python，Python 版本需在 3.7 ~ 3.13 之间。

    > 注意：Agent 模式推荐使用源码运行，若选择 Docker 部署则无需安装 python 环境和下载源码，可直接快进到下一节。

    (1) 克隆项目代码：

    
git clone https://github.com/zhayujie/CowAgent
cd CowAgent/

    若遇到网络问题可使用国内仓库地址：https://gitee.com/zhayujie/CowAgent

    (2) 安装核心依赖 (必选)：

    
pip3 install -r requirements.txt

    (3) 拓展依赖 (可选，建议安装)：

    
pip3 install -r requirements-optional.txt

    > 国内网络可使用镜像源加速：pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

    如果某项依赖安装失败可注释掉对应的行后重试。

    (4) 安装 Cow CLI (推荐)：

    
pip3 install -e .

    安装后可使用 cow 命令管理服务（启动、停止、更新等）和技能，详见 命令文档。

    (5) 安装浏览器工具 (可选)：

    如果需要 Agent 操作浏览器（如访问网页、填写表单等），需要额外安装浏览器依赖：

    
cow install-browser

    该命令会自动安装 playwright 和 Chromium 浏览器，国内网络自动使用镜像加速。详见 浏览器工具文档。

    二、配置

    配置文件的模板在根目录的 config-template.json 中，需复制该模板创建最终生效的 config.json 文件：

    
  cp config-template.json config.json

    然后在 config.json 中填入配置，以下是对默认配置的说明，可根据需要进行自定义修改（注意实际使用时请去掉注释，保证 JSON 格式的规范）：

    
# config.json 文件内容示例
{
  "channel_type": "weixin",                                   # 接入渠道类型，默认为 weixin, 支持修改为 feishu,dingtalk,wecom_bot,qq,wechatcom_app,wechatmp_service,wechatmp,terminal
  "model": "MiniMax-M2.7",                                    # 模型名称
  "minimax_api_key": "",                                      # MiniMax API Key
  "zhipu_ai_api_key": "",                                     # 智谱 GLM API Key
  "moonshot_api_key": "",                                     # Kimi/Moonshot API Key
  "ark_api_key": "",                                          # 豆包(火山方舟) API Key
  "dashscope_api_key": "",                                    # 百炼(通义千问) API Key
  "claude_api_key": "",                                       # Claude API Key
  "claude_api_base": "https://api.anthropic.com/v1",          # Claude API 地址，修改可接入三方代理平台
  "gemini_api_key": "",                                       # Gemini API Key
  "gemini_api_base": "https://generativelanguage.googleapis.com", # Gemini API 地址
  "deepseek_api_key": "",                                      # DeepSeek API Key
  "deepseek_api_base": "https://api.deepseek.com/v1",         # DeepSeek API 地址，可修改为第三方代理
  "open_ai_api_key": "",                                      # OpenAI API Key
  "open_ai_api_base": "https://api.openai.com/v1",            # OpenAI API 地址
  "linkai_api_key": "",                                       # LinkAI API Key
  "proxy": "",                                                # 代理客户端的 ip 和端口，国内环境需要开启代理的可填写该项，如 "127.0.0.1:7890"
  "speech_recognition": false,                                # 是否开启语音识别
  "group_speech_recognition": false,                          # 是否开启群组语音识别
  "voice_reply_voice": false,                                 # 是否使用语音回复语音
  "use_linkai": false,                                        # 是否使用 LinkAI 接口，默认关闭，设置为 true 后可对接 LinkAI 平台模型
  "web_password": "",                                         # Web 控制台访问密码，留空则不启用密码保护
  "agent": true,                                              # 是否启用 Agent 模式，启用后拥有多轮工具决策、长期记忆、Skills 能力等
  "agent_workspace": "~/cow",                                 # Agent 的工作空间路径，用于存储 memory、skills、系统设定等
  "agent_max_context_tokens": 50000,                          # Agent 模式下最大上下文 tokens，超出将自动智能压缩处理
  "agent_max_context_turns": 20,                              # Agent 模式下最大上下文记忆轮次，一问一答为一轮，超出后智能压缩处理
  "agent_max_steps": 20,                                      # Agent 模式下单次任务的最大决策步数，超出后将停止继续调用工具
  "enable_thinking": false                                    # 是否启用深度思考，开启后 Web 端展示模型推理过程，关闭后可加速响应
}

    配置补充说明:

    <details>

    <summary>1. 语音配置</summary>

    + 添加 "speech_recognition": true 将开启语音识别，默认使用 openai 的 whisper 模型识别为文字，同时以文字回复，该参数仅支持私聊 (注意由于语音消息无法匹配前缀，一旦开启将对所有语音自动回复，支持语音触发画图)；

    + 添加 "group_speech_recognition": true 将开启群组语音识别，默认使用 openai 的 whisper 模型识别为文字，同时以文字回复，参数仅支持群聊 (会匹配 group_chat_prefix 和 group_chat_keyword, 支持语音触发画图)；

    + 添加 "voice_reply_voice": true 将开启语音回复语音（同时作用于私聊和群聊）

    + 使用 MiniMax TTS：设置 "text_to_voice": "minimax"，并配置 minimax_api_key；可通过 "tts_voice_id" 指定发音人（如 English_Graceful_Lady），"text_to_voice_model" 指定模型（如 speech-2.8-hd、speech-2.8-turbo）

    </details>

    <details>

    <summary>2. 其他配置</summary>

    + model: 模型名称，Agent 模式下推荐使用 MiniMax-M2.7、glm-5-turbo、kimi-k2.6、qwen3.6-plus、claude-sonnet-4-6、gemini-3.1-pro-preview，全部模型名称参考common/const.py文件

    + character_desc：普通对话模式下的机器人系统提示词。在 Agent 模式下该配置不生效，由工作空间中的文件内容构成。

    + subscribe_msg：订阅消息，公众号和企业微信 channel 中请填写，当被订阅时会自动回复， 可使用特殊占位符。目前支持的占位符有{trigger_prefix}，在程序中它会自动替换成 bot 的触发词。

    </details>

    <details>

    <summary>3. LinkAI 配置</summary>

    + use_linkai: 是否使用 LinkAI 接口，默认关闭，设置为 true 后可对接 LinkAI 平台，使用模型、知识库、工作流、插件等技能, 参考接口文档

    + linkai_api_key: LinkAI Api Key，可在 控制台 创建

    </details>

    注：全部配置项说明可在 config.py 文件中查看。

    三、运行

    1.本地运行

    如果是个人计算机 本地运行，直接在项目根目录下执行：

    
cow start              # 推荐，需先安装 Cow CLI
python3 app.py         # 或直接运行，windows 环境下该命令通常为 python app.py

    运行后默认会启动 web 服务，可通过访问 http://localhost:9899/chat 在网页端对话。

    如果需要接入其他应用通道只需修改 config.json 配置文件中的 channel_type 参数，详情参考：通道说明。

    2.服务器部署

    推荐使用 cow 命令管理服务：

    
cow start              # 后台启动
cow stop               # 停止服务
cow restart            # 重启服务
cow status             # 查看运行状态
cow logs               # 查看日志
cow update             # 拉取最新代码并重启

    也可以使用传统方式后台运行：

    
nohup python3 app.py & tail -f nohup.out

    此外，项目根目录下的 run.sh 脚本也支持一键管理服务，包括 ./run.sh start、./run.sh stop、./run.sh restart 等命令，执行 ./run.sh help 可查看全部用法。

    > 如果需要通过浏览器访问 Web 控制台，请确保服务器的 9899 端口已在防火墙或安全组中放行，建议仅对指定 IP 开放以保证安全。

    3.Docker部署

    使用 docker 部署无需下载源码和安装依赖，只需要获取 docker-compose.yml 配置文件并启动容器即可。Agent 模式下更推荐使用源码进行部署，以获得更多系统访问能力。

    > 前提是需要安装好 docker 及 docker-compose，安装成功后执行 docker -v 和 docker-compose version (或 docker compose version) 可查看到版本号。安装地址为 docker官网 。

    (1) 下载 docker-compose.yml 文件

    ... 文档较长，请查看完整版 →

🤖 Powered by Hermes GitHub Trending Agent | 每日 AI/LLM 精选