From 0a146a245dcf0c3d350da8e37a6f2e41f21bc1b8 Mon Sep 17 00:00:00 2001 From: zhayujie Date: Sun, 24 May 2026 17:52:47 +0800 Subject: [PATCH] docs: refactor README --- README.md | 1048 ++++++-------------------------- docs/en/README.md | 250 -------- docs/en/intro/architecture.mdx | 2 +- docs/intro/architecture.mdx | 2 +- docs/ja/README.md | 352 +++++------ docs/ja/intro/architecture.mdx | 2 +- docs/zh/README.md | 262 ++++++++ 7 files changed, 634 insertions(+), 1284 deletions(-) delete mode 100644 docs/en/README.md create mode 100644 docs/zh/README.md diff --git a/README.md b/README.md index aeb0f560..d5e275b9 100644 --- a/README.md +++ b/README.md @@ -1,920 +1,254 @@ -

CowAgent

+

CowAgent

Latest release License: MIT Stars
- [中文] | [English] | [日本語] + [English] | [中文] | [日本語]

-**CowAgent** 是基于大模型的超级 AI 助理，能够主动思考和任务规划、操作计算机和外部资源、创造和执行 Skills、拥有长期记忆和知识库并不断成长，比 OpenClaw 更轻量和便捷。CowAgent 支持灵活切换多种模型，能处理文本、语音、图片、文件等多模态消息，可接入微信、飞书、钉钉、企微智能机器人、QQ、企微自建应用、微信公众号、网页中使用，7*24小时运行于你的个人电脑或服务器中。 +**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. Switch freely between leading models such as Claude, GPT, Gemini, DeepSeek, Qwen, GLM, Kimi, MiniMax, and Doubao, and connect to WeChat, Feishu (Lark), DingTalk, WeCom, QQ, the Web, or your terminal — running 24/7 on a personal computer or server.

- 🌐 官网  ·  - 📖 文档中心  ·  - 🚀 快速开始  ·  - 🧩 技能广场  ·  - ☁️ 在线体验 + 🌐 Website  ·  + 📖 Docs  ·  + 🚀 Quick Start  ·  + 🧩 Skill Hub  ·  + ☁️ Try Online

+
-# 简介 +## 🌟 Highlights -> 该项目既是一个可以开箱即用的超级 AI 助理，也是一个支持高扩展的 Agent 框架，可以通过为项目扩展大模型接口、接入渠道、内置工具、Skills 系统来灵活实现各种定制需求。核心能力如下： - -- ✅ **自主任务规划**：能够理解复杂任务并自主规划执行，持续思考和调用工具直到完成目标 -- ✅ **长期记忆：** 自动将对话记忆持久化至本地文件和数据库中，包括核心记忆、日级记忆和梦境蒸馏，支持关键词及向量检索 -- ✅ **个人知识库：** 自动整理结构化知识，通过交叉引用构建知识图谱，支持通过对话管理和可视化浏览知识库 -- ✅ **技能系统：** Skills 安装和运行的引擎，支持从 [Skill Hub](https://skills.cowagent.ai/)、GitHub 等一键安装技能，或通过对话创造 Skills -- ✅ **工具系统：** 内置文件读写、终端执行、浏览器操作、定时任务等工具，支持 MCP 协议，通过 Agent 自主调用完成复杂任务 -- ✅ **CLI系统：** 提供终端命令和对话命令，支持进程管理、技能安装、配置修改等操作 -- ✅ **多模态消息：** 支持对文本、图片、语音、文件等多类型消息进行解析、处理、生成、发送等操作 -- ✅ **多模型支持：** 支持 DeepSeek、MiniMax、Claude、Gemini、OpenAI、GLM、Qwen、Doubao、Kimi 等国内外主流模型厂商 -- ✅ **多通道接入：** 支持运行在本地计算机或服务器，可集成到微信、飞书、钉钉、企业微信、QQ、微信公众号、网页中使用 - -## 声明 - -1. 本项目遵循 [MIT 开源协议](/LICENSE)，主要用于技术研究和学习，使用本项目时需遵守所在地法律法规、相关政策以及企业章程，禁止用于任何违法或侵犯他人权益的行为。任何个人、团队和企业，无论以何种方式使用该项目、对何对象提供服务，所产生的一切后果，本项目均不承担任何责任。 -2. 成本与安全：Agent 模式下 Token 使用量高于普通对话模式，请根据效果及成本综合选择模型。Agent 具有访问所在操作系统的能力，请谨慎选择项目部署环境。同时项目也会持续升级安全机制、并降低模型消耗成本。 -3. CowAgent 项目专注于开源技术开发，不会参与、授权或发行任何加密货币。 - -## 演示 - -- 使用说明( 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 - -## 社区 - -添加小助手微信加入开源项目交流群： - - +| Capability | Description | +| :--- | :--- | +| 🤖 [Autonomous Task Planning](https://docs.cowagent.ai/en/intro/architecture) | Decomposes complex tasks and executes them step by step, looping over tools until the goal is reached | +| 🧠 [Long-term Memory](https://docs.cowagent.ai/en/memory/index) | Three-tier architecture (context → daily → core), automatic Deep Dream distillation, hybrid keyword + vector retrieval | +| 📚 [Personal Knowledge Base](https://docs.cowagent.ai/en/knowledge/index) | Auto-curates structured knowledge into a Markdown wiki, builds an evolving knowledge graph with visual browsing | +| 🧩 [Skills System](https://docs.cowagent.ai/en/skills/index) | One-click install from [Skill Hub](https://skills.cowagent.ai/), GitHub, ClawHub; or create custom skills via natural-language conversation | +| 🔧 [Tool System](https://docs.cowagent.ai/en/tools/index) | Built-in file I/O, terminal, browser, scheduler, memory retrieval, web search, and 10+ more tools — with native MCP integration | +| 💬 [Multi-channel Integration](https://docs.cowagent.ai/en/channels/index) | 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](https://docs.cowagent.ai/en/models/index) | Claude, GPT, Gemini, DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao, and more — swap providers from the Web console with one click | +| 📦 [Batteries Included](https://docs.cowagent.ai/en/guide/quick-start) | One-line installer, unified Web console, multiple deployment modes (local, Docker, server) |
-# 企业服务 +## 🏗️ Architecture - +CowAgent Architecture -> [LinkAI](https://link-ai.tech/) 是面向企业和个人的一站式 AI 智能体平台，聚合多模态大模型、知识库、技能、工作流等能力，支持一键接入主流平台并管理，支持 SaaS、私有化部署等多种模式，可免部署在线运行[CowAgent 助理](https://link-ai.tech/cowagent/create)。 -> -> LinkAI 目前已在智能客服、私域运营、企业效率助手等场景积累了丰富的 AI 解决方案，在消费、健康、文教、科技制造等各行业沉淀了大模型落地应用的最佳实践，致力于帮助更多企业和开发者拥抱 AI 生产力。 +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](https://docs.cowagent.ai/en/intro/architecture).
-# 🏷 更新日志 +## 🚀 Quick Start ->**2026.05.22：** [2.0.9版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.9)，新增模型管理、MCP 协议支持、浏览器登录态持久化、新模型接入（gpt-5.5、gemini-3.5-flash、qwen3.7-max 等）、部署安全加固 +The project ships with a one-line installer that handles dependencies, configuration, and startup automatically: ->**2026.05.06：** [2.0.8版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.8)，飞书渠道全面升级（语音、流式输出和Markdown、一键扫码接入）、新模型支持（DeepSeek V4、百度千帆）、定时任务工具增强等 +**Linux / macOS:** ->**2026.04.22：** [2.0.7版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.7)，图像生成内置技能（GPT Image 2、Nano Banana 等）、新模型支持（Kimi K2.6、Claude Opus 4.7、GLM 5.1）、知识库和记忆增强、Web 控制台优化 - ->**2026.04.14：** [2.0.6版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.6)，知识库系统、梦境记忆模块、上下文智能压缩、Web 控制台多会话及多项优化。 - ->**2026.04.01：** [2.0.5版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.5)，Cow CLI 命令系统、Skill Hub 开源、浏览器工具、企微扫码创建、多项优化和修复。 - ->**2026.03.22：** [2.0.4版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.4)，新增个人微信通道（微信扫码即用）、新增 MiniMax-M2.7 和 GLM-5-Turbo 模型、run.sh 脚本重构、日文文档及多项修复。 - ->**2026.03.18：** [2.0.3版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.3)，新增企微智能机器人和 QQ 通道、支持 Coding Plan、新增多个模型、Web 端文件处理、记忆系统升级。 - ->**2026.02.27：** [2.0.2版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.2)，Web 控制台全面升级（流式对话、模型/技能/记忆/通道/定时任务/日志管理）、支持多通道同时运行、会话持久化存储、新增多个模型。 - ->**2026.02.13：** [2.0.1版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.1)，内置 Web Search 工具、智能上下文裁剪策略、运行时信息动态更新、Windows 兼容性适配，修复定时任务记忆丢失、飞书连接等多项问题。 - ->**2026.02.03：** [2.0.0版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.0)，正式升级为超级 Agent 助理，支持多轮任务决策、具备长期记忆、实现多种系统工具、支持 Skills 框架，新增多种模型并优化了接入渠道。 - -更多更新历史请查看: [更新日志](https://docs.cowagent.ai/releases) - -
- -# 🚀 快速开始 - -项目提供了一键安装、配置、启动、管理程序的脚本，推荐使用脚本快速运行，也可以根据下文中的详细指引一步步安装运行。 - -在终端执行以下命令： - -**Linux / macOS：** ```bash bash <(curl -fsSL https://cdn.link-ai.tech/code/cow/run.sh) ``` -**Windows（PowerShell）：** +**Windows (PowerShell):** + ```powershell irm https://cdn.link-ai.tech/code/cow/run.ps1 | iex ``` -脚本使用说明：[一键运行脚本](https://docs.cowagent.ai/guide/quick-start)。安装后可使用 `cow start`、`cow stop` 等 [CLI 命令](https://docs.cowagent.ai/cli/index) 管理服务。 - - -## 一、准备 - -### 1. 模型API - -项目支持国内外主流厂商的模型接口，可选模型及配置说明参考：[模型说明](#模型说明)。 - -> 注：Agent 模式下推荐使用以下模型，可根据效果及成本综合选择：deepseek-v4-flash / pro、MiniMax-M2.7、glm-5.1、kimi-k2.6、qwen3.5-plus、claude-sonnet-4-6、gemini-3.5-flash、gpt-5.5、ernie-5.1 等 - -同时支持使用 **LinkAI 平台** 接口，支持上述全部模型，并支持知识库、工作流、插件等 Agent 技能，参考 [接口文档](https://docs.link-ai.tech/platform/api)。 - -### 2.环境安装 - -支持 Linux、MacOS、Windows 操作系统，可在个人计算机及服务器上运行，需安装 `Python`，Python 版本需在 3.7 ~ 3.13 之间。 - -> 注意：Agent 模式推荐使用源码运行，若选择 Docker 部署则无需安装 python 环境和下载源码，可直接快进到下一节。 - -**(1) 克隆项目代码：** - -```bash -git clone https://github.com/zhayujie/CowAgent -cd CowAgent/ -``` - -若遇到网络问题可使用国内仓库地址：https://gitee.com/zhayujie/CowAgent - -**(2) 安装核心依赖 (必选)：** - -```bash -pip3 install -r requirements.txt -``` - -**(3) 拓展依赖 (可选，建议安装)：** - -```bash -pip3 install -r requirements-optional.txt -``` - -> 国内网络可使用镜像源加速：`pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple` - -如果某项依赖安装失败可注释掉对应的行后重试。 - -**(4) 安装 Cow CLI (推荐)：** - -```bash -pip3 install -e . -``` - -安装后可使用 `cow` 命令管理服务（启动、停止、更新等）和技能，详见 [命令文档](https://docs.cowagent.ai/cli/index)。 - -**(5) 安装浏览器工具 (可选)：** - -如果需要 Agent 操作浏览器（如访问网页、填写表单等），需要额外安装浏览器依赖： - -```bash -cow install-browser -``` - -该命令会自动安装 `playwright` 和 Chromium 浏览器，国内网络自动使用镜像加速。详见 [浏览器工具文档](https://docs.cowagent.ai/tools/browser)。 - -## 二、配置 - -配置文件的模板在根目录的 `config-template.json` 中，需复制该模板创建最终生效的 `config.json` 文件： - -```bash - cp config-template.json config.json -``` - -然后在 `config.json` 中填入配置，以下是对默认配置的说明，可根据需要进行自定义修改（注意实际使用时请去掉注释，保证 JSON 格式的规范）： - -```bash -# config.json 文件内容示例 -{ - "channel_type": "weixin", # 接入渠道类型，默认为 weixin, 支持修改为 feishu,dingtalk,wecom_bot,qq,wechatcom_app,wechatmp_service,wechatmp,terminal - "model": "deepseek-v4-flash", # 模型名称 - "deepseek_api_key": "", # DeepSeek API Key - "deepseek_api_base": "https://api.deepseek.com/v1", # DeepSeek API 地址 - "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 地址 - "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 控制台访问密码，留空则不启用密码保护（监听 0.0.0.0 时务必设置） - "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 # 是否启用深度思考模式 -} -``` - -**配置补充说明:** - -
-1. 语音配置 - -+ 添加 `"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`） -
- -
-2. 其他配置 - -+ `model`: 模型名称，Agent 模式下推荐使用 `deepseek-v4-flash`、`MiniMax-M2.7`、`glm-5.1`、`kimi-k2.6`、`qwen3.6-plus`、`claude-sonnet-4-6`、`gemini-3.1-pro-preview`，全部模型名称参考[common/const.py](https://github.com/zhayujie/CowAgent/blob/master/common/const.py)文件 -+ `character_desc`：普通对话模式下的机器人系统提示词。在 Agent 模式下该配置不生效，由工作空间中的文件内容构成。 -+ `subscribe_msg`：订阅消息，公众号和企业微信 channel 中请填写，当被订阅时会自动回复， 可使用特殊占位符。目前支持的占位符有{trigger_prefix}，在程序中它会自动替换成 bot 的触发词。 -
- -
-3. LinkAI 配置 - -+ `use_linkai`: 是否使用 LinkAI 接口，默认关闭，设置为 true 后可对接 LinkAI 平台，使用模型、知识库、工作流、插件等技能, 参考[接口文档](https://docs.link-ai.tech/platform/api/chat) -+ `linkai_api_key`: LinkAI Api Key，可在 [控制台](https://link-ai.tech/console/interface) 创建 -
- -注：全部配置项说明可在 [`config.py`](https://github.com/zhayujie/CowAgent/blob/master/config.py) 文件中查看。 - -## 三、运行 - -### 1.本地运行 - -如果是个人计算机 **本地运行**，直接在项目根目录下执行： - -```bash -cow start # 推荐，需先安装 Cow CLI -python3 app.py # 或直接运行，windows 环境下该命令通常为 python app.py -``` - -运行后默认会启动 web 服务，可通过访问 `http://localhost:9899/chat` 在网页端对话。 - -如果需要接入其他应用通道只需修改 `config.json` 配置文件中的 `channel_type` 参数，详情参考：[通道说明](#通道说明)。 - - -### 2.服务器部署 - -推荐使用 `cow` 命令管理服务： - -```bash -cow start # 后台启动 -cow stop # 停止服务 -cow restart # 重启服务 -cow status # 查看运行状态 -cow logs # 查看日志 -cow update # 拉取最新代码并重启 -``` - -也可以使用传统方式后台运行： - -```bash -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官网](https://docs.docker.com/engine/install/) 。 - -**(1) 下载 docker-compose.yml 文件** +**Docker:** ```bash curl -O https://cdn.link-ai.tech/code/cow/docker-compose.yml +docker compose up -d ``` -下载完成后打开 `docker-compose.yml` 填写所需配置，例如 `CHANNEL_TYPE`、`OPEN_AI_API_KEY` 和等配置。 +Once started, open `http://localhost:9899` to access the **Web console** — a single place to configure models, connect channels, and install skills. -**(2) 启动容器** +> 📖 Detailed guides: [One-line Installer](https://docs.cowagent.ai/en/guide/quick-start) · [Manual Install from Source](https://docs.cowagent.ai/en/guide/manual-install) · [Upgrade](https://docs.cowagent.ai/en/guide/upgrade) -在 `docker-compose.yml` 所在目录下执行以下命令启动容器： +After installation, manage the service with the [`cow` CLI](https://docs.cowagent.ai/en/cli/index): ```bash -sudo docker compose up -d # 若docker-compose为 1.X 版本，则执行 `sudo docker-compose up -d` +cow start | stop | restart # service control +cow status | logs # status and logs +cow update # pull latest code and restart +cow skill install # install a skill +cow install-browser # install browser automation ``` -运行命令后，会自动取 [docker hub](https://hub.docker.com/r/zhayujie/chatgpt-on-wechat) 拉取最新 release 版本的镜像。当执行 `sudo docker ps` 能查看到 NAMES 为 chatgpt-on-wechat 的容器即表示运行成功。最后执行以下命令可查看容器的运行日志： - -```bash -sudo docker logs -f chatgpt-on-wechat -``` - -> 如果需要通过浏览器访问 Web 控制台，请确保服务器的 `9899` 端口已在防火墙或安全组中放行，建议仅对指定 IP 开放以保证安全。 - -## 模型说明 - -推荐通过 Web 控制台在线管理模型配置，无需手动编辑文件，详见 [模型文档](https://docs.cowagent.ai/models)。以下是手动修改 `config.json` 配置模型的说明： - -
-DeepSeek - -1. API Key 创建：在 [DeepSeek 平台](https://platform.deepseek.com/api_keys) 创建 API Key - -2. 填写配置 - -方式一：官方接入（推荐）： - -```json -{ - "model": "deepseek-v4-flash", - "deepseek_api_key": "sk-xxxxxxxxxxx" -} -``` - - - `model`: 推荐填写 `deepseek-v4-flash`、`deepseek-v4-pro` - - `deepseek_api_key`: DeepSeek 平台的 API Key - - `deepseek_api_base`: 可选，默认为 `https://api.deepseek.com/v1`，可修改为第三方代理地址 - -方式二：OpenAI 兼容方式接入： - -```json -{ - "model": "deepseek-v4-flash", - "bot_type": "openai", - "open_ai_api_key": "sk-xxxxxxxxxxx", - "open_ai_api_base": "https://api.deepseek.com/v1" -} -``` - -
- -
-MiniMax - -方式一：官方接入，配置如下(推荐)： - -```json -{ - "model": "MiniMax-M2.7", - "minimax_api_key": "" -} -``` - - `model`: 可填写 `MiniMax-M2.7、MiniMax-M2.7-highspeed、MiniMax-M2.5、MiniMax-M2.1、MiniMax-M2.1-lightning、MiniMax-M2、abab6.5-chat` 等 - - `minimax_api_key`：MiniMax 平台的 API-KEY，在 [控制台](https://platform.minimaxi.com/user-center/basic-information/interface-key) 创建 - -方式二：OpenAI 兼容方式接入，配置如下： -```json -{ - "bot_type": "openai", - "model": "MiniMax-M2.7", - "open_ai_api_base": "https://api.minimaxi.com/v1", - "open_ai_api_key": "" -} -``` -- `bot_type`: OpenAI 兼容方式 -- `model`: 可填 `MiniMax-M2.7、MiniMax-M2.7-highspeed、MiniMax-M2.5、MiniMax-M2.1、MiniMax-M2.1-lightning、MiniMax-M2`，参考[API文档](https://platform.minimaxi.com/document/%E5%AF%B9%E8%AF%9D?key=66701d281d57f38758d581d0#QklxsNSbaf6kM4j6wjO5eEek) -- `open_ai_api_base`: MiniMax 平台 API 的 BASE URL -- `open_ai_api_key`: MiniMax 平台的 API-KEY -
- -
-Claude - -1. API Key 创建：在 [Claude控制台](https://console.anthropic.com/settings/keys) 创建 API Key - -2. 填写配置 - -```json -{ - "model": "claude-sonnet-4-6", - "claude_api_key": "YOUR_API_KEY" -} -``` - - `model`: 参考 [官方模型ID](https://docs.anthropic.com/en/docs/about-claude/models/overview#model-aliases) ，支持 `claude-sonnet-4-6、claude-opus-4-7、claude-opus-4-6、claude-sonnet-4-5、claude-sonnet-4-0、claude-opus-4-0、claude-3-5-sonnet-latest` 等 -
- -
-Gemini - -API Key 创建：在 [控制台](https://aistudio.google.com/app/apikey?hl=zh-cn) 创建 API Key ，配置如下 -```json -{ - "model": "gemini-3.1-flash-lite-preview", - "gemini_api_key": "" -} -``` - - `model`: 参考[官方文档-模型列表](https://ai.google.dev/gemini-api/docs/models?hl=zh-cn)，支持 `gemini-3.1-flash-lite-preview、gemini-3.1-pro-preview、gemini-3-flash-preview、gemini-3-pro-preview` 等 -
- -
-OpenAI - -1. API Key 创建：在 [OpenAI平台](https://platform.openai.com/api-keys) 创建 API Key - -2. 填写配置 - -```json -{ - "model": "gpt-5.4", - "open_ai_api_key": "YOUR_API_KEY", - "open_ai_api_base": "https://api.openai.com/v1", - "bot_type": "openai" -} -``` - - - `model`: 与 OpenAI 接口的 [model参数](https://platform.openai.com/docs/models) 一致，支持包括 gpt-5.4、gpt-5.4-mini、gpt-5.4-nano、o 系列、gpt-4.1 等模型，Agent 模式推荐使用 `gpt-5.4`、`gpt-5.4-mini` - - `open_ai_api_base`: 如果需要接入第三方代理接口，可通过修改该参数进行接入 - - `bot_type`: 使用 OpenAI 相关模型时无需填写。当使用第三方代理接口接入 Claude 等非 OpenAI 官方模型时，该参数设为 `openai` -
- -
-智谱AI (GLM) - -方式一：官方接入，配置如下(推荐)： - -```json -{ - "model": "glm-5.1", - "zhipu_ai_api_key": "" -} -``` - - `model`: 可填 `glm-5.1、glm-5-turbo、glm-5、glm-4.7、glm-4-plus、glm-4-flash、glm-4-air、glm-4-airx、glm-4-long` 等, 参考 [glm 系列模型编码](https://bigmodel.cn/dev/api/normal-model/glm-4) - - `zhipu_ai_api_key`: 智谱AI 平台的 API KEY，在 [控制台](https://www.bigmodel.cn/usercenter/proj-mgmt/apikeys) 创建 - -方式二：OpenAI 兼容方式接入，配置如下： -```json -{ - "bot_type": "openai", - "model": "glm-5.1", - "open_ai_api_base": "https://open.bigmodel.cn/api/paas/v4", - "open_ai_api_key": "" -} -``` -- `bot_type`: OpenAI 兼容方式 -- `model`: 可填 `glm-5.1、glm-5-turbo、glm-5、glm-4.7、glm-4-plus、glm-4-flash、glm-4-air、glm-4-airx、glm-4-long` 等 -- `open_ai_api_base`: 智谱AI 平台的 BASE URL -- `open_ai_api_key`: 智谱AI 平台的 API KEY -
- -
-通义千问 (Qwen) - -方式一：官方 SDK 接入，配置如下(推荐)： - -```json -{ - "model": "qwen3.6-plus", - "dashscope_api_key": "sk-qVxxxxG" -} -``` - - `model`: 可填写 `qwen3.6-plus、qwen3.5-plus、qwen3-max、qwen-max、qwen-plus、qwen-turbo、qwen-long、qwq-plus` 等 - - `dashscope_api_key`: 通义千问的 API-KEY，参考 [官方文档](https://bailian.console.aliyun.com/?tab=api#/api) ，在 [百炼控制台](https://bailian.console.aliyun.com/?tab=model#/api-key) 创建 - -方式二：OpenAI 兼容方式接入，配置如下： -```json -{ - "bot_type": "openai", - "model": "qwen3.6-plus", - "open_ai_api_base": "https://dashscope.aliyuncs.com/compatible-mode/v1", - "open_ai_api_key": "sk-qVxxxxG" -} -``` -- `bot_type`: OpenAI 兼容方式 -- `model`: 支持官方所有模型，参考[模型列表](https://help.aliyun.com/zh/model-studio/models?spm=a2c4g.11186623.0.0.78d84823Kth5on#9f8890ce29g5u) -- `open_ai_api_base`: 通义千问 API 的 BASE URL -- `open_ai_api_key`: 通义千问的 API-KEY -
- -
-豆包 (Doubao) - -1. API Key 创建：在 [火山方舟控制台](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) 创建API Key - -2. 填写配置 - -```json -{ - "model": "doubao-seed-2-0-code-preview-260215", - "ark_api_key": "YOUR_API_KEY" -} -``` - - `model`: 可填写 `doubao-seed-2-0-code-preview-260215、doubao-seed-2-0-pro-260215、doubao-seed-2-0-lite-260215、doubao-seed-2-0-mini-260215` 等 - - `ark_api_key`: 火山方舟平台的 API Key，在 [控制台](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) 创建 - - `ark_base_url`: 可选，默认为 `https://ark.cn-beijing.volces.com/api/v3` -
- -
-Kimi (Moonshot) - -方式一：官方接入，配置如下： - -```json -{ - "model": "kimi-k2.6", - "moonshot_api_key": "" -} -``` - - `model`: 可填写 `kimi-k2.6、kimi-k2.5、kimi-k2、moonshot-v1-8k、moonshot-v1-32k、moonshot-v1-128k` - - `moonshot_api_key`: Moonshot 的 API-KEY，在 [控制台](https://platform.moonshot.cn/console/api-keys) 创建 - -方式二：OpenAI 兼容方式接入，配置如下： -```json -{ - "bot_type": "openai", - "model": "kimi-k2.6", - "open_ai_api_base": "https://api.moonshot.cn/v1", - "open_ai_api_key": "" -} -``` -- `bot_type`: OpenAI 兼容方式 -- `model`: 可填写 `kimi-k2.6、kimi-k2.5、kimi-k2、moonshot-v1-8k、moonshot-v1-32k、moonshot-v1-128k` -- `open_ai_api_base`: Moonshot 的 BASE URL -- `open_ai_api_key`: Moonshot 的 API-KEY -
- -
-ModelScope - -```json -{ - "bot_type": "modelscope", - "model": "Qwen/QwQ-32B", - "modelscope_api_key": "your_api_key", - "modelscope_base_url": "https://api-inference.modelscope.cn/v1/chat/completions", - "text_to_image": "MusePublic/489_ckpt_FLUX_1" -} -``` - -- `bot_type`: modelscope 接口格式 -- `model`: 参考[模型列表](https://www.modelscope.cn/models?filter=inference_type&page=1) -- `modelscope_api_key`: 参考 [官方文档-访问令牌](https://modelscope.cn/docs/accounts/token) ，在 [控制台](https://modelscope.cn/my/myaccesstoken) -- `modelscope_base_url`: modelscope 平台的 BASE URL -- `text_to_image`: 图像生成模型，参考[模型列表](https://www.modelscope.cn/models?filter=inference_type&page=1) -
- -
-LinkAI - -1. API Key 创建：在 [LinkAI平台](https://link-ai.tech/console/interface) 创建 API Key - -2. 填写配置 - -```json -{ - "model": "gpt-5.4-mini", - "use_linkai": true, - "linkai_api_key": "YOUR API KEY" -} -``` - -+ `use_linkai`: 是否使用 LinkAI 接口，默认关闭，设置为 true 后可对接 LinkAI 平台的模型，并使用知识库、工作流、数据库、插件等丰富的 Agent 技能 -+ `linkai_api_key`: LinkAI 平台的 API Key，可在 [控制台](https://link-ai.tech/console/interface) 中创建 -+ `model`: [模型列表](https://link-ai.tech/console/models)中的全部模型均可使用 -
- -
-Azure - -1. API Key 创建：在 [Azure平台](https://oai.azure.com/) 创建 API Key - -2. 填写配置 - -```json -{ - "model": "", - "use_azure_chatgpt": true, - "open_ai_api_key": "", - "open_ai_api_base": "", - "azure_deployment_id": "", - "azure_api_version": "2025-01-01-preview" -} -``` - - - `model`: 留空即可 - - `use_azure_chatgpt`: 设为 true - - `open_ai_api_key`: Azure 平台的密钥 - - `open_ai_api_base`: Azure 平台的 BASE URL - - `azure_deployment_id`: Azure 平台部署的模型名称 - - `azure_api_version`: api 版本以及以上参数可以在部署的 [模型配置](https://oai.azure.com/resource/deployments) 界面查看 -
- -
-百度千帆 / ERNIE - -方式一：官方接入（推荐），配置如下： - -```json -{ - "model": "ernie-5.1", - "qianfan_api_key": "", - "qianfan_api_base": "https://qianfan.baidubce.com/v2" -} -``` - - - `model`: 默认推荐填写 `ernie-5.1`（多模态，可直接识图），也可填写 `ernie-5.0`、`ernie-x1.1`、`ernie-4.5-turbo-128k`、`ernie-4.5-turbo-32k`；当主模型为纯文本 ERNIE 时，Vision 工具会自动 fallback 到 `ernie-4.5-turbo-vl` - - `qianfan_api_key`: 百度千帆 API Key，通常以 `bce-v3/` 开头，可在百度智能云控制台创建 - - `qianfan_api_base`: 可选，默认为 `https://qianfan.baidubce.com/v2` - -方式二：OpenAI 兼容方式接入，配置如下： -```json -{ - "bot_type": "openai", - "model": "ernie-5.1", - "open_ai_api_base": "https://qianfan.baidubce.com/v2", - "open_ai_api_key": "" -} -``` -- `bot_type`: OpenAI 兼容方式 -- `model`: 支持千帆平台上的 ERNIE 模型 -- `open_ai_api_base`: 百度千帆 OpenAI 兼容 API 的 BASE URL -- `open_ai_api_key`: 百度千帆 API Key - -
- -
-讯飞星火 - -方式一：官方接入，配置如下： -参考 [官方文档-快速指引](https://www.xfyun.cn/doc/platform/quickguide.html#%E7%AC%AC%E4%BA%8C%E6%AD%A5-%E5%88%9B%E5%BB%BA%E6%82%A8%E7%9A%84%E7%AC%AC%E4%B8%80%E4%B8%AA%E5%BA%94%E7%94%A8-%E5%BC%80%E5%A7%8B%E4%BD%BF%E7%94%A8%E6%9C%8D%E5%8A%A1) 获取 `APPID、 APISecret、 APIKey` 三个参数 - -```json -{ - "model": "xunfei", - "xunfei_app_id": "", - "xunfei_api_key": "", - "xunfei_api_secret": "", - "xunfei_domain": "4.0Ultra", - "xunfei_spark_url": "wss://spark-api.xf-yun.com/v4.0/chat" -} -``` - - `model`: 填 `xunfei` - - `xunfei_domain`: 可填写 `4.0Ultra、generalv3.5、max-32k、generalv3、pro-128k、lite` - - `xunfei_spark_url`: 填写参考 [官方文档-请求地址](https://www.xfyun.cn/doc/spark/Web.html#_1-1-%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80) 的说明 - -方式二：OpenAI 兼容方式接入，配置如下： -```json -{ - "bot_type": "openai", - "model": "4.0Ultra", - "open_ai_api_base": "https://spark-api-open.xf-yun.com/v1", - "open_ai_api_key": "" -} -``` -- `bot_type`: OpenAI 兼容方式 -- `model`: 可填写 `4.0Ultra、generalv3.5、max-32k、generalv3、pro-128k、lite` -- `open_ai_api_base`: 讯飞星火平台的 BASE URL -- `open_ai_api_key`: 讯飞星火平台的[APIPassword](https://console.xfyun.cn/services/bm3) ，因模型而已 -
- -
-Coding Plan - -Coding Plan 是各厂商推出的编程包月套餐，所有厂商均可通过 OpenAI 兼容方式接入： - -```json -{ - "bot_type": "openai", - "model": "模型名称", - "open_ai_api_base": "厂商 Coding Plan API Base", - "open_ai_api_key": "YOUR_API_KEY" -} -``` - -目前支持阿里云、MiniMax、智谱 GLM、Kimi、火山引擎等厂商，各厂商详细配置请参考 [Coding Plan 文档](https://docs.cowagent.ai/models/coding-plan)。 -
- - -## 通道说明 - -推荐通过 Web 控制台在线管理通道配置，无需手动编辑文件，详见 [通道文档](https://docs.cowagent.ai/channels/weixin)。以下为手动修改 `config.json` 配置通道的说明： - -支持同时可接入多个通道，配置时可通过逗号进行分割，例如 `"channel_type": "feishu,dingtalk"`。 - -
-1. Weixin - 微信 - -接入个人微信，扫码登录即可使用，支持文本、图片、语音、文件等消息收发。 - -```json -{ - "channel_type": "weixin" -} -``` - -启动后终端会显示二维码，使用微信扫码授权即可，也可以在 Web 控制台的「通道」页面中扫码接入。登录凭证会自动保存至 `~/.weixin_cow_credentials.json`，下次启动无需重新扫码，如需重新登录删除该文件后重启即可。 - -详细步骤和参数说明参考 [微信接入](https://docs.cowagent.ai/channels/weixin) - -
- -
-2. Web - -项目启动后会默认运行 Web 控制台，配置如下： - -```json -{ - "channel_type": "web", - "web_host": "0.0.0.0", - "web_password": "YOUR PASSWORD", - "web_port": 9899 -} -``` - -- `web_host`: 监听地址，默认 `127.0.0.1`（仅本机），如需公网访问请改为 `0.0.0.0` 并设置密码 -- `web_port`: 默认为 9899，可按需更改，需要服务器防火墙和安全组放行该端口 -- `web_password`: 访问密码，留空则不启用密码保护。部署在公网环境时请务必设置 -- 如本地运行，启动后请访问 `http://localhost:9899` ；如服务器运行，请访问 `http://YOUR_IP:9899` -> 注：请将上述 url 中的 ip 或者 port 替换为实际的值 -
- -
-3. Feishu - 飞书 - -飞书使用 WebSocket 长连接模式，无需公网 IP。详细步骤参考 [飞书接入](https://docs.cowagent.ai/channels/feishu)。 - -**方式一：扫码一键创建（推荐）** - -启动 Cow 后打开 Web 控制台，**通道** → **接入通道** → 选择 **飞书** → 扫码创建。也支持 CLI 启动时在终端打印二维码。 - -**方式二：手动配置** - -在飞书开放平台创建自建应用并配置权限后，将凭据填入 `config.json`： - -```json -{ - "channel_type": "feishu", - "feishu_app_id": "APP_ID", - "feishu_app_secret": "APP_SECRET", - "feishu_stream_reply": true -} -``` - -- `feishu_stream_reply`：是否开启流式打字机回复，默认开启（需 `cardkit:card:write` 权限 + 飞书客户端 ≥ 7.20） - -
- -
-4. DingTalk - 钉钉 - -钉钉需要在开放平台创建智能机器人应用，将以下配置填入 `config.json`： - -```json -{ - "channel_type": "dingtalk", - "dingtalk_client_id": "CLIENT_ID", - "dingtalk_client_secret": "CLIENT_SECRET" -} -``` -详细步骤和参数说明参考 [钉钉接入](https://docs.cowagent.ai/channels/dingtalk) -
- -
-5. WeCom Bot - 企微智能机器人 - -企微智能机器人使用 WebSocket 长连接模式，无需公网 IP 和域名。详细步骤参考 [企微智能机器人接入](https://docs.cowagent.ai/channels/wecom-bot)。 - -**方式一：扫码一键创建（推荐）** - -启动 Cow 后打开 Web 控制台，**通道** → **接入通道** → 选择 **企微智能机器人** → 使用企业微信扫码创建。 - -**方式二：手动配置** - -在企业微信中创建智能机器人并选择**长连接模式**，记录 Bot ID 和 Secret 后填入 `config.json`： - -```json -{ - "channel_type": "wecom_bot", - "wecom_bot_id": "YOUR_BOT_ID", - "wecom_bot_secret": "YOUR_SECRET" -} -``` - -
- -
-6. QQ - QQ 机器人 - -QQ 机器人使用 WebSocket 长连接模式，无需公网 IP 和域名，支持 QQ 单聊、群聊和频道消息： - -```json -{ - "channel_type": "qq", - "qq_app_id": "YOUR_APP_ID", - "qq_app_secret": "YOUR_APP_SECRET" -} -``` -详细步骤和参数说明参考 [QQ 机器人接入](https://docs.cowagent.ai/channels/qq) - -
- -
-7. WeCom App - 企业微信应用 - -企业微信自建应用接入需在后台创建应用并启用消息回调，配置示例： - -```json -{ - "channel_type": "wechatcom_app", - "wechatcom_corp_id": "CORPID", - "wechatcomapp_token": "TOKEN", - "wechatcomapp_port": 9898, - "wechatcomapp_secret": "SECRET", - "wechatcomapp_agent_id": "AGENTID", - "wechatcomapp_aes_key": "AESKEY" -} -``` -详细步骤和参数说明参考 [企微自建应用接入](https://docs.cowagent.ai/channels/wecom) - -
- -
-8. WeChat MP - 微信公众号 - -本项目支持订阅号和服务号两种公众号，通过服务号（`wechatmp_service`）体验更佳。 - -**个人订阅号（wechatmp）** - -```json -{ - "channel_type": "wechatmp", - "wechatmp_token": "TOKEN", - "wechatmp_port": 80, - "wechatmp_app_id": "APPID", - "wechatmp_app_secret": "APPSECRET", - "wechatmp_aes_key": "" -} -``` - -**企业服务号（wechatmp_service）** - -```json -{ - "channel_type": "wechatmp_service", - "wechatmp_token": "TOKEN", - "wechatmp_port": 80, - "wechatmp_app_id": "APPID", - "wechatmp_app_secret": "APPSECRET", - "wechatmp_aes_key": "" -} -``` - -详细步骤和参数说明参考 [微信公众号接入](https://docs.cowagent.ai/channels/wechatmp) - -
- -
-9. Terminal - 终端 - -修改 `config.json` 中的 `channel_type` 字段： - -```json -{ - "channel_type": "terminal" -} -``` - -运行后可在终端与机器人进行对话。 - -
-
-# 🔗 相关项目 +## 🤖 Models -- [Cow Skill Hub](https://github.com/zhayujie/cow-skill-hub)：开源的 AI Agent 技能广场，浏览、搜索、安装和发布技能，支持 CowAgent、OpenClaw、Claude Code 等多种 Agent。 -- [bot-on-anything](https://github.com/zhayujie/bot-on-anything)：轻量和高可扩展的大模型应用框架，支持接入 Slack, Telegram, Discord, Gmail 等海外平台，可作为本项目的补充使用。 -- [AgentMesh](https://github.com/MinimalFuture/AgentMesh)：开源的多智能体( Multi-Agent )框架，可以通过多智能体团队的协同来解决复杂问题。 +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](https://docs.cowagent.ai/en/models/claude) | claude-opus-4-7 | ✅ | ✅ | | | | | +| [OpenAI](https://docs.cowagent.ai/en/models/openai) | gpt-5.5, o-series | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| [Gemini](https://docs.cowagent.ai/en/models/gemini) | gemini-3.5-flash | ✅ | ✅ | ✅ | | | | +| [DeepSeek](https://docs.cowagent.ai/en/models/deepseek) | deepseek-v4-flash / pro | ✅ | | | | | | +| [Qwen](https://docs.cowagent.ai/en/models/qwen) | qwen3.7-max | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| [GLM](https://docs.cowagent.ai/en/models/glm) | glm-5.1, glm-5v-turbo | ✅ | ✅ | | ✅ | | ✅ | +| [Doubao](https://docs.cowagent.ai/en/models/doubao) | doubao-seed-2.0 series | ✅ | ✅ | ✅ | | | ✅ | +| [Kimi](https://docs.cowagent.ai/en/models/kimi) | kimi-k2.6 | ✅ | ✅ | | | | | +| [MiniMax](https://docs.cowagent.ai/en/models/minimax) | MiniMax-M2.7 | ✅ | ✅ | ✅ | | ✅ | | +| [Qianfan](https://docs.cowagent.ai/en/models/qianfan) | ernie-5.1 | ✅ | ✅ | | | | | +| [LinkAI](https://docs.cowagent.ai/en/models/linkai) | 100+ models, unified gateway | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| [Custom](https://docs.cowagent.ai/en/models/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](https://docs.cowagent.ai/en/models/index). +
-# 🔎 常见问题 +## 💬 Channels -FAQs： +A single Agent instance can serve multiple channels at once. Switch with the `channel_type` config or run several channels in parallel. -或直接在线咨询 [项目小助手](https://link-ai.tech/app/Kv2fXJcH) (知识库持续完善中，回复供参考) +| Channel | Text | Image | File | Voice | Group | +| --- | :-: | :-: | :-: | :-: | :-: | +| [Web Console](https://docs.cowagent.ai/en/channels/web) (default) | ✅ | ✅ | ✅ | ✅ | | +| [WeChat](https://docs.cowagent.ai/en/channels/weixin) | ✅ | ✅ | ✅ | ✅ | | +| [Feishu / Lark](https://docs.cowagent.ai/en/channels/feishu) | ✅ | ✅ | ✅ | ✅ | ✅ | +| [DingTalk](https://docs.cowagent.ai/en/channels/dingtalk) | ✅ | ✅ | ✅ | ✅ | ✅ | +| [WeCom Bot](https://docs.cowagent.ai/en/channels/wecom-bot) | ✅ | ✅ | ✅ | ✅ | ✅ | +| [QQ](https://docs.cowagent.ai/en/channels/qq) | ✅ | ✅ | ✅ | | ✅ | +| [WeCom App](https://docs.cowagent.ai/en/channels/wecom) | ✅ | ✅ | ✅ | ✅ | | +| [WeChat Official Account](https://docs.cowagent.ai/en/channels/wechatmp) | ✅ | ✅ | | ✅ | | -# 🛠️ 开发 +> 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](https://docs.cowagent.ai/en/channels/index). -欢迎接入更多应用通道，参考 [飞书通道](https://github.com/zhayujie/CowAgent/blob/master/channel/feishu/feishu_channel.py) 新增自定义通道，实现接收和发送消息逻辑即可完成接入。同时欢迎贡献新的 Skills，向 [Skill Hub](https://skills.cowagent.ai/submit) 提交技能。 +CowAgent Web Console -# ✉ 联系 +*The Web console doubles as the default channel and the unified place to configure and manage your Agent.* -欢迎提交PR、Issues进行反馈，以及通过 🌟Star 支持并关注项目更新。项目运行遇到问题可以查看 [常见问题列表](https://github.com/zhayujie/CowAgent/wiki/FAQs) ，以及前往 [Issues](https://github.com/zhayujie/CowAgent/issues) 中搜索。个人开发者可加入开源交流群参与更多讨论，企业用户可联系[产品客服](https://cdn.link-ai.tech/portal/linkai-customer-service.png)咨询。 +
-# 🌟 贡献者 +## 🧠 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](https://docs.cowagent.ai/en/memory/index) · [Deep Dream](https://docs.cowagent.ai/en/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](https://docs.cowagent.ai/en/knowledge/index). + + + + + + +
+ Long-term Memory +

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

+ 		+ Personal Knowledge Base +

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](https://modelcontextprotocol.io) servers. A single `mcp.json` is enough — supports stdio / SSE transports, hot reload, and zero-code integration. + +Learn more: [Tools overview](https://docs.cowagent.ai/en/tools/index) · [MCP integration](https://docs.cowagent.ai/en/tools/mcp). + +### Skills System + +- **[Skill Hub](https://skills.cowagent.ai/)** — 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 + +```bash +/skill list # list installed skills +/skill search # search the marketplace +/skill install # one-click install +``` + +Learn more: [Skills overview](https://docs.cowagent.ai/en/skills/index) · [Creating Skills](https://docs.cowagent.ai/en/skills/create). + +
+ +## 🏷 Changelog + +> **2026.05.22:** [v2.0.9](https://github.com/zhayujie/CowAgent/releases/tag/2.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](https://github.com/zhayujie/CowAgent/releases/tag/2.0.8) — Feishu channel overhaul (voice, streaming, QR onboarding), DeepSeek V4 and Baidu Qianfan support, scheduler tool upgrades. + +> **2026.04.22:** [v2.0.7](https://github.com/zhayujie/CowAgent/releases/tag/2.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](https://github.com/zhayujie/CowAgent/releases/tag/2.0.6) — Knowledge base, Deep Dream memory distillation, smart context compression, multi-session Web console. + +> **2026.04.01:** [v2.0.5](https://github.com/zhayujie/CowAgent/releases/tag/2.0.5) — Cow CLI, Skill Hub open source, browser tool, WeCom Bot QR onboarding. + +> **2026.02.03:** [v2.0.0](https://github.com/zhayujie/CowAgent/releases/tag/2.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](https://docs.cowagent.ai/en/releases/overview) + +
+ +## 🤝 Community & Support + +- 🐛 [File an Issue](https://github.com/zhayujie/CowAgent/issues) · 💬 [GitHub Discussions](https://github.com/zhayujie/CowAgent/discussions) · 📖 [FAQs](https://github.com/zhayujie/CowAgent/wiki/FAQs) + +Scan the WeChat QR code to join the open-source community group: + + + +
+ +## 🔗 Related Projects + +- **[Cow Skill Hub](https://github.com/zhayujie/cow-skill-hub)** — open skill marketplace for AI Agents; works with CowAgent, OpenClaw, Claude Code, and more +- **[bot-on-anything](https://github.com/zhayujie/bot-on-anything)** — lightweight LLM application framework with integrations for Slack, Telegram, Discord, Gmail, and more +- **[AgentMesh](https://github.com/MinimalFuture/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](https://github.com/zhayujie/CowAgent/blob/master/channel/feishu/feishu_channel.py), or contribute new skills to [Skill Hub](https://skills.cowagent.ai/submit). + +⭐ Star the project to follow updates, and feel free to open PRs and Issues. + +## 🌟 Contributors ![cow contributors](https://contrib.rocks/image?repo=zhayujie/CowAgent&max=1000) -# 📌 项目更名说明 +
-本项目原名 `chatgpt-on-wechat`（GitHub 原地址：https://github.com/zhayujie/chatgpt-on-wechat ）， -于 2026.04.13 正式更名为 **CowAgent**。GitHub 已自动设置重定向，原有链接仍可正常访问。 +## 🏢 Enterprise Services -如需更新本地仓库的远程地址（可选）： -```bash -git remote set-url origin https://github.com/zhayujie/CowAgent.git -``` +[**LinkAI**](https://link-ai.tech/) 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](https://link-ai.tech/cowagent/create) 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](https://cdn.link-ai.tech/consultant.jpg) to reach our team on WeChat. + +
+ +## ⚠️ Disclaimer + +1. This project is licensed under the [MIT License](/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. diff --git a/docs/en/README.md b/docs/en/README.md deleted file mode 100644 index 56665285..00000000 --- a/docs/en/README.md +++ /dev/null @@ -1,250 +0,0 @@ -

CowAgent

- -

- Latest release - License: MIT - Stars
- [中文] | [English] | [日本語] -

- -**CowAgent** is an AI super assistant powered by LLMs, capable of autonomous task planning, operating computers and external resources, creating and executing Skills, and continuously growing with long-term memory and a personal knowledge base. It supports flexible model switching, handles text, voice, images, and files, and can be integrated into WeChat, Web, Feishu, DingTalk, WeCom Bot, WeCom App, and WeChat Official Account — running 7×24 hours on your personal computer or server. - -

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

- -## Introduction - -> CowAgent is both an out-of-the-box AI super assistant and a highly extensible Agent framework. You can extend it with new model interfaces, channels, built-in tools, and the Skills system to flexibly implement various customization needs. - -- ✅ **Autonomous Task Planning**: Understands complex tasks and autonomously plans execution, continuously thinking and invoking tools until goals are achieved. -- ✅ **Long-term Memory**: Automatically persists conversation memory to local files and databases, including core memory, daily memory, and Deep Dream distillation, with keyword and vector retrieval support. -- ✅ **Personal Knowledge Base**: Automatically organizes structured knowledge with cross-references to build a knowledge graph, with web-based visualization and conversational management. -- ✅ **Skills System**: Implements a Skills creation and execution engine, supports installing skills from [Skill Hub](https://skills.cowagent.ai), GitHub, etc., or creating custom Skills through conversation. -- ✅ **Tool System**: Built-in tools for file I/O, terminal execution, browser automation, scheduled tasks, messaging, and more — autonomously invoked by the Agent. -- ✅ **CLI System**: Provides terminal commands and in-chat commands for process management, skill installation, configuration, and more. -- ✅ **Multimodal Messages**: Supports parsing, processing, generating, and sending text, images, voice, files, and other message types. -- ✅ **Multiple Model Support**: Supports DeepSeek, MiniMax, Claude, Gemini, OpenAI, GLM, Qwen, Doubao, Kimi, and other mainstream model providers. -- ✅ **Multi-platform Deployment**: Runs on local computers or servers, integrable into WeChat, Web, Feishu, DingTalk, WeChat Official Account, and WeCom applications. - -## Disclaimer - -1. This project follows the [MIT License](/LICENSE) and is intended for technical research and learning. Users must comply with local laws, regulations, policies, and corporate bylaws. Any illegal or rights-infringing use is prohibited. -2. Agent mode consumes more tokens than normal chat mode. Choose models based on effectiveness and cost. Agent has access to the host OS — please deploy in trusted environments. -3. CowAgent focuses on open-source development and does not participate in, authorize, or issue any cryptocurrency. - -## Demo - -Try online (no deployment needed): [CowAgent](https://link-ai.tech/cowagent/create) - -## Changelog - -> **2026.04.14:** [v2.0.6](https://github.com/zhayujie/CowAgent/releases/tag/2.0.6) — Knowledge Base, Deep Dream Memory Distillation, Smart Context Compression, Web Console upgrades. - -> **2026.04.01:** [v2.0.5](https://github.com/zhayujie/CowAgent/releases/tag/2.0.5) — Cow CLI, Skill Hub open source, Browser tool, WeCom Bot QR scan, and more. - -> **2026.02.27:** [v2.0.2](https://github.com/zhayujie/CowAgent/releases/tag/2.0.2) — Web console overhaul (streaming chat, model/skill/memory/channel/scheduler/log management), multi-channel concurrent running, session persistence, new models including Gemini 3.1 Pro / Claude 4.6 Sonnet / Qwen3.5 Plus. - -> **2026.02.13:** [v2.0.1](https://github.com/zhayujie/CowAgent/releases/tag/2.0.1) — Built-in Web Search tool, smart context trimming, runtime info dynamic update, Windows compatibility, fixes for scheduler memory loss, Feishu connection issues, and more. - -> **2026.02.03:** [v2.0.0](https://github.com/zhayujie/CowAgent/releases/tag/2.0.0) — Full upgrade to AI super assistant with multi-step task planning, long-term memory, built-in tools, Skills framework, new models, and optimized channels. - -> **2025.05.23:** [v1.7.6](https://github.com/zhayujie/CowAgent/releases/tag/1.7.6) — Web channel optimization, AgentMesh multi-agent plugin, Baidu TTS, claude-4-sonnet/opus support. - -> **2025.04.11:** [v1.7.5](https://github.com/zhayujie/CowAgent/releases/tag/1.7.5) — wechatferry protocol, DeepSeek model, Tencent Cloud voice, ModelScope and Gitee-AI support. - -> **2024.12.13:** [v1.7.4](https://github.com/zhayujie/CowAgent/releases/tag/1.7.4) — Gemini 2.0 model, Web channel, memory leak fix. - -Full changelog: [Release Notes](https://docs.cowagent.ai/en/releases/overview) - -
- -## 🚀 Quick Start - -The project provides a one-click script for installation, configuration, startup, and management: - -**Linux / macOS:** -```bash -bash <(curl -fsSL https://cdn.link-ai.tech/code/cow/run.sh) -``` - -**Windows (PowerShell):** -```powershell -irm https://cdn.link-ai.tech/code/cow/run.ps1 | iex -``` - -After running, the Web service starts by default. Access `http://localhost:9899/chat` to chat. - -Script usage: [One-click Install](https://docs.cowagent.ai/en/guide/quick-start). After installation, you can also use `cow start`, `cow stop`, and other [CLI commands](https://docs.cowagent.ai/en/cli/index) to manage the service. - -### Manual Installation - -**1. Clone the project** - -```bash -git clone https://github.com/zhayujie/CowAgent -cd CowAgent/ -``` - -**2. Install dependencies** - -```bash -pip3 install -r requirements.txt -pip3 install -r requirements-optional.txt # optional but recommended -``` - -**3. Install Cow CLI (recommended)** - -```bash -pip3 install -e . -``` - -After installation, use `cow` commands to manage the service (start, stop, update, etc.) and skills. See [Command Docs](https://docs.cowagent.ai/en/cli/index). - -**4. Install browser (optional)** - -If you need the Agent to operate a browser (visit web pages, fill forms, etc.): - -```bash -cow install-browser -``` - -This auto-installs `playwright` and Chromium. See [Browser Tool Docs](https://docs.cowagent.ai/en/tools/browser). - -**5. Configure** - -```bash -cp config-template.json config.json -``` - -Fill in your model API key and channel type in `config.json`. See the [configuration docs](https://docs.cowagent.ai/en/guide/manual-install) for details. - -**6. Run** - -```bash -cow start # recommended, requires Cow CLI -python3 app.py # or run directly -``` - -For server deployment, use `cow` commands to manage the service: - -```bash -cow start # start in background -cow stop # stop service -cow restart # restart service -cow status # check running status -cow logs # view logs -cow update # pull latest code and restart -``` - -Or use the traditional way: - -```bash -nohup python3 app.py & tail -f nohup.out -``` - -### Docker Deployment - -```bash -curl -O https://cdn.link-ai.tech/code/cow/docker-compose.yml -# Edit docker-compose.yml with your config -sudo docker compose up -d -sudo docker logs -f chatgpt-on-wechat -``` - -
- -## Models - -Supports mainstream model providers. Recommended models for Agent mode: - -| Provider | Recommended Model | -| --- | --- | -| DeepSeek | `deepseek-v4-flash` | -| MiniMax | `MiniMax-M2.7` | -| Claude | `claude-sonnet-4-6` | -| Gemini | `gemini-3.1-pro-preview` | -| OpenAI | `gpt-5.4` | -| GLM | `glm-5.1` | -| Qwen | `qwen3.6-plus` | -| Doubao | `doubao-seed-2-0-code-preview-260215` | -| Kimi | `kimi-k2.6` | - -For detailed configuration of each model, see the [Models documentation](https://docs.cowagent.ai/en/models/index). - -### Coding Plan - -Coding Plan is a monthly subscription package offered by various providers, ideal for high-frequency Agent usage. All providers can be accessed via OpenAI-compatible mode: - -```json -{ - "bot_type": "openai", - "model": "MODEL_NAME", - "open_ai_api_base": "PROVIDER_CODING_PLAN_API_BASE", - "open_ai_api_key": "YOUR_API_KEY" -} -``` - -- `bot_type`: Must be `openai` -- `model`: Model name supported by the provider -- `open_ai_api_base`: Provider's Coding Plan API Base (different from standard pay-as-you-go) -- `open_ai_api_key`: Provider's Coding Plan API Key - -> Note: Coding Plan API Base and API Key are usually separate from standard pay-as-you-go ones. Please obtain them from each provider's platform. - -Supported providers include Alibaba Cloud, MiniMax, Zhipu GLM, Kimi, Volcengine, and more. For detailed configuration of each provider, see the [Coding Plan documentation](https://docs.cowagent.ai/en/models/coding-plan). - -
- -## Channels - -Supports multiple platforms. Set `channel_type` in `config.json` to switch: - -| Channel | `channel_type` | Docs | -| --- | --- | --- | -| WeChat | `weixin` | [WeChat Setup](https://docs.cowagent.ai/en/channels/weixin) | -| Web (default) | `web` | [Web Channel](https://docs.cowagent.ai/en/channels/web) | -| Feishu | `feishu` | [Feishu Setup](https://docs.cowagent.ai/en/channels/feishu) | -| DingTalk | `dingtalk` | [DingTalk Setup](https://docs.cowagent.ai/en/channels/dingtalk) | -| WeCom Bot | `wecom_bot` | [WeCom Bot Setup](https://docs.cowagent.ai/en/channels/wecom-bot) | -| WeCom App | `wechatcom_app` | [WeCom Setup](https://docs.cowagent.ai/en/channels/wecom) | -| WeChat MP | `wechatmp` / `wechatmp_service` | [WeChat MP Setup](https://docs.cowagent.ai/en/channels/wechatmp) | -| Terminal | `terminal` | — | - -Multiple channels can be enabled simultaneously, separated by commas: `"channel_type": "feishu,dingtalk"`. - -
- -## Enterprise Services - - - -> [LinkAI](https://link-ai.tech/) is a one-stop AI agent platform for enterprises and developers, integrating multimodal LLMs, knowledge bases, Agent plugins, and workflows. Supports one-click integration with mainstream platforms, SaaS and private deployment. - -
- -## 🔗 Related Projects - -- [Cow Skill Hub](https://github.com/zhayujie/cow-skill-hub): Open skill marketplace for AI Agents — browse, search, install, and publish skills for CowAgent, OpenClaw, Claude Code, and more. -- [bot-on-anything](https://github.com/zhayujie/bot-on-anything): Lightweight and highly extensible LLM application framework supporting Slack, Telegram, Discord, Gmail, and more. -- [AgentMesh](https://github.com/MinimalFuture/AgentMesh): Open-source Multi-Agent framework for complex problem solving through agent team collaboration. - -## 🔎 FAQ - -FAQs: - -## 🛠️ Contributing - -Welcome to add new channels, referring to the [Feishu channel](https://github.com/zhayujie/CowAgent/blob/master/channel/feishu/feishu_channel.py) as an example. Also welcome to contribute new Skills, see the [Skill Creation docs](https://docs.cowagent.ai/en/skills/create), or submit to [Skill Hub](https://skills.cowagent.ai/submit). - -## ✉ Contact - -Welcome to submit PRs and Issues, and support the project with a 🌟 Star. For questions, check the [FAQ list](https://github.com/zhayujie/CowAgent/wiki/FAQs) or search [Issues](https://github.com/zhayujie/CowAgent/issues). - -## 🌟 Contributors - -![cow contributors](https://contrib.rocks/image?repo=zhayujie/CowAgent&max=1000) diff --git a/docs/en/intro/architecture.mdx b/docs/en/intro/architecture.mdx index 7de50bac..663d8dcd 100644 --- a/docs/en/intro/architecture.mdx +++ b/docs/en/intro/architecture.mdx @@ -9,7 +9,7 @@ CowAgent 2.0 has evolved from a simple chatbot into a super intelligent assistan CowAgent's architecture consists of the following core modules: -CowAgent Architecture +CowAgent Architecture | Module | Description | | --- | --- | diff --git a/docs/intro/architecture.mdx b/docs/intro/architecture.mdx index ffea7a6b..d7aa3e7a 100644 --- a/docs/intro/architecture.mdx +++ b/docs/intro/architecture.mdx @@ -9,7 +9,7 @@ CowAgent 2.0 从简单的聊天机器人全面升级为超级智能助理，采 CowAgent 的整体架构由以下核心模块组成： -CowAgent Architecture +CowAgent Architecture | 模块 | 说明 | | --- | --- | diff --git a/docs/ja/README.md b/docs/ja/README.md index 6da81796..69d7258a 100644 --- a/docs/ja/README.md +++ b/docs/ja/README.md @@ -1,250 +1,254 @@ -

CowAgent

+

CowAgent

Latest release License: MIT Stars
- [中文] | [English] | [日本語] + [English] | [中文] | [日本語]

-**CowAgent** はLLMを搭載したAIスーパーアシスタントです。自律的なタスク計画、コンピュータや外部リソースの操作、Skillの作成・実行、長期記憶とパーソナルナレッジベースによる継続的な成長が可能です。柔軟なモデル切り替えに対応し、テキスト・音声・画像・ファイルを処理でき、WeChat、Web、Feishu（飛書）、DingTalk（釘釘）、WeCom Bot（企業微信ボット）、WeComアプリ、WeChat公式アカウントに統合可能で、個人のPCやサーバー上で24時間365日稼働できます。 +**CowAgent** は、自律的にタスクを計画し、コンピュータや外部リソースを操作し、Skill を作成・実行し、パーソナルナレッジベースと長期記憶でユーザーとともに成長するオープンソースのスーパー AI アシスタントです。エンドツーエンドの Agent Harness のリファレンス実装の一つでもあります。 + +CowAgent は軽量でデプロイしやすく、拡張性に優れています。Claude、GPT、Gemini、DeepSeek、GLM、Qwen、Kimi、MiniMax などの主要モデルを自由に切り替え、WeChat、Feishu（Lark）、DingTalk、WeCom、QQ、Web、ターミナルに接続して、個人 PC やサーバー上で 24 時間 365 日稼働できます。

🌐 ウェブサイト  ·  - 📖 ドキュメント  ·  - 🚀 クイックスタート  ·  + 📖 ドキュメント  ·  + 🚀 クイックスタート  ·  🧩 Skill Hub  ·  ☁️ オンラインで試す

-## はじめに +
-> CowAgentは、すぐに使えるAIスーパーアシスタントであると同時に、高い拡張性を持つAgentフレームワークでもあります。新しいモデルインターフェース、チャネル、組み込みツール、Skillシステムを拡張することで、さまざまなカスタマイズニーズに柔軟に対応できます。 +## 🌟 主な機能 -- ✅ **自律的タスク計画**: 複雑なタスクを理解し、自律的に実行計画を立て、目標達成までツールを呼び出しながら継続的に思考します。 -- ✅ **長期記憶**: 会話の記憶をローカルファイルやデータベースに自動的に永続化します。コアメモリ、デイリーメモリ、Deep Dream 蒸留を含み、キーワード検索やベクトル検索に対応しています。 -- ✅ **パーソナルナレッジベース**: 構造化された知識を自動整理し、相互参照によるナレッジグラフを構築。Web での可視化ブラウジングと対話による管理をサポートします。 -- ✅ **Skillシステム**: Skillの作成・実行エンジンを実装。[Skill Hub](https://skills.cowagent.ai)、GitHubなどからSkillをインストールでき、会話を通じたカスタムSkill作成もサポートしています。 -- ✅ **ツールシステム**: ファイル読み書き、ターミナル実行、ブラウザ操作、スケジュールタスク、メッセージ送信などの組み込みツールを提供。Agentが自律的に呼び出して複雑なタスクを完了します。 -- ✅ **CLIシステム**: ターミナルコマンドとチャットコマンドを提供し、プロセス管理、Skillインストール、設定変更などの操作をサポートします。 -- ✅ **マルチモーダルメッセージ**: テキスト、画像、音声、ファイルなど、さまざまなメッセージタイプの解析・処理・生成・送信に対応しています。 -- ✅ **複数モデル対応**: DeepSeek、MiniMax、Claude、Gemini、OpenAI、GLM、Qwen、Doubao、Kimiなど、主要なモデルプロバイダーに対応しています。 -- ✅ **マルチプラットフォームデプロイ**: ローカルPCやサーバー上で実行でき、WeChat、Web、Feishu、DingTalk、WeChat公式アカウント、WeComアプリケーションに統合可能です。 +| 機能 | 説明 | +| :--- | :--- | +| 🤖 [自律的タスク計画](https://docs.cowagent.ai/ja/intro/architecture) | 複雑なタスクを分解し、目標達成までツールを繰り返し呼び出して段階的に実行 | +| 🧠 [長期記憶](https://docs.cowagent.ai/ja/memory/index) | 三層構造（コンテキスト → デイリー → コア）、Deep Dream による自動蒸留、キーワードとベクトルのハイブリッド検索 | +| 📚 [パーソナルナレッジベース](https://docs.cowagent.ai/ja/knowledge/index) | 構造化された知識を Markdown Wiki として自動整理し、進化し続けるナレッジグラフを可視化ブラウジング | +| 🧩 [Skill システム](https://docs.cowagent.ai/ja/skills/index) | [Skill Hub](https://skills.cowagent.ai/)、GitHub、ClawHub からワンクリックでインストール；対話によるカスタム Skill 作成にも対応 | +| 🔧 [ツールシステム](https://docs.cowagent.ai/ja/tools/index) | ファイル I/O、ターミナル、ブラウザ、スケジューラ、記憶検索、Web 検索など 10+ の組み込みツール — MCP プロトコルに完全対応 | +| 💬 [マルチチャネル統合](https://docs.cowagent.ai/ja/channels/index) | 一つの Agent で Web、WeChat、Feishu、DingTalk、WeCom、QQ、公式アカウントを同時にサポート | +| 🎨 マルチモーダルメッセージ | テキスト・画像・音声・ファイルをフルサポート — 認識・生成・双方向送受信 | +| ⚙️ [プラガブルなモデル](https://docs.cowagent.ai/ja/models/index) | Claude、GPT、Gemini、DeepSeek、GLM、Qwen、Kimi、MiniMax、Doubao など、設定 1 行で切り替え可能 | +| 📦 [すぐに使える](https://docs.cowagent.ai/ja/guide/quick-start) | ワンラインインストーラー、統合された Web コンソール、複数のデプロイモード（ローカル / Docker / サーバー） | -## 免責事項 +
-1. 本プロジェクトは [MIT License](/LICENSE) に基づいており、技術研究・学習を目的としています。利用者は現地の法律、規制、ポリシー、企業の社則を遵守する必要があります。違法行為や権利侵害となる利用は禁止されています。 -2. Agentモードは通常のチャットモードよりも多くのトークンを消費します。効果とコストに基づいてモデルを選択してください。AgentはホストOSにアクセスできるため、信頼できる環境にデプロイしてください。 -3. CowAgentはオープンソース開発に注力しており、いかなる暗号通貨の発行・参加・承認も行っていません。 +## 🏗️ アーキテクチャ -## デモ +CowAgent Architecture -オンラインで試す（デプロイ不要）: [CowAgent](https://link-ai.tech/cowagent/create) +CowAgent は完全な **Agent Harness** です：メッセージは各種**チャネル**から流入し、**Agent Core** が記憶・知識・利用可能なツール／Skill を組み合わせてタスクを計画・判断、**モデル**が応答を生成し、結果は元のチャネルに返されます。各レイヤーは疎結合で、独立して拡張可能です。 -## 更新履歴 - -> **2026.04.14:** [v2.0.6](https://github.com/zhayujie/CowAgent/releases/tag/2.0.6) — ナレッジベース、Deep Dream 記憶蒸留、スマートコンテキスト圧縮、Web コンソールアップグレード。 - -> **2026.04.01:** [v2.0.5](https://github.com/zhayujie/CowAgent/releases/tag/2.0.5) — Cow CLI、Skill Hubオープンソース化、ブラウザツール、WeCom Botスキャン作成など。 - -> **2026.02.27:** [v2.0.2](https://github.com/zhayujie/CowAgent/releases/tag/2.0.2) — Webコンソールの全面刷新（ストリーミングチャット、モデル/Skill/メモリ/チャネル/スケジューラ/ログ管理）、マルチチャネル同時実行、セッション永続化、Gemini 3.1 Pro / Claude 4.6 Sonnet / Qwen3.5 Plusなど新モデル追加。 - -> **2026.02.13:** [v2.0.1](https://github.com/zhayujie/CowAgent/releases/tag/2.0.1) — 組み込みWeb検索ツール、スマートコンテキストトリミング、ランタイム情報の動的更新、Windows互換性、スケジューラのメモリ喪失やFeishu接続問題などの修正。 - -> **2026.02.03:** [v2.0.0](https://github.com/zhayujie/CowAgent/releases/tag/2.0.0) — マルチステップタスク計画、長期記憶、組み込みツール、Skillフレームワーク、新モデル、チャネル最適化を備えたAIスーパーアシスタントへの全面アップグレード。 - -> **2025.05.23:** [v1.7.6](https://github.com/zhayujie/CowAgent/releases/tag/1.7.6) — Webチャネル最適化、AgentMeshマルチエージェントプラグイン、Baidu TTS、claude-4-sonnet/opus対応。 - -> **2025.04.11:** [v1.7.5](https://github.com/zhayujie/CowAgent/releases/tag/1.7.5) — wechatferryプロトコル、DeepSeekモデル、Tencent Cloud音声、ModelScope・Gitee-AI対応。 - -> **2024.12.13:** [v1.7.4](https://github.com/zhayujie/CowAgent/releases/tag/1.7.4) — Gemini 2.0モデル、Webチャネル、メモリリーク修正。 - -全更新履歴: [リリースノート](https://docs.cowagent.ai/en/releases/overview) +詳細は [アーキテクチャ](https://docs.cowagent.ai/ja/intro/architecture) を参照してください。
## 🚀 クイックスタート -本プロジェクトは、インストール・設定・起動・管理をワンクリックで行えるスクリプトを提供しています： +依存関係のインストール、設定、起動を自動で行うワンラインインストーラーを提供しています： **Linux / macOS:** + ```bash bash <(curl -fsSL https://cdn.link-ai.tech/code/cow/run.sh) ``` **Windows (PowerShell):** + ```powershell irm https://cdn.link-ai.tech/code/cow/run.ps1 | iex ``` -実行後、デフォルトでWebサービスが起動します。`http://localhost:9899/chat` にアクセスしてチャットを開始できます。 - -スクリプトの使い方: [ワンクリックインストール](https://docs.cowagent.ai/ja/guide/quick-start)。インストール後は `cow start`、`cow stop` などの [CLI コマンド](https://docs.cowagent.ai/ja/cli/index)でサービスを管理できます。 - -### 手動インストール - -**1. プロジェクトのクローン** - -```bash -git clone https://github.com/zhayujie/CowAgent -cd CowAgent/ -``` - -**2. 依存関係のインストール** - -```bash -pip3 install -r requirements.txt -pip3 install -r requirements-optional.txt # 任意ですが推奨 -``` - -**3. Cow CLI のインストール（推奨）** - -```bash -pip3 install -e . -``` - -インストール後、`cow` コマンドでサービス管理（起動、停止、更新など）やSkill管理ができます。[コマンドドキュメント](https://docs.cowagent.ai/ja/cli/index)を参照してください。 - -**4. ブラウザのインストール（任意）** - -Agentにブラウザ操作（Webページへのアクセス、フォーム入力など）が必要な場合： - -```bash -cow install-browser -``` - -`playwright` と Chromium を自動インストールします。[ブラウザツールドキュメント](https://docs.cowagent.ai/ja/tools/browser)を参照してください。 - -**5. 設定** - -```bash -cp config-template.json config.json -``` - -`config.json` にモデルのAPIキーとチャネルタイプを記入してください。詳細は[設定ドキュメント](https://docs.cowagent.ai/en/guide/manual-install)を参照してください。 - -**6. 実行** - -```bash -cow start # 推奨、Cow CLI が必要 -python3 app.py # または直接実行 -``` - -サーバーデプロイでは、`cow` コマンドでサービスを管理できます： - -```bash -cow start # バックグラウンドで起動 -cow stop # サービス停止 -cow restart # サービス再起動 -cow status # 実行状態を確認 -cow logs # ログを表示 -cow update # 最新コードを取得して再起動 -``` - -または従来の方法で実行： - -```bash -nohup python3 app.py & tail -f nohup.out -``` - -### Dockerデプロイ +**Docker:** ```bash curl -O https://cdn.link-ai.tech/code/cow/docker-compose.yml -# docker-compose.yml を編集して設定を記入 -sudo docker compose up -d -sudo docker logs -f chatgpt-on-wechat +docker compose up -d +``` + +起動後、`http://localhost:9899` にアクセスして **Web コンソール**を開くと、モデル設定・チャネル接続・Skill インストールがすべてここで完結します。 + +> 📖 詳細ガイド: [ワンラインインストーラー](https://docs.cowagent.ai/ja/guide/quick-start) · [ソースから手動インストール](https://docs.cowagent.ai/ja/guide/manual-install) · [アップグレード](https://docs.cowagent.ai/ja/guide/upgrade) + +インストール後は、[`cow` CLI](https://docs.cowagent.ai/ja/cli/index) でサービスを管理できます： + +```bash +cow start | stop | restart # サービス制御 +cow status | logs # ステータスとログ +cow update # 最新コード取得後に再起動 +cow skill install <名前> # Skill のインストール +cow install-browser # ブラウザツールのインストール ```
-## モデル +## 🤖 モデル -主要なモデルプロバイダーに対応しています。Agentモードの推奨モデル： +CowAgent は主要な LLM プロバイダーすべてに対応しています。**チャット、画像認識、画像生成、ASR/TTS、埋め込み（Embedding）** の各機能はそれぞれ別のベンダーで設定可能です。 -| プロバイダー | 推奨モデル | -| --- | --- | -| DeepSeek | `deepseek-v4-flash` | -| MiniMax | `MiniMax-M2.7` | -| Claude | `claude-sonnet-4-6` | -| Gemini | `gemini-3.1-pro-preview` | -| OpenAI | `gpt-5.4` | -| GLM | `glm-5.1` | -| Qwen | `qwen3.6-plus` | -| Doubao | `doubao-seed-2-0-code-preview-260215` | -| Kimi | `kimi-k2.6` | +| プロバイダー | 代表的なモデル | チャット | 画像認識 | 画像生成 | ASR | TTS | Embedding | +| --- | --- | :-: | :-: | :-: | :-: | :-: | :-: | +| [Claude](https://docs.cowagent.ai/ja/models/claude) | claude-opus-4-7 | ✅ | ✅ | | | | | +| [OpenAI](https://docs.cowagent.ai/ja/models/openai) | gpt-5.5、o シリーズ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| [Gemini](https://docs.cowagent.ai/ja/models/gemini) | gemini-3.5-flash | ✅ | ✅ | ✅ | | | | +| [DeepSeek](https://docs.cowagent.ai/ja/models/deepseek) | deepseek-v4-flash / pro | ✅ | | | | | | +| [Qwen](https://docs.cowagent.ai/ja/models/qwen) | qwen3.7-max | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| [GLM](https://docs.cowagent.ai/ja/models/glm) | glm-5.1、glm-5v-turbo | ✅ | ✅ | | ✅ | | ✅ | +| [Doubao](https://docs.cowagent.ai/ja/models/doubao) | doubao-seed-2.0 シリーズ | ✅ | ✅ | ✅ | | | ✅ | +| [Kimi](https://docs.cowagent.ai/ja/models/kimi) | kimi-k2.6 | ✅ | ✅ | | | | | +| [MiniMax](https://docs.cowagent.ai/ja/models/minimax) | MiniMax-M2.7 | ✅ | ✅ | ✅ | | ✅ | | +| [Qianfan](https://docs.cowagent.ai/ja/models/qianfan) | ernie-5.1 | ✅ | ✅ | | | | | +| [LinkAI](https://docs.cowagent.ai/ja/models/linkai) | 100+ モデルを統一ゲートウェイで提供 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| [カスタム](https://docs.cowagent.ai/ja/models/custom) | ローカルモデル / サードパーティプロキシ | ✅ | | | | | | -各モデルの詳細設定については、[モデルドキュメント](https://docs.cowagent.ai/en/models/index)を参照してください。 +> Web コンソールでの設定が推奨されており、ファイルを手動編集する必要はありません。手動設定については各プロバイダーのドキュメントおよび [モデル概要](https://docs.cowagent.ai/ja/models/index) を参照してください。 -### Coding Plan +
-Coding Planは各プロバイダーが提供する月額サブスクリプションパッケージで、高頻度のAgent利用に最適です。すべてのプロバイダーはOpenAI互換モードでアクセスできます： +## 💬 チャネル -```json -{ - "bot_type": "openai", - "model": "MODEL_NAME", - "open_ai_api_base": "PROVIDER_CODING_PLAN_API_BASE", - "open_ai_api_key": "YOUR_API_KEY" -} +一つの Agent インスタンスで複数のチャネルを同時に提供できます。`channel_type` 設定で切り替えるか、複数のチャネルを並列実行できます。 + +| チャネル | テキスト | 画像 | ファイル | 音声 | グループ | +| --- | :-: | :-: | :-: | :-: | :-: | +| [Web コンソール](https://docs.cowagent.ai/ja/channels/web)（デフォルト） | ✅ | ✅ | ✅ | ✅ | | +| [WeChat](https://docs.cowagent.ai/ja/channels/weixin) | ✅ | ✅ | ✅ | ✅ | | +| [Feishu / Lark](https://docs.cowagent.ai/ja/channels/feishu) | ✅ | ✅ | ✅ | ✅ | ✅ | +| [DingTalk](https://docs.cowagent.ai/ja/channels/dingtalk) | ✅ | ✅ | ✅ | ✅ | ✅ | +| [WeCom Bot](https://docs.cowagent.ai/ja/channels/wecom-bot) | ✅ | ✅ | ✅ | ✅ | ✅ | +| [QQ](https://docs.cowagent.ai/ja/channels/qq) | ✅ | ✅ | ✅ | | ✅ | +| [WeCom App](https://docs.cowagent.ai/ja/channels/wecom) | ✅ | ✅ | ✅ | ✅ | | +| [WeChat 公式アカウント](https://docs.cowagent.ai/ja/channels/wechatmp) | ✅ | ✅ | | ✅ | | + +> Feishu と WeCom Bot は **Web コンソール内で QR コードをスキャンするだけで接続**できます — パブリック IP は不要です。詳細は [チャネル概要](https://docs.cowagent.ai/ja/channels/index) を参照してください。 + +CowAgent Web Console + +*Web コンソールはデフォルトのチャネルであると同時に、Agent の設定・管理を統一的に行う場でもあります。* + +
+ +## 🧠 記憶とナレッジベース + +**長期記憶**は三層構造：会話コンテキスト（短期）→ デイリー記憶（中期）→ MEMORY.md（長期）。毎晩の **Deep Dream** が散在する記憶を洗練された長期記憶とナラティブな日記に蒸留します。詳細は [長期記憶](https://docs.cowagent.ai/ja/memory/index) · [Deep Dream](https://docs.cowagent.ai/ja/memory/deep-dream) を参照してください。 + +**パーソナルナレッジベース**は時系列の記憶とは異なり、構造化された知識を**トピック単位**で整理します。Agent が会話中に有用な情報を自動でキュレーションし、相互参照とインデックスを維持し、Web コンソールでナレッジグラフを可視化できます。詳細は [パーソナルナレッジベース](https://docs.cowagent.ai/ja/knowledge/index) を参照してください。 + + + + + + +
+ 長期記憶 +

長期記憶 · 三層構造 + Deep Dream

+ 		+ パーソナルナレッジベース +

ナレッジベース · 自動キュレーションされた Markdown Wiki

+
+ +
+ +## 🔧 ツールと Skill + +**ツール（Tools）** は Agent がシステムリソースを操作するためのアトミックな機能です。**Skill（Skills）** はマニフェストファイルで定義される高レベルのワークフローで、複数のツールを組み合わせて複雑なタスクを完了します。 + +### ツールシステム + +**組み込みツール**には、ファイル I/O（`read` / `write` / `edit` / `ls`）、ターミナル（`bash`）、ファイル送信（`send`）、記憶検索（`memory`）、環境変数（`env_config`）、Web フェッチ（`web_fetch`）、スケジューラ（`scheduler`）、Web 検索（`web_search`）、画像認識（`vision`）、ブラウザ自動化（`browser`）などが含まれます。 + +**MCP プロトコル**は [Model Context Protocol](https://modelcontextprotocol.io) のオープンエコシステムを統合します。`mcp.json` を一度設定すれば即利用可能で、stdio / SSE トランスポート、ホットリロード、ノーコード統合をサポートします。 + +詳細: [ツール概要](https://docs.cowagent.ai/ja/tools/index) · [MCP 統合](https://docs.cowagent.ai/ja/tools/mcp)。 + +### Skill システム + +- **[Skill Hub](https://skills.cowagent.ai/)** — オープン Skill マーケットプレイス：閲覧、検索、ワンクリックインストール +- **GitHub / ClawHub** — 複数の Skill ソース、4 万以上の Skill を利用可能 +- **対話による作成** — `skill-creator` を使って対話でカスタム Skill を生成；ワークフローやサードパーティ API を再利用可能な Skill に変換 + +```bash +/skill list # インストール済み Skill の一覧 +/skill search <キーワード> # マーケットプレイスで検索 +/skill install <名前> # ワンクリックインストール ``` -- `bot_type`: `openai` を指定 -- `model`: プロバイダーがサポートするモデル名 -- `open_ai_api_base`: プロバイダーのCoding Plan API Base（標準の従量課金とは異なります） -- `open_ai_api_key`: プロバイダーのCoding Plan APIキー - -> 注意：Coding PlanのAPI BaseとAPIキーは、通常の従量課金のものとは別です。各プロバイダーのプラットフォームから取得してください。 - -対応プロバイダーには、Alibaba Cloud、MiniMax、Zhipu GLM、Kimi、Volcengineなどがあります。各プロバイダーの詳細設定については、[Coding Planドキュメント](https://docs.cowagent.ai/en/models/coding-plan)を参照してください。 +詳細: [Skill 概要](https://docs.cowagent.ai/ja/skills/index) · [Skill 作成](https://docs.cowagent.ai/ja/skills/create)。
-## チャネル +## 🏷 更新履歴 -複数のプラットフォームに対応しています。`config.json` の `channel_type` を設定して切り替えます： +> **2026.05.22:** [v2.0.9](https://github.com/zhayujie/CowAgent/releases/tag/2.0.9) — モデル管理、MCP プロトコル対応、ブラウザセッション永続化、新モデル（gpt-5.5、gemini-3.5-flash、qwen3.7-max）、デプロイのセキュリティ強化。 -| チャネル | `channel_type` | ドキュメント | -| --- | --- | --- | -| WeChat | `weixin` | [WeChat設定](https://docs.cowagent.ai/ja/channels/weixin) | -| Web（デフォルト） | `web` | [Webチャネル](https://docs.cowagent.ai/en/channels/web) | -| Feishu（飛書） | `feishu` | [Feishu設定](https://docs.cowagent.ai/en/channels/feishu) | -| DingTalk（釘釘） | `dingtalk` | [DingTalk設定](https://docs.cowagent.ai/en/channels/dingtalk) | -| WeCom Bot | `wecom_bot` | [WeCom Bot設定](https://docs.cowagent.ai/en/channels/wecom-bot) | -| WeComアプリ | `wechatcom_app` | [WeCom設定](https://docs.cowagent.ai/en/channels/wecom) | -| WeChat公式アカウント | `wechatmp` / `wechatmp_service` | [WeChat公式アカウント設定](https://docs.cowagent.ai/en/channels/wechatmp) | -| ターミナル | `terminal` | — | +> **2026.05.06:** [v2.0.8](https://github.com/zhayujie/CowAgent/releases/tag/2.0.8) — Feishu チャネル全面アップグレード（音声、ストリーミング、QR 接続）、DeepSeek V4 と Baidu Qianfan 対応、スケジューラツール強化。 -複数チャネルを同時に有効化できます。カンマ区切りで指定してください：`"channel_type": "feishu,dingtalk"` +> **2026.04.22:** [v2.0.7](https://github.com/zhayujie/CowAgent/releases/tag/2.0.7) — 組み込み画像生成（GPT Image 2、Nano Banana）、新モデル（Kimi K2.6、Claude Opus 4.7、GLM 5.1）、ナレッジベースと記憶の強化。 + +> **2026.04.14:** [v2.0.6](https://github.com/zhayujie/CowAgent/releases/tag/2.0.6) — ナレッジベース、Deep Dream 記憶蒸留、スマートコンテキスト圧縮、マルチセッション Web コンソール。 + +> **2026.04.01:** [v2.0.5](https://github.com/zhayujie/CowAgent/releases/tag/2.0.5) — Cow CLI、Skill Hub オープンソース化、ブラウザツール、WeCom Bot QR 接続。 + +> **2026.02.03:** [v2.0.0](https://github.com/zhayujie/CowAgent/releases/tag/2.0.0) — マルチステップタスク計画、長期記憶、Skill フレームワークを備えたスーパー Agent アシスタントへの全面アップグレード。 + +完全な履歴: [リリースノート](https://docs.cowagent.ai/ja/releases/overview)
-## エンタープライズサービス +## 🤝 コミュニティとサポート - +- 🐛 [Issue を報告](https://github.com/zhayujie/CowAgent/issues) · 💬 [GitHub Discussions](https://github.com/zhayujie/CowAgent/discussions) · 📖 [FAQ](https://github.com/zhayujie/CowAgent/wiki/FAQs) -> [LinkAI](https://link-ai.tech/) は、企業や開発者向けのワンストップAIエージェントプラットフォームです。マルチモーダルLLM、ナレッジベース、Agentプラグイン、ワークフローを統合しています。主要プラットフォームへのワンクリック統合、SaaSおよびプライベートデプロイに対応しています。 +WeChat の QR コードをスキャンしてオープンソースコミュニティグループに参加： + +
## 🔗 関連プロジェクト -- [Cow Skill Hub](https://github.com/zhayujie/cow-skill-hub): AIエージェント向けのオープンSkillマーケットプレイス。CowAgent、OpenClaw、Claude Codeなどで利用可能なSkillの閲覧・検索・インストール・公開が可能。 -- [bot-on-anything](https://github.com/zhayujie/bot-on-anything): 軽量で高い拡張性を持つLLMアプリケーションフレームワーク。Slack、Telegram、Discord、Gmailなどに対応。 -- [AgentMesh](https://github.com/MinimalFuture/AgentMesh): エージェントチームの協調による複雑な問題解決のためのオープンソースのマルチエージェントフレームワーク。 +- **[Cow Skill Hub](https://github.com/zhayujie/cow-skill-hub)** — AI エージェント向けのオープン Skill マーケットプレイス；CowAgent、OpenClaw、Claude Code などに対応 +- **[bot-on-anything](https://github.com/zhayujie/bot-on-anything)** — 軽量な LLM アプリケーションフレームワーク；Slack、Telegram、Discord、Gmail などに対応 +- **[AgentMesh](https://github.com/MinimalFuture/AgentMesh)** — チーム協調による複雑な問題解決のためのオープンソースのマルチエージェントフレームワーク -## 🔎 よくある質問 +
-FAQ: +## 🛠️ 開発とコントリビューション -## 🛠️ コントリビューション +新しいチャネルの追加を歓迎します — [Feishu チャネル](https://github.com/zhayujie/CowAgent/blob/master/channel/feishu/feishu_channel.py) を参考にカスタムチャネルを実装できます。新しい Skill のコントリビューションも [Skill Hub](https://skills.cowagent.ai/submit) で受け付けています。 -新しいチャネルの追加を歓迎します。[Feishuチャネル](https://github.com/zhayujie/CowAgent/blob/master/channel/feishu/feishu_channel.py)を参考にしてください。また、新しいSkillのコントリビューションも歓迎します。[Skill作成ドキュメント](https://docs.cowagent.ai/ja/skills/create)を参照するか、[Skill Hub](https://skills.cowagent.ai/submit)に提出してください。 - -## ✉ お問い合わせ - -PRやIssueの提出を歓迎します。🌟 Starでプロジェクトをサポートしてください。ご質問がある場合は、[FAQリスト](https://github.com/zhayujie/CowAgent/wiki/FAQs)を確認するか、[Issues](https://github.com/zhayujie/CowAgent/issues)を検索してください。 +⭐ Star でプロジェクトの更新をフォローしてください。PR や Issue の提出も歓迎します。 ## 🌟 コントリビューター ![cow contributors](https://contrib.rocks/image?repo=zhayujie/CowAgent&max=1000) + +
+ +## 🏢 エンタープライズサービス + +[**LinkAI**](https://link-ai.tech/) は企業や開発者向けのワンストップ AI Agent プラットフォームで、CowAgent にマネージドホスティングとエンタープライズグレードのサポートを提供します： + +- **🚀 デプロイ不要のホスト型ランタイム** — [CowAgent オンラインアシスタント](https://link-ai.tech/cowagent/create) を 1 分以内に起動、サーバー不要 +- **🧠 統合モデル & Skill マーケットプレイス** — 主要 LLM への統一アクセスと公式 Skill マーケットプレイスで CowAgent の活用範囲を拡大 +- **🏢 チーム & エンタープライズ機能** — ワークスペース、ロールベースのアクセス制御、監査ログ、本番運用向けプライベートデプロイ + +エンタープライズに関するお問い合わせ：**sales@simple-future.tech** または [QR コードをスキャン](https://cdn.link-ai.tech/consultant.jpg) して WeChat でお問い合わせください。 + +
+ +## ⚠️ 免責事項 + +1. 本プロジェクトは [MIT License](/LICENSE) に基づき、技術研究と学習を目的としています。利用者は所在地の法令・規制を遵守する必要があり、本プロジェクトの利用に起因するいかなる結果についてもメンテナーは責任を負いません。 +2. **コストと安全性：** Agent モードは通常のチャットよりトークン消費が大幅に多いため、品質とコストのバランスを考慮してモデルを選択してください。Agent はローカル OS にアクセスできるため、信頼できる環境にのみデプロイしてください。 +3. CowAgent は純粋なオープンソースプロジェクトであり、暗号通貨の発行・参加・承認は一切行いません。 + +
+ +## 📌 プロジェクト改名のお知らせ + +本プロジェクトは旧名 `chatgpt-on-wechat` から、2026.04.13 に **CowAgent** へ正式に改名されました。元の GitHub URL は自動的にリダイレクトされます。既存ユーザーは `git remote set-url origin https://github.com/zhayujie/CowAgent.git` でローカルのリモートを更新できます。 diff --git a/docs/ja/intro/architecture.mdx b/docs/ja/intro/architecture.mdx index 8ecf4a6f..e6aa6e1d 100644 --- a/docs/ja/intro/architecture.mdx +++ b/docs/ja/intro/architecture.mdx @@ -9,7 +9,7 @@ CowAgent 2.0 は、シンプルなチャットボットから、自律的な思 CowAgent のアーキテクチャは以下のコアモジュールで構成されています： -CowAgent Architecture +CowAgent Architecture | モジュール | 説明 | | --- | --- | diff --git a/docs/zh/README.md b/docs/zh/README.md new file mode 100644 index 00000000..b91de67b --- /dev/null +++ b/docs/zh/README.md @@ -0,0 +1,262 @@ +

CowAgent

+ +

+ Latest release + License: MIT + Stars
+ [English] | [中文] | [日本語] +

+ +**CowAgent** 是一个开源的超级 AI 助理，能够主动思考和规划任务、操作计算机和外部资源、创造和执行 Skills、构建知识库与长期记忆，与你一同成长，是 Agent Harness 工程的最佳实践之一。 + +CowAgent 轻量易部署、灵活可扩展，可自由切换 DeepSeek、Claude、Gemini、GPT、GLM、Qwen、Kimi、MiniMax 等主流模型，接入微信、飞书、钉钉、企微、QQ、网页或终端，7×24 运行于个人电脑或服务器中。 + +

+ 🌐 官网  ·  + 📖 文档中心  ·  + 🚀 快速开始  ·  + 🧩 技能广场  ·  + ☁️ 在线体验 +

+ +
+ +## 🌟 核心能力 + +| 能力 | 说明 | +| :--- | :--- | +| 🤖 [自主任务规划](https://docs.cowagent.ai/intro/architecture) | 理解复杂任务并自主分解执行，循环调用工具直到完成目标 | +| 🧠 [长期记忆](https://docs.cowagent.ai/memory) | 三层记忆架构（上下文 → 天级 → 核心），梦境蒸馏自动整理，支持关键词与向量混合检索 | +| 📚 [个人知识库](https://docs.cowagent.ai/knowledge) | 自动整理结构化知识为 Markdown Wiki，构建持续增长的知识图谱，可视化浏览 | +| 🧩 [技能系统](https://docs.cowagent.ai/skills) | 从 [Skill Hub](https://skills.cowagent.ai/)、GitHub、ClawHub 等一键安装；也可通过对话创造自定义技能 | +| 🔧 [工具系统](https://docs.cowagent.ai/tools) | 内置文件读写、终端、浏览器、定时任务、记忆检索、联网搜索等 10+ 工具，支持 MCP 协议 | +| 💬 [多渠道接入](https://docs.cowagent.ai/channels) | 一个 Agent 同时接入 Web、微信、飞书、钉钉、企微、QQ、公众号 等多个渠道 | +| 🎨 多模态消息 | 文本、图片、语音、文件全消息类型支持，覆盖识别、生成、收发 | +| ⚙️ [多模型自由切换](https://docs.cowagent.ai/models) | DeepSeek、Claude、Gemini、GPT、GLM、Qwen、Kimi、MiniMax、Doubao 等主流厂商，配置一行切换 | +| 📦 [开箱即用](https://docs.cowagent.ai/guide/quick-start) | 一键脚本安装，Web 控制台统一管理；本地、Docker、服务器多种部署方式 | + +
+ +## 🏗️ 架构总览 + +CowAgent Architecture + +CowAgent 是一个完整的 **Agent Harness**：消息从各类**通道**进入，**Agent Core** 结合记忆、知识库与可用工具/技能进行任务规划与决策，调用**模型**生成结果，再回传至原通道。各模块解耦清晰，按需扩展。 + +详见 [项目架构](https://docs.cowagent.ai/intro/architecture)。 + +
+ +## 🚀 快速开始 + +项目提供一键安装脚本，自动完成依赖安装、配置和启动： + +**Linux / macOS：** + +```bash +bash <(curl -fsSL https://cdn.link-ai.tech/code/cow/run.sh) +``` + +**Windows（PowerShell）：** + +```powershell +irm https://cdn.link-ai.tech/code/cow/run.ps1 | iex +``` + +**Docker：** + +```bash +curl -O https://cdn.link-ai.tech/code/cow/docker-compose.yml +docker compose up -d +``` + +启动成功后访问 `http://localhost:9899` 进入 **Web 控制台**，在控制台内即可完成模型配置、渠道接入、技能安装等全部操作。 + +> 📖 详细安装指南：[一键运行脚本](https://docs.cowagent.ai/guide/quick-start) · [手动源码安装](https://docs.cowagent.ai/guide/manual-install) · [升级](https://docs.cowagent.ai/guide/upgrade) + +安装后可使用 `cow` [CLI 命令](https://docs.cowagent.ai/cli) 管理服务： + +```bash +cow start | stop | restart # 服务管理 +cow status | logs # 状态和日志 +cow update # 拉取最新代码并重启 +cow skill install <名称> # 安装技能 +cow install-browser # 安装浏览器工具 +``` + +
+ +## 🤖 模型支持 + +CowAgent 支持国内外主流厂商的大语言模型。**文本对话、图像理解、图像生成、语音识别/合成、向量** 等能力均可独立配置厂商。 + +| 厂商 | 代表模型 | 文本 | 图像理解 | 图像生成 | 语音识别 | 语音合成 | 向量 | +| --- | --- | :-: | :-: | :-: | :-: | :-: | :-: | +| [DeepSeek](https://docs.cowagent.ai/models/deepseek) | deepseek-v4-flash / pro | ✅ | | | | | | +| [MiniMax](https://docs.cowagent.ai/models/minimax) | MiniMax-M2.7 | ✅ | ✅ | ✅ | | ✅ | | +| [Claude](https://docs.cowagent.ai/models/claude) | claude-opus-4-7 | ✅ | ✅ | | | | | +| [Gemini](https://docs.cowagent.ai/models/gemini) | gemini-3.5-flash | ✅ | ✅ | ✅ | | | | +| [OpenAI](https://docs.cowagent.ai/models/openai) | gpt-5.5、o 系列 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| [智谱 GLM](https://docs.cowagent.ai/models/glm) | glm-5.1、glm-5v-turbo | ✅ | ✅ | | ✅ | | ✅ | +| [通义千问](https://docs.cowagent.ai/models/qwen) | qwen3.7-max | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| [豆包 Doubao](https://docs.cowagent.ai/models/doubao) | doubao-seed-2.0 系列 | ✅ | ✅ | ✅ | | | ✅ | +| [Kimi](https://docs.cowagent.ai/models/kimi) | kimi-k2.6 | ✅ | ✅ | | | | | +| [百度千帆](https://docs.cowagent.ai/models/qianfan) | ernie-5.1 | ✅ | ✅ | | | | | +| [LinkAI](https://docs.cowagent.ai/models/linkai) | 100+ 模型统一接入 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| [自定义](https://docs.cowagent.ai/models/custom) | 本地模型 / 三方代理 | ✅ | | | | | | + +> 推荐通过 Web 控制台在线配置，无需手动编辑文件。手动配置请参考各厂商文档，详见 [模型概览](https://docs.cowagent.ai/models)。 + +
+ +## 💬 通道接入 + +一个 Agent 实例可同时接入多个渠道，启动时通过 `channel_type` 切换或并行运行。 + +| 通道 | 文本 | 图片 | 文件 | 语音 | 群聊 | +| --- | :-: | :-: | :-: | :-: | :-: | +| [Web 控制台](https://docs.cowagent.ai/channels/web)（默认） | ✅ | ✅ | ✅ | ✅ | | +| [微信](https://docs.cowagent.ai/channels/weixin) | ✅ | ✅ | ✅ | ✅ | | +| [飞书](https://docs.cowagent.ai/channels/feishu) | ✅ | ✅ | ✅ | ✅ | ✅ | +| [钉钉](https://docs.cowagent.ai/channels/dingtalk) | ✅ | ✅ | ✅ | ✅ | ✅ | +| [企微智能机器人](https://docs.cowagent.ai/channels/wecom-bot) | ✅ | ✅ | ✅ | ✅ | ✅ | +| [QQ](https://docs.cowagent.ai/channels/qq) | ✅ | ✅ | ✅ | | ✅ | +| [企业微信应用](https://docs.cowagent.ai/channels/wecom) | ✅ | ✅ | ✅ | ✅ | | +| [微信公众号](https://docs.cowagent.ai/channels/wechatmp) | ✅ | ✅ | | ✅ | | + +> 飞书、企微智能机器人支持在 Web 控制台内**扫码一键接入**，无需公网 IP。详见 [通道概览](https://docs.cowagent.ai/channels)。 + +CowAgent Web 控制台 + +*Web 控制台是默认通道，也是统一的 Agent 配置和管理入口* + +
+ +## 🧠 记忆与知识库 + +**长期记忆**采用三层架构：对话上下文（短期）→ 天级记忆（中期）→ MEMORY.md（长期）。每日自动执行**梦境蒸馏（Deep Dream）**，将分散记忆整合为精炼的长期记忆并生成叙事日记。详见 [长期记忆](https://docs.cowagent.ai/memory) · [梦境蒸馏](https://docs.cowagent.ai/memory/deep-dream)。 + +**个人知识库** 与按时间记录的记忆不同，以**主题为维度**组织结构化知识。Agent 在对话中自动整理有价值信息，维护交叉引用与索引，Web 控制台可可视化浏览知识图谱。详见 [个人知识库](https://docs.cowagent.ai/knowledge)。 + + + + + + +
+ 长期记忆 +

长期记忆 · 三层记忆 + 梦境蒸馏

+ 		+ 个人知识库 +

个人知识库 · 自动整理的 Markdown Wiki

+
+ +
+ + +## 🔧 工具与技能 + +**工具（Tools）** 是 Agent 操作系统资源的原子能力，**技能（Skills）** 是基于说明文件的高级工作流，可组合多个工具完成复杂任务。 + +### 工具系统 + +**内置工具** 涵盖文件读写（`read` / `write` / `edit` / `ls`）、终端（`bash`）、文件发送（`send`）、记忆检索（`memory`）、环境变量（`env_config`）、网页获取（`web_fetch`）、定时任务（`scheduler`）、联网搜索（`web_search`）、图像识别（`vision`）、浏览器自动化（`browser`）等常用能力。 + +**MCP 协议** 通过 [Model Context Protocol](https://modelcontextprotocol.io) 接入开放生态中的各种 MCP 服务，配置一次 `mcp.json` 即用即得，支持 stdio / SSE 协议、热更新、零代码接入。 + +详见 [工具概览](https://docs.cowagent.ai/tools) · [MCP 集成](https://docs.cowagent.ai/tools/mcp)。 + +### 技能系统 + +- **[Skill Hub](https://skills.cowagent.ai/)** — 开源的技能广场，浏览、搜索、一键安装 +- **GitHub / ClawHub** — 多平台技能源，4w+ 技能可选 +- **对话创造** — 通过 `skill-creator` 用对话快速生成自定义技能，可将工作流程或第三方接口直接固化为技能 + +```bash +/skill list # 查看当前技能 +/skill search <关键词> # 在技能广场搜索 +/skill install <名称> # 一键安装 +``` + +详见 [技能概览](https://docs.cowagent.ai/skills) · [创建技能](https://docs.cowagent.ai/skills/create)。 + +
+ +## 🏷 更新日志 + +> **2026.05.22：** [v2.0.9](https://github.com/zhayujie/CowAgent/releases/tag/2.0.9) — 模型管理、MCP 协议支持、浏览器登录态持久化、新模型接入（gpt-5.5、gemini-3.5-flash、qwen3.7-max）、部署安全加固 + +> **2026.05.06：** [v2.0.8](https://github.com/zhayujie/CowAgent/releases/tag/2.0.8) — 飞书渠道全面升级（语音、流式输出、扫码接入）、新模型支持（DeepSeek V4、百度千帆）、定时任务工具增强 + +> **2026.04.22：** [v2.0.7](https://github.com/zhayujie/CowAgent/releases/tag/2.0.7) — 图像生成内置技能（GPT Image 2、Nano Banana）、新模型支持（Kimi K2.6、Claude Opus 4.7、GLM 5.1）、知识库和记忆增强 + +> **2026.04.14：** [v2.0.6](https://github.com/zhayujie/CowAgent/releases/tag/2.0.6) — 知识库系统、梦境记忆模块、上下文智能压缩、Web 控制台多会话 + +> **2026.04.01：** [v2.0.5](https://github.com/zhayujie/CowAgent/releases/tag/2.0.5) — Cow CLI 命令系统、Skill Hub 开源、浏览器工具、企微扫码创建 + +> **2026.03.22：** [v2.0.4](https://github.com/zhayujie/CowAgent/releases/tag/2.0.4) — 新增个人微信通道，支持文本/图片/文件/语音消息 + +> **2026.02.03：** [v2.0.0](https://github.com/zhayujie/CowAgent/releases/tag/2.0.0) — 正式升级为超级 Agent 助理，支持多轮任务决策、长期记忆、Skills 框架 + +完整更新历史：[Release Notes](https://docs.cowagent.ai/releases) + +
+ +## 🤝 社区与支持 + +添加小助手微信加入开源项目交流群： + + + +- 🐛 [提交 Issue](https://github.com/zhayujie/CowAgent/issues) · 💬 [GitHub Discussions](https://github.com/zhayujie/CowAgent/discussions) · 📖 [常见问题 FAQs](https://github.com/zhayujie/CowAgent/wiki/FAQs) +- 🤖 在线咨询：[项目小助手](https://link-ai.tech/app/Kv2fXJcH)（知识库持续完善中） + +
+ +## 🔗 相关项目 + +- **[Cow Skill Hub](https://github.com/zhayujie/cow-skill-hub)** — 开源的 AI Agent 技能广场，支持 CowAgent、OpenClaw、Claude Code 等多种 Agent +- **[bot-on-anything](https://github.com/zhayujie/bot-on-anything)** — 轻量大模型应用框架，支持 Slack、Telegram、Discord、Gmail 等海外平台 +- **[AgentMesh](https://github.com/MinimalFuture/AgentMesh)** — 开源多智能体（Multi-Agent）框架，通过团队协同解决复杂问题 + +
+ +## 🛠️ 开发与贡献 + +欢迎接入更多应用通道，参考 [飞书通道实现](https://github.com/zhayujie/CowAgent/blob/master/channel/feishu/feishu_channel.py) 新增自定义通道；同时欢迎贡献新技能，向 [Skill Hub](https://skills.cowagent.ai/submit) 提交。 + +通过 ⭐ Star 关注项目更新，欢迎提交 PR、Issue 进行反馈。 + +## 🌟 贡献者 + +![cow contributors](https://contrib.rocks/image?repo=zhayujie/CowAgent&max=1000) + +
+ +## 🏢 企业服务 + + + +> [LinkAI](https://link-ai.tech/) 是面向企业和个人的一站式 AI 智能体平台，为 CowAgent 提供云端托管和企业级支持： +> +> - **🚀 免部署在线运行**：无需服务器即可创建 [CowAgent 在线助理](https://link-ai.tech/cowagent/create)，1 分钟拥有专属 Agent +> - **🧠 模型与技能支持**：聚合主流大模型与官方技能市场，为 CowAgent 提供更广的模型与技能扩展 +> - **🏢 企业级协作**：提供团队协作、权限分级、审计日志、私有化部署等能力，让 Agent 安全落地企业场景 + +**产品咨询和企业服务** 可联系产品客服： + + + +
+ +## ⚠️ 声明 + +1. 本项目遵循 [MIT 开源协议](/LICENSE)，主要用于技术研究和学习。使用时请遵守所在地法律法规及相关政策，因使用本项目所产生的一切后果由使用者自行承担。 +2. **成本与安全：** Agent 模式 Token 消耗显著高于普通对话，请根据效果与成本权衡选择模型；Agent 具备访问本地操作系统的能力，请谨慎选择部署环境。 +3. CowAgent 项目专注于开源技术开发，不会参与、授权或发行任何加密货币。 + +
+ +## 📌 项目更名说明 + +本项目原名 `chatgpt-on-wechat`，于 2026.04.13 正式更名为 **CowAgent**。原 GitHub 地址已自动重定向，老用户可选择执行 `git remote set-url origin https://github.com/zhayujie/CowAgent.git` 更新本地远程地址。