{"id":49130590,"url":"https://github.com/zhayujie/cowagent","last_synced_at":"2026-05-22T06:16:34.844Z","repository":{"id":64976227,"uuid":"522158088","full_name":"zhayujie/CowAgent","owner":"zhayujie","description":"CowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。","archived":false,"fork":false,"pushed_at":"2026-05-03T14:29:17.000Z","size":6960,"stargazers_count":43985,"open_issues_count":356,"forks_count":10037,"subscribers_count":298,"default_branch":"master","last_synced_at":"2026-05-03T15:07:59.782Z","etag":null,"topics":["ai","ai-agent","chatgpt-on-wechat","claude","deepseek","dingtalk","feishu-bot","gemini","kimi","linkai","llm","mcp","multi-agent","openai","openclaw","python3","qwen","skills","wechat","weixin"],"latest_commit_sha":null,"homepage":"https://cowagent.ai","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhayujie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-08-07T08:33:41.000Z","updated_at":"2026-05-03T15:07:10.000Z","dependencies_parsed_at":"2023-10-16T18:42:24.506Z","dependency_job_id":"afd0d7e9-6e21-4760-b97e-b12ee3c2b384","html_url":"https://github.com/zhayujie/CowAgent","commit_stats":null,"previous_names":["zhayujie/cowagent"],"tags_count":85,"template":false,"template_full_name":null,"purl":"pkg:github/zhayujie/CowAgent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhayujie%2FCowAgent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhayujie%2FCowAgent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhayujie%2FCowAgent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhayujie%2FCowAgent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhayujie","download_url":"https://codeload.github.com/zhayujie/CowAgent/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhayujie%2FCowAgent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32760962,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-07T02:14:30.463Z","status":"ssl_error","status_checked_at":"2026-05-07T02:14:29.405Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agent","chatgpt-on-wechat","claude","deepseek","dingtalk","feishu-bot","gemini","kimi","linkai","llm","mcp","multi-agent","openai","openclaw","python3","qwen","skills","wechat","weixin"],"created_at":"2026-04-21T18:00:42.295Z","updated_at":"2026-05-08T00:02:03.902Z","avatar_url":"https://github.com/zhayujie.png","language":"Python","funding_links":[],"categories":["NLP"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src= \"https://github.com/user-attachments/assets/eca9a9ec-8534-4615-9e0f-96c5ac1d10a3\" alt=\"CowAgent\" width=\"550\" /\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/zhayujie/CowAgent/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/zhayujie/CowAgent\" alt=\"Latest release\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/zhayujie/CowAgent/blob/master/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/zhayujie/CowAgent\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/zhayujie/CowAgent\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/zhayujie/CowAgent?style=flat-square\" alt=\"Stars\"\u003e\u003c/a\u003e \u003cbr/\u003e\n  [中文] | [\u003ca href=\"docs/en/README.md\"\u003eEnglish\u003c/a\u003e] | [\u003ca href=\"docs/ja/README.md\"\u003e日本語\u003c/a\u003e]\n\u003c/p\u003e\n\n**CowAgent** 是基于大模型的超级 AI 助理，能够主动思考和任务规划、操作计算机和外部资源、创造和执行 Skills、拥有长期记忆和知识库并不断成长，比 OpenClaw 更轻量和便捷。CowAgent 支持灵活切换多种模型，能处理文本、语音、图片、文件等多模态消息，可接入微信、飞书、钉钉、企微智能机器人、QQ、企微自建应用、微信公众号、网页中使用，7*24小时运行于你的个人电脑或服务器中。\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://cowagent.ai/\"\u003e🌐 官网\u003c/a\u003e \u0026nbsp;·\u0026nbsp;\n  \u003ca href=\"https://docs.cowagent.ai/\"\u003e📖 文档中心\u003c/a\u003e \u0026nbsp;·\u0026nbsp;\n  \u003ca href=\"https://docs.cowagent.ai/guide/quick-start\"\u003e🚀 快速开始\u003c/a\u003e \u0026nbsp;·\u0026nbsp;\n  \u003ca href=\"https://skills.cowagent.ai/\"\u003e🧩 技能广场\u003c/a\u003e \u0026nbsp;·\u0026nbsp;\n  \u003ca href=\"https://link-ai.tech/cowagent/create\"\u003e☁️ 在线体验\u003c/a\u003e\n\u003c/p\u003e\n\n\n# 简介\n\n\u003e 该项目既是一个可以开箱即用的超级 AI 助理，也是一个支持高扩展的 Agent 框架，可以通过为项目扩展大模型接口、接入渠道、内置工具、Skills 系统来灵活实现各种定制需求。核心能力如下：\n\n-  ✅  **自主任务规划**：能够理解复杂任务并自主规划执行，持续思考和调用工具直到完成目标\n-  ✅  **长期记忆：** 自动将对话记忆持久化至本地文件和数据库中，包括核心记忆、日级记忆和梦境蒸馏，支持关键词及向量检索\n-  ✅  **个人知识库：** 自动整理结构化知识，通过交叉引用构建知识图谱，支持通过对话管理和可视化浏览知识库\n-  ✅  **技能系统：** Skills 安装和运行的引擎，支持从 [Skill Hub](https://skills.cowagent.ai/)、GitHub 等一键安装技能，或通过对话创造 Skills\n-  ✅  **工具系统：** 内置文件读写、终端执行、浏览器操作、定时任务等工具，Agent 自主调用以完成复杂任务\n-  ✅  **CLI系统：** 提供终端命令和对话命令，支持进程管理、技能安装、配置修改等操作\n-  ✅  **多模态消息：** 支持对文本、图片、语音、文件等多类型消息进行解析、处理、生成、发送等操作\n-  ✅  **多模型支持：** 支持 DeepSeek、MiniMax、Claude、Gemini、OpenAI、GLM、Qwen、Doubao、Kimi 等国内外主流模型厂商\n-  ✅  **多通道接入：** 支持运行在本地计算机或服务器，可集成到微信、飞书、钉钉、企业微信、QQ、微信公众号、网页中使用\n\n## 声明\n\n1. 本项目遵循 [MIT 开源协议](/LICENSE)，主要用于技术研究和学习，使用本项目时需遵守所在地法律法规、相关政策以及企业章程，禁止用于任何违法或侵犯他人权益的行为。任何个人、团队和企业，无论以何种方式使用该项目、对何对象提供服务，所产生的一切后果，本项目均不承担任何责任。\n2. 成本与安全：Agent 模式下 Token 使用量高于普通对话模式，请根据效果及成本综合选择模型。Agent 具有访问所在操作系统的能力，请谨慎选择项目部署环境。同时项目也会持续升级安全机制、并降低模型消耗成本。\n3. CowAgent 项目专注于开源技术开发，不会参与、授权或发行任何加密货币。\n\n## 演示\n\n- 使用说明( Agent 模式)：[CowAgent 介绍](https://docs.cowagent.ai/intro/features)\n\n- 免部署在线体验：[CowAgent](https://link-ai.tech/cowagent/create)\n\n- DEMO 视频(对话模式)：https://cdn.link-ai.tech/doc/cow_demo.mp4\n\n## 社区\n\n添加小助手微信加入开源项目交流群：\n\n\u003cimg width=\"140\" src=\"https://img-1317903499.cos.ap-guangzhou.myqcloud.com/docs/open-community.png\"\u003e\n\n\u003cbr/\u003e\n\n# 企业服务\n\n\u003ca href=\"https://link-ai.tech\" target=\"_blank\"\u003e\u003cimg width=\"650\" src=\"https://cdn.link-ai.tech/image/link-ai-intro.jpg\"\u003e\u003c/a\u003e\n\n\u003e [LinkAI](https://link-ai.tech/) 是面向企业和个人的一站式 AI 智能体平台，聚合多模态大模型、知识库、技能、工作流等能力，支持一键接入主流平台并管理，支持 SaaS、私有化部署等多种模式，可免部署在线运行[CowAgent 助理](https://link-ai.tech/cowagent/create)。\n\u003e\n\u003e LinkAI 目前已在智能客服、私域运营、企业效率助手等场景积累了丰富的 AI 解决方案，在消费、健康、文教、科技制造等各行业沉淀了大模型落地应用的最佳实践，致力于帮助更多企业和开发者拥抱 AI 生产力。\n\n**产品咨询和企业服务** 可联系产品客服：\n\n\u003cimg width=\"150\" src=\"https://cdn.link-ai.tech/portal/linkai-customer-service.png\"\u003e\n\n\u003cbr/\u003e\n\n# 🏷 更新日志\n\n\u003e**2026.05.06：** [2.0.8版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.8)，飞书渠道全面升级（语音、流式输出和Markdown、一键扫码接入）、新模型支持（DeepSeek V4、百度千帆）、定时任务工具增强等\n\n\u003e**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 控制台优化\n\n\u003e**2026.04.14：** [2.0.6版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.6)，知识库系统、梦境记忆模块、上下文智能压缩、Web 控制台多会话及多项优化。\n\n\u003e**2026.04.01：** [2.0.5版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.5)，Cow CLI 命令系统、Skill Hub 开源、浏览器工具、企微扫码创建、多项优化和修复。\n\n\u003e**2026.03.22：** [2.0.4版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.4)，新增个人微信通道（微信扫码即用）、新增 MiniMax-M2.7 和 GLM-5-Turbo 模型、run.sh 脚本重构、日文文档及多项修复。\n\n\u003e**2026.03.18：** [2.0.3版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.3)，新增企微智能机器人和 QQ 通道、支持 Coding Plan、新增多个模型、Web 端文件处理、记忆系统升级。\n\n\u003e**2026.02.27：** [2.0.2版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.2)，Web 控制台全面升级（流式对话、模型/技能/记忆/通道/定时任务/日志管理）、支持多通道同时运行、会话持久化存储、新增多个模型。\n\n\u003e**2026.02.13：** [2.0.1版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.1)，内置 Web Search 工具、智能上下文裁剪策略、运行时信息动态更新、Windows 兼容性适配，修复定时任务记忆丢失、飞书连接等多项问题。\n\n\u003e**2026.02.03：** [2.0.0版本](https://github.com/zhayujie/CowAgent/releases/tag/2.0.0)，正式升级为超级 Agent 助理，支持多轮任务决策、具备长期记忆、实现多种系统工具、支持 Skills 框架，新增多种模型并优化了接入渠道。\n\n更多更新历史请查看: [更新日志](https://docs.cowagent.ai/releases)\n\n\u003cbr/\u003e\n\n# 🚀 快速开始\n\n项目提供了一键安装、配置、启动、管理程序的脚本，推荐使用脚本快速运行，也可以根据下文中的详细指引一步步安装运行。\n\n在终端执行以下命令：\n\n**Linux / macOS：**\n```bash\nbash \u003c(curl -fsSL https://cdn.link-ai.tech/code/cow/run.sh)\n```\n\n**Windows（PowerShell）：**\n```powershell\nirm https://cdn.link-ai.tech/code/cow/run.ps1 | iex\n```\n\n脚本使用说明：[一键运行脚本](https://docs.cowagent.ai/guide/quick-start)。安装后可使用 `cow start`、`cow stop` 等 [CLI 命令](https://docs.cowagent.ai/cli/index) 管理服务。\n\n\n## 一、准备\n\n### 1. 模型API\n\n项目支持国内外主流厂商的模型接口，可选模型及配置说明参考：[模型说明](#模型说明)。\n\n\u003e 注：Agent 模式下推荐使用以下模型，可根据效果及成本综合选择：deepseek-v4-flash、MiniMax-M2.7、glm-5.1、kimi-k2.6、qwen3.5-plus、claude-sonnet-4-6、gemini-3.1-pro-preview、gpt-5.4、gpt-5.4-mini、ernie-5.0\n\n同时支持使用 **LinkAI 平台** 接口，支持上述全部模型，并支持知识库、工作流、插件等 Agent 技能，参考 [接口文档](https://docs.link-ai.tech/platform/api)。\n\n### 2.环境安装\n\n支持 Linux、MacOS、Windows 操作系统，可在个人计算机及服务器上运行，需安装 `Python`，Python 版本需在 3.7 ~ 3.13 之间。\n\n\u003e 注意：Agent 模式推荐使用源码运行，若选择 Docker 部署则无需安装 python 环境和下载源码，可直接快进到下一节。\n\n**(1) 克隆项目代码：**\n\n```bash\ngit clone https://github.com/zhayujie/CowAgent\ncd CowAgent/\n```\n\n若遇到网络问题可使用国内仓库地址：https://gitee.com/zhayujie/CowAgent\n\n**(2) 安装核心依赖 (必选)：**\n\n```bash\npip3 install -r requirements.txt\n```\n\n**(3) 拓展依赖 (可选，建议安装)：**\n\n```bash\npip3 install -r requirements-optional.txt\n```\n\n\u003e 国内网络可使用镜像源加速：`pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple`\n\n如果某项依赖安装失败可注释掉对应的行后重试。\n\n**(4) 安装 Cow CLI (推荐)：**\n\n```bash\npip3 install -e .\n```\n\n安装后可使用 `cow` 命令管理服务（启动、停止、更新等）和技能，详见 [命令文档](https://docs.cowagent.ai/cli/index)。\n\n**(5) 安装浏览器工具 (可选)：**\n\n如果需要 Agent 操作浏览器（如访问网页、填写表单等），需要额外安装浏览器依赖：\n\n```bash\ncow install-browser\n```\n\n该命令会自动安装 `playwright` 和 Chromium 浏览器，国内网络自动使用镜像加速。详见 [浏览器工具文档](https://docs.cowagent.ai/tools/browser)。\n\n## 二、配置\n\n配置文件的模板在根目录的 `config-template.json` 中，需复制该模板创建最终生效的 `config.json` 文件：\n\n```bash\n  cp config-template.json config.json\n```\n\n然后在 `config.json` 中填入配置，以下是对默认配置的说明，可根据需要进行自定义修改（注意实际使用时请去掉注释，保证 JSON 格式的规范）：\n\n```bash\n# config.json 文件内容示例\n{\n  \"channel_type\": \"weixin\",                                   # 接入渠道类型，默认为 weixin, 支持修改为 feishu,dingtalk,wecom_bot,qq,wechatcom_app,wechatmp_service,wechatmp,terminal\n  \"model\": \"deepseek-v4-flash\",                                # 模型名称\n  \"deepseek_api_key\": \"\",                                      # DeepSeek API Key\n  \"deepseek_api_base\": \"https://api.deepseek.com/v1\",         # DeepSeek API 地址\n  \"minimax_api_key\": \"\",                                      # MiniMax API Key\n  \"zhipu_ai_api_key\": \"\",                                     # 智谱 GLM API Key\n  \"moonshot_api_key\": \"\",                                     # Kimi/Moonshot API Key\n  \"ark_api_key\": \"\",                                          # 豆包(火山方舟) API Key\n  \"dashscope_api_key\": \"\",                                    # 百炼(通义千问) API Key\n  \"claude_api_key\": \"\",                                       # Claude API Key\n  \"claude_api_base\": \"https://api.anthropic.com/v1\",          # Claude API 地址，修改可接入三方代理平台\n  \"gemini_api_key\": \"\",                                       # Gemini API Key\n  \"gemini_api_base\": \"https://generativelanguage.googleapis.com\", # Gemini API 地址\n  \"open_ai_api_key\": \"\",                                      # OpenAI API Key\n  \"open_ai_api_base\": \"https://api.openai.com/v1\",            # OpenAI API 地址\n  \"linkai_api_key\": \"\",                                       # LinkAI API Key\n  \"proxy\": \"\",                                                # 代理客户端的 ip 和端口，国内环境需要开启代理的可填写该项，如 \"127.0.0.1:7890\"\n  \"speech_recognition\": false,                                # 是否开启语音识别\n  \"group_speech_recognition\": false,                          # 是否开启群组语音识别\n  \"voice_reply_voice\": false,                                 # 是否使用语音回复语音\n  \"use_linkai\": false,                                        # 是否使用 LinkAI 接口，默认关闭，设置为 true 后可对接 LinkAI 平台模型\n  \"web_password\": \"\",                                         # Web 控制台访问密码，留空则不启用密码保护\n  \"agent\": true,                                              # 是否启用 Agent 模式，启用后拥有多轮工具决策、长期记忆、Skills 能力等\n  \"agent_workspace\": \"~/cow\",                                 # Agent 的工作空间路径，用于存储 memory、skills、系统设定等\n  \"agent_max_context_tokens\": 50000,                          # Agent 模式下最大上下文 tokens，超出将自动智能压缩处理\n  \"agent_max_context_turns\": 20,                              # Agent 模式下最大上下文记忆轮次，一问一答为一轮，超出后智能压缩处理\n  \"agent_max_steps\": 20,                                      # Agent 模式下单次任务的最大决策步数，超出后将停止继续调用工具\n  \"enable_thinking\": false                                    # 是否启用深度思考模式\n}\n```\n\n**配置补充说明:** \n\n\u003cdetails\u003e\n\u003csummary\u003e1. 语音配置\u003c/summary\u003e\n\n+ 添加 `\"speech_recognition\": true` 将开启语音识别，默认使用 openai 的 whisper 模型识别为文字，同时以文字回复，该参数仅支持私聊 (注意由于语音消息无法匹配前缀，一旦开启将对所有语音自动回复，支持语音触发画图)；\n+ 添加 `\"group_speech_recognition\": true` 将开启群组语音识别，默认使用 openai 的 whisper 模型识别为文字，同时以文字回复，参数仅支持群聊 (会匹配 group_chat_prefix 和 group_chat_keyword, 支持语音触发画图)；\n+ 添加 `\"voice_reply_voice\": true` 将开启语音回复语音（同时作用于私聊和群聊）\n+ 使用 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`）\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e2. 其他配置\u003c/summary\u003e\n\n+ `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)文件\n+ `character_desc`：普通对话模式下的机器人系统提示词。在 Agent 模式下该配置不生效，由工作空间中的文件内容构成。\n+ `subscribe_msg`：订阅消息，公众号和企业微信 channel 中请填写，当被订阅时会自动回复， 可使用特殊占位符。目前支持的占位符有{trigger_prefix}，在程序中它会自动替换成 bot 的触发词。\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e3. LinkAI 配置\u003c/summary\u003e\n\n+ `use_linkai`: 是否使用 LinkAI 接口，默认关闭，设置为 true 后可对接 LinkAI 平台，使用模型、知识库、工作流、插件等技能, 参考[接口文档](https://docs.link-ai.tech/platform/api/chat)\n+ `linkai_api_key`: LinkAI Api Key，可在 [控制台](https://link-ai.tech/console/interface) 创建\n\u003c/details\u003e\n\n注：全部配置项说明可在 [`config.py`](https://github.com/zhayujie/CowAgent/blob/master/config.py) 文件中查看。\n\n## 三、运行\n\n### 1.本地运行\n\n如果是个人计算机 **本地运行**，直接在项目根目录下执行：\n\n```bash\ncow start              # 推荐，需先安装 Cow CLI\npython3 app.py         # 或直接运行，windows 环境下该命令通常为 python app.py\n```\n\n运行后默认会启动 web 服务，可通过访问 `http://localhost:9899/chat` 在网页端对话。\n\n如果需要接入其他应用通道只需修改 `config.json` 配置文件中的 `channel_type` 参数，详情参考：[通道说明](#通道说明)。\n\n\n### 2.服务器部署\n\n推荐使用 `cow` 命令管理服务：\n\n```bash\ncow start              # 后台启动\ncow stop               # 停止服务\ncow restart            # 重启服务\ncow status             # 查看运行状态\ncow logs               # 查看日志\ncow update             # 拉取最新代码并重启\n```\n\n也可以使用传统方式后台运行：\n\n```bash\nnohup python3 app.py \u0026 tail -f nohup.out\n```\n\n此外，项目根目录下的 `run.sh` 脚本也支持一键管理服务，包括 `./run.sh start`、`./run.sh stop`、`./run.sh restart` 等命令，执行 `./run.sh help` 可查看全部用法。\n\n\u003e 如果需要通过浏览器访问 Web 控制台，请确保服务器的 `9899` 端口已在防火墙或安全组中放行，建议仅对指定 IP 开放以保证安全。\n\n### 3.Docker部署\n\n使用 docker 部署无需下载源码和安装依赖，只需要获取 `docker-compose.yml` 配置文件并启动容器即可。Agent 模式下更推荐使用源码进行部署，以获得更多系统访问能力。\n\n\u003e 前提是需要安装好 `docker` 及 `docker-compose`，安装成功后执行 `docker -v` 和 `docker-compose version` (或 `docker compose version`) 可查看到版本号。安装地址为 [docker官网](https://docs.docker.com/engine/install/) 。\n\n**(1) 下载 docker-compose.yml 文件**\n\n```bash\ncurl -O https://cdn.link-ai.tech/code/cow/docker-compose.yml\n```\n\n下载完成后打开 `docker-compose.yml` 填写所需配置，例如 `CHANNEL_TYPE`、`OPEN_AI_API_KEY` 和等配置。\n\n**(2) 启动容器**\n\n在 `docker-compose.yml` 所在目录下执行以下命令启动容器：\n\n```bash\nsudo docker compose up -d         # 若docker-compose为 1.X 版本，则执行 `sudo  docker-compose up -d`\n```\n\n运行命令后，会自动取 [docker hub](https://hub.docker.com/r/zhayujie/chatgpt-on-wechat) 拉取最新 release 版本的镜像。当执行 `sudo docker ps` 能查看到 NAMES 为 chatgpt-on-wechat 的容器即表示运行成功。最后执行以下命令可查看容器的运行日志：\n\n```bash\nsudo docker logs -f chatgpt-on-wechat\n```\n\n\u003e 如果需要通过浏览器访问 Web 控制台，请确保服务器的 `9899` 端口已在防火墙或安全组中放行，建议仅对指定 IP 开放以保证安全。\n\n## 模型说明\n\n推荐通过 Web 控制台在线管理模型配置，无需手动编辑文件，详见 [模型文档](https://docs.cowagent.ai/models)。以下是手动修改 `config.json` 配置模型的说明：\n\n\u003cdetails\u003e\n\u003csummary\u003eDeepSeek\u003c/summary\u003e\n\n1. API Key 创建：在 [DeepSeek 平台](https://platform.deepseek.com/api_keys) 创建 API Key\n\n2. 填写配置\n\n方式一：官方接入（推荐）：\n\n```json\n{\n    \"model\": \"deepseek-v4-flash\",\n    \"deepseek_api_key\": \"sk-xxxxxxxxxxx\"\n}\n```\n\n - `model`: 推荐填写 `deepseek-v4-flash`、`deepseek-v4-pro`\n - `deepseek_api_key`: DeepSeek 平台的 API Key\n - `deepseek_api_base`: 可选，默认为 `https://api.deepseek.com/v1`，可修改为第三方代理地址\n\n方式二：OpenAI 兼容方式接入：\n\n```json\n{\n    \"model\": \"deepseek-v4-flash\",\n    \"bot_type\": \"openai\",\n    \"open_ai_api_key\": \"sk-xxxxxxxxxxx\",\n    \"open_ai_api_base\": \"https://api.deepseek.com/v1\"\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eMiniMax\u003c/summary\u003e\n\n方式一：官方接入，配置如下(推荐)：\n\n```json\n{\n    \"model\": \"MiniMax-M2.7\",\n    \"minimax_api_key\": \"\"\n}\n```\n - `model`: 可填写 `MiniMax-M2.7、MiniMax-M2.7-highspeed、MiniMax-M2.5、MiniMax-M2.1、MiniMax-M2.1-lightning、MiniMax-M2、abab6.5-chat` 等\n - `minimax_api_key`：MiniMax 平台的 API-KEY，在 [控制台](https://platform.minimaxi.com/user-center/basic-information/interface-key) 创建\n\n方式二：OpenAI 兼容方式接入，配置如下：\n```json\n{\n  \"bot_type\": \"openai\",\n  \"model\": \"MiniMax-M2.7\",\n  \"open_ai_api_base\": \"https://api.minimaxi.com/v1\",\n  \"open_ai_api_key\": \"\"\n}\n```\n- `bot_type`: OpenAI 兼容方式\n- `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)\n- `open_ai_api_base`: MiniMax 平台 API 的 BASE URL\n- `open_ai_api_key`: MiniMax 平台的 API-KEY\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eClaude\u003c/summary\u003e\n\n1. API Key 创建：在 [Claude控制台](https://console.anthropic.com/settings/keys) 创建 API Key\n\n2. 填写配置\n\n```json\n{\n    \"model\": \"claude-sonnet-4-6\",\n    \"claude_api_key\": \"YOUR_API_KEY\"\n}\n```\n - `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` 等\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eGemini\u003c/summary\u003e\n\nAPI Key 创建：在 [控制台](https://aistudio.google.com/app/apikey?hl=zh-cn) 创建 API Key ，配置如下\n```json\n{\n    \"model\": \"gemini-3.1-flash-lite-preview\",\n    \"gemini_api_key\": \"\"\n}\n```\n - `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` 等\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eOpenAI\u003c/summary\u003e\n\n1. API Key 创建：在 [OpenAI平台](https://platform.openai.com/api-keys) 创建 API Key\n\n2. 填写配置\n\n```json\n{\n    \"model\": \"gpt-5.4\",\n    \"open_ai_api_key\": \"YOUR_API_KEY\",\n    \"open_ai_api_base\": \"https://api.openai.com/v1\",\n    \"bot_type\": \"openai\"\n}\n```\n\n - `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`\n - `open_ai_api_base`: 如果需要接入第三方代理接口，可通过修改该参数进行接入\n - `bot_type`: 使用 OpenAI 相关模型时无需填写。当使用第三方代理接口接入 Claude 等非 OpenAI 官方模型时，该参数设为 `openai`\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e智谱AI (GLM)\u003c/summary\u003e\n\n方式一：官方接入，配置如下(推荐)：\n\n```json\n{\n  \"model\": \"glm-5.1\",\n  \"zhipu_ai_api_key\": \"\"\n}\n```\n - `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)\n - `zhipu_ai_api_key`: 智谱AI 平台的 API KEY，在 [控制台](https://www.bigmodel.cn/usercenter/proj-mgmt/apikeys) 创建\n\n方式二：OpenAI 兼容方式接入，配置如下：\n```json\n{\n  \"bot_type\": \"openai\",\n  \"model\": \"glm-5.1\",\n  \"open_ai_api_base\": \"https://open.bigmodel.cn/api/paas/v4\",\n  \"open_ai_api_key\": \"\"\n}\n```\n- `bot_type`: OpenAI 兼容方式\n- `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` 等\n- `open_ai_api_base`: 智谱AI 平台的 BASE URL\n- `open_ai_api_key`: 智谱AI 平台的 API KEY\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e通义千问 (Qwen)\u003c/summary\u003e\n\n方式一：官方 SDK 接入，配置如下(推荐)：\n\n```json\n{\n    \"model\": \"qwen3.6-plus\",\n    \"dashscope_api_key\": \"sk-qVxxxxG\"\n}\n```\n - `model`: 可填写 `qwen3.6-plus、qwen3.5-plus、qwen3-max、qwen-max、qwen-plus、qwen-turbo、qwen-long、qwq-plus` 等\n - `dashscope_api_key`: 通义千问的 API-KEY，参考 [官方文档](https://bailian.console.aliyun.com/?tab=api#/api) ，在 [百炼控制台](https://bailian.console.aliyun.com/?tab=model#/api-key) 创建\n\n方式二：OpenAI 兼容方式接入，配置如下：\n```json\n{\n  \"bot_type\": \"openai\",\n  \"model\": \"qwen3.6-plus\",\n  \"open_ai_api_base\": \"https://dashscope.aliyuncs.com/compatible-mode/v1\",\n  \"open_ai_api_key\": \"sk-qVxxxxG\"\n}\n```\n- `bot_type`: OpenAI 兼容方式\n- `model`: 支持官方所有模型，参考[模型列表](https://help.aliyun.com/zh/model-studio/models?spm=a2c4g.11186623.0.0.78d84823Kth5on#9f8890ce29g5u)\n- `open_ai_api_base`: 通义千问 API 的 BASE URL\n- `open_ai_api_key`: 通义千问的 API-KEY\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e豆包 (Doubao)\u003c/summary\u003e\n\n1. API Key 创建：在 [火山方舟控制台](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) 创建API Key\n\n2. 填写配置\n\n```json\n{\n    \"model\": \"doubao-seed-2-0-code-preview-260215\",\n    \"ark_api_key\": \"YOUR_API_KEY\"\n}\n```\n - `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` 等\n - `ark_api_key`: 火山方舟平台的 API Key，在 [控制台](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) 创建\n - `ark_base_url`: 可选，默认为 `https://ark.cn-beijing.volces.com/api/v3`\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eKimi (Moonshot)\u003c/summary\u003e\n\n方式一：官方接入，配置如下：\n\n```json\n{\n    \"model\": \"kimi-k2.6\",\n    \"moonshot_api_key\": \"\"\n}\n```\n - `model`: 可填写 `kimi-k2.6、kimi-k2.5、kimi-k2、moonshot-v1-8k、moonshot-v1-32k、moonshot-v1-128k`\n - `moonshot_api_key`: Moonshot 的 API-KEY，在 [控制台](https://platform.moonshot.cn/console/api-keys) 创建\n\n方式二：OpenAI 兼容方式接入，配置如下：\n```json\n{\n  \"bot_type\": \"openai\",\n  \"model\": \"kimi-k2.6\",\n  \"open_ai_api_base\": \"https://api.moonshot.cn/v1\",\n  \"open_ai_api_key\": \"\"\n}\n```\n- `bot_type`: OpenAI 兼容方式\n- `model`: 可填写 `kimi-k2.6、kimi-k2.5、kimi-k2、moonshot-v1-8k、moonshot-v1-32k、moonshot-v1-128k`\n- `open_ai_api_base`: Moonshot 的 BASE URL\n- `open_ai_api_key`: Moonshot 的 API-KEY\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eModelScope\u003c/summary\u003e\n\n```json\n{\n  \"bot_type\": \"modelscope\",\n  \"model\": \"Qwen/QwQ-32B\",\n  \"modelscope_api_key\": \"your_api_key\",\n  \"modelscope_base_url\": \"https://api-inference.modelscope.cn/v1/chat/completions\",\n  \"text_to_image\": \"MusePublic/489_ckpt_FLUX_1\"\n}\n```\n\n- `bot_type`: modelscope 接口格式\n- `model`: 参考[模型列表](https://www.modelscope.cn/models?filter=inference_type\u0026page=1)\n- `modelscope_api_key`: 参考 [官方文档-访问令牌](https://modelscope.cn/docs/accounts/token) ，在 [控制台](https://modelscope.cn/my/myaccesstoken)\n- `modelscope_base_url`: modelscope 平台的 BASE URL\n- `text_to_image`: 图像生成模型，参考[模型列表](https://www.modelscope.cn/models?filter=inference_type\u0026page=1)\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eLinkAI\u003c/summary\u003e\n\n1. API Key 创建：在 [LinkAI平台](https://link-ai.tech/console/interface) 创建 API Key\n\n2. 填写配置\n\n```json\n{\n    \"model\": \"gpt-5.4-mini\",\n    \"use_linkai\": true,\n    \"linkai_api_key\": \"YOUR API KEY\"\n}\n```\n\n+ `use_linkai`: 是否使用 LinkAI 接口，默认关闭，设置为 true 后可对接 LinkAI 平台的模型，并使用知识库、工作流、数据库、插件等丰富的 Agent 技能\n+ `linkai_api_key`: LinkAI 平台的 API Key，可在 [控制台](https://link-ai.tech/console/interface) 中创建\n+ `model`: [模型列表](https://link-ai.tech/console/models)中的全部模型均可使用\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eAzure\u003c/summary\u003e\n\n1. API Key 创建：在 [Azure平台](https://oai.azure.com/) 创建 API Key \n\n2. 填写配置\n\n```json\n{\n  \"model\": \"\",\n  \"use_azure_chatgpt\": true,\n  \"open_ai_api_key\": \"\",\n  \"open_ai_api_base\": \"\",\n  \"azure_deployment_id\": \"\",\n  \"azure_api_version\": \"2025-01-01-preview\"\n}\n```\n\n - `model`: 留空即可\n - `use_azure_chatgpt`: 设为 true \n - `open_ai_api_key`: Azure 平台的密钥\n - `open_ai_api_base`: Azure 平台的 BASE URL\n - `azure_deployment_id`: Azure 平台部署的模型名称\n - `azure_api_version`: api 版本以及以上参数可以在部署的 [模型配置](https://oai.azure.com/resource/deployments) 界面查看\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e百度千帆 / ERNIE\u003c/summary\u003e\n\n方式一：官方接入（推荐），配置如下：\n\n```json\n{\n  \"model\": \"ernie-5.0\",\n  \"qianfan_api_key\": \"\",\n  \"qianfan_api_base\": \"https://qianfan.baidubce.com/v2\"\n}\n```\n\n - `model`: 默认推荐填写 `ernie-5.0`（多模态，可直接识图），也可填写 `ernie-x1.1`、`ernie-4.5-turbo-128k`、`ernie-4.5-turbo-32k`；当主模型为纯文本 ERNIE 时，Vision 工具会自动 fallback 到 `ernie-4.5-turbo-vl`\n - `qianfan_api_key`: 百度千帆 API Key，通常以 `bce-v3/` 开头，可在百度智能云控制台创建\n - `qianfan_api_base`: 可选，默认为 `https://qianfan.baidubce.com/v2`\n\n方式二：OpenAI 兼容方式接入，配置如下：\n```json\n{\n  \"bot_type\": \"openai\",\n  \"model\": \"ernie-5.0\",\n  \"open_ai_api_base\": \"https://qianfan.baidubce.com/v2\",\n  \"open_ai_api_key\": \"\"\n}\n```\n- `bot_type`: OpenAI 兼容方式\n- `model`: 支持千帆平台上的 ERNIE 模型\n- `open_ai_api_base`: 百度千帆 OpenAI 兼容 API 的 BASE URL\n- `open_ai_api_key`: 百度千帆 API Key\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e讯飞星火\u003c/summary\u003e\n\n方式一：官方接入，配置如下：\n参考 [官方文档-快速指引](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` 三个参数\n\n```json\n{\n  \"model\": \"xunfei\",\n  \"xunfei_app_id\": \"\",\n  \"xunfei_api_key\": \"\",\n  \"xunfei_api_secret\": \"\",\n  \"xunfei_domain\": \"4.0Ultra\",\n  \"xunfei_spark_url\": \"wss://spark-api.xf-yun.com/v4.0/chat\"\n}\n```\n - `model`: 填 `xunfei`\n - `xunfei_domain`: 可填写 `4.0Ultra、generalv3.5、max-32k、generalv3、pro-128k、lite`\n - `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) 的说明\n \n方式二：OpenAI 兼容方式接入，配置如下：\n```json\n{\n  \"bot_type\": \"openai\",\n  \"model\": \"4.0Ultra\",\n  \"open_ai_api_base\": \"https://spark-api-open.xf-yun.com/v1\",\n  \"open_ai_api_key\": \"\"\n}\n```\n- `bot_type`: OpenAI 兼容方式\n- `model`: 可填写 `4.0Ultra、generalv3.5、max-32k、generalv3、pro-128k、lite`\n- `open_ai_api_base`: 讯飞星火平台的 BASE URL\n- `open_ai_api_key`: 讯飞星火平台的[APIPassword](https://console.xfyun.cn/services/bm3) ，因模型而已\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eCoding Plan\u003c/summary\u003e\n\nCoding Plan 是各厂商推出的编程包月套餐，所有厂商均可通过 OpenAI 兼容方式接入：\n\n```json\n{\n  \"bot_type\": \"openai\",\n  \"model\": \"模型名称\",\n  \"open_ai_api_base\": \"厂商 Coding Plan API Base\",\n  \"open_ai_api_key\": \"YOUR_API_KEY\"\n}\n```\n\n目前支持阿里云、MiniMax、智谱 GLM、Kimi、火山引擎等厂商，各厂商详细配置请参考 [Coding Plan 文档](https://docs.cowagent.ai/models/coding-plan)。\n\u003c/details\u003e\n\n\n## 通道说明\n\n推荐通过 Web 控制台在线管理通道配置，无需手动编辑文件，详见 [通道文档](https://docs.cowagent.ai/channels/weixin)。以下为手动修改 `config.json` 配置通道的说明：\n\n支持同时可接入多个通道，配置时可通过逗号进行分割，例如 `\"channel_type\": \"feishu,dingtalk\"`。\n\n\u003cdetails\u003e\n\u003csummary\u003e1. Weixin - 微信\u003c/summary\u003e\n\n接入个人微信，扫码登录即可使用，支持文本、图片、语音、文件等消息收发。\n\n```json\n{\n    \"channel_type\": \"weixin\"\n}\n```\n\n启动后终端会显示二维码，使用微信扫码授权即可，也可以在 Web 控制台的「通道」页面中扫码接入。登录凭证会自动保存至 `~/.weixin_cow_credentials.json`，下次启动无需重新扫码，如需重新登录删除该文件后重启即可。\n\n详细步骤和参数说明参考 [微信接入](https://docs.cowagent.ai/channels/weixin)\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e2. Web\u003c/summary\u003e\n\n项目启动后会默认运行 Web 控制台，配置如下：\n\n```json\n{\n    \"channel_type\": \"web\",\n    \"web_port\": 9899\n}\n```\n\n- `web_port`: 默认为 9899，可按需更改，需要服务器防火墙和安全组放行该端口\n- `web_password`: 访问密码，留空则不启用密码保护。部署在公网环境时建议设置\n- 如本地运行，启动后请访问 `http://localhost:9899/chat` ；如服务器运行，请访问 `http://ip:9899/chat` \n\u003e 注：请将上述 url 中的 ip 或者 port 替换为实际的值\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e3. Feishu - 飞书\u003c/summary\u003e\n\n飞书使用 WebSocket 长连接模式，无需公网 IP。详细步骤参考 [飞书接入](https://docs.cowagent.ai/channels/feishu)。\n\n**方式一：扫码一键创建（推荐）**\n\n启动 Cow 后打开 Web 控制台，**通道** → **接入通道** → 选择 **飞书** → 扫码创建。也支持 CLI 启动时在终端打印二维码。\n\n**方式二：手动配置**\n\n在飞书开放平台创建自建应用并配置权限后，将凭据填入 `config.json`：\n\n```json\n{\n    \"channel_type\": \"feishu\",\n    \"feishu_app_id\": \"APP_ID\",\n    \"feishu_app_secret\": \"APP_SECRET\",\n    \"feishu_stream_reply\": true\n}\n```\n\n- `feishu_stream_reply`：是否开启流式打字机回复，默认开启（需 `cardkit:card:write` 权限 + 飞书客户端 ≥ 7.20）\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e4. DingTalk - 钉钉\u003c/summary\u003e\n\n钉钉需要在开放平台创建智能机器人应用，将以下配置填入 `config.json`：\n\n```json\n{\n    \"channel_type\": \"dingtalk\",\n    \"dingtalk_client_id\": \"CLIENT_ID\",\n    \"dingtalk_client_secret\": \"CLIENT_SECRET\"\n}\n```\n详细步骤和参数说明参考 [钉钉接入](https://docs.cowagent.ai/channels/dingtalk)\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e5. WeCom Bot - 企微智能机器人\u003c/summary\u003e\n\n企微智能机器人使用 WebSocket 长连接模式，无需公网 IP 和域名。详细步骤参考 [企微智能机器人接入](https://docs.cowagent.ai/channels/wecom-bot)。\n\n**方式一：扫码一键创建（推荐）**\n\n启动 Cow 后打开 Web 控制台，**通道** → **接入通道** → 选择 **企微智能机器人** → 使用企业微信扫码创建。\n\n**方式二：手动配置**\n\n在企业微信中创建智能机器人并选择**长连接模式**，记录 Bot ID 和 Secret 后填入 `config.json`：\n\n```json\n{\n    \"channel_type\": \"wecom_bot\",\n    \"wecom_bot_id\": \"YOUR_BOT_ID\",\n    \"wecom_bot_secret\": \"YOUR_SECRET\"\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e6. QQ - QQ 机器人\u003c/summary\u003e\n\nQQ 机器人使用 WebSocket 长连接模式，无需公网 IP 和域名，支持 QQ 单聊、群聊和频道消息：\n\n```json\n{\n    \"channel_type\": \"qq\",\n    \"qq_app_id\": \"YOUR_APP_ID\",\n    \"qq_app_secret\": \"YOUR_APP_SECRET\"\n}\n```\n详细步骤和参数说明参考 [QQ 机器人接入](https://docs.cowagent.ai/channels/qq)\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e7. WeCom App - 企业微信应用\u003c/summary\u003e\n\n企业微信自建应用接入需在后台创建应用并启用消息回调，配置示例：\n\n```json\n{\n    \"channel_type\": \"wechatcom_app\",\n    \"wechatcom_corp_id\": \"CORPID\",\n    \"wechatcomapp_token\": \"TOKEN\",\n    \"wechatcomapp_port\": 9898,\n    \"wechatcomapp_secret\": \"SECRET\",\n    \"wechatcomapp_agent_id\": \"AGENTID\",\n    \"wechatcomapp_aes_key\": \"AESKEY\"\n}\n```\n详细步骤和参数说明参考 [企微自建应用接入](https://docs.cowagent.ai/channels/wecom)\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e8. WeChat MP - 微信公众号\u003c/summary\u003e\n\n本项目支持订阅号和服务号两种公众号，通过服务号（`wechatmp_service`）体验更佳。\n\n**个人订阅号（wechatmp）**\n\n```json\n{\n    \"channel_type\": \"wechatmp\",\n    \"wechatmp_token\": \"TOKEN\",\n    \"wechatmp_port\": 80,\n    \"wechatmp_app_id\": \"APPID\",\n    \"wechatmp_app_secret\": \"APPSECRET\",\n    \"wechatmp_aes_key\": \"\"\n}\n```\n\n**企业服务号（wechatmp_service）**\n\n```json\n{\n    \"channel_type\": \"wechatmp_service\",\n    \"wechatmp_token\": \"TOKEN\",\n    \"wechatmp_port\": 80,\n    \"wechatmp_app_id\": \"APPID\",\n    \"wechatmp_app_secret\": \"APPSECRET\",\n    \"wechatmp_aes_key\": \"\"\n}\n```\n\n详细步骤和参数说明参考 [微信公众号接入](https://docs.cowagent.ai/channels/wechatmp)\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e9. Terminal - 终端\u003c/summary\u003e\n\n修改 `config.json` 中的 `channel_type` 字段：\n\n```json\n{\n    \"channel_type\": \"terminal\"\n}\n```\n\n运行后可在终端与机器人进行对话。\n\n\u003c/details\u003e\n\n\u003cbr/\u003e\n\n# 🔗 相关项目\n\n- [Cow Skill Hub](https://github.com/zhayujie/cow-skill-hub)：开源的 AI Agent 技能广场，浏览、搜索、安装和发布技能，支持 CowAgent、OpenClaw、Claude Code 等多种 Agent。\n- [bot-on-anything](https://github.com/zhayujie/bot-on-anything)：轻量和高可扩展的大模型应用框架，支持接入 Slack, Telegram, Discord, Gmail 等海外平台，可作为本项目的补充使用。\n- [AgentMesh](https://github.com/MinimalFuture/AgentMesh)：开源的多智能体( Multi-Agent )框架，可以通过多智能体团队的协同来解决复杂问题。\n\n\n\n\n# 🔎 常见问题\n\nFAQs： \u003chttps://github.com/zhayujie/CowAgent/wiki/FAQs\u003e\n\n或直接在线咨询 [项目小助手](https://link-ai.tech/app/Kv2fXJcH)  (知识库持续完善中，回复供参考)\n\n# 🛠️ 开发\n\n欢迎接入更多应用通道，参考 [飞书通道](https://github.com/zhayujie/CowAgent/blob/master/channel/feishu/feishu_channel.py) 新增自定义通道，实现接收和发送消息逻辑即可完成接入。同时欢迎贡献新的 Skills，向 [Skill Hub](https://skills.cowagent.ai/submit) 提交技能。\n\n# ✉ 联系\n\n欢迎提交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)咨询。\n\n# 🌟 贡献者\n\n![cow contributors](https://contrib.rocks/image?repo=zhayujie/CowAgent\u0026max=1000)\n\n# 📌 项目更名说明\n\n本项目原名 `chatgpt-on-wechat`（GitHub 原地址：https://github.com/zhayujie/chatgpt-on-wechat ），\n于 2026.04.13 正式更名为 **CowAgent**。GitHub 已自动设置重定向，原有链接仍可正常访问。\n\n如需更新本地仓库的远程地址（可选）：\n```bash\ngit remote set-url origin https://github.com/zhayujie/CowAgent.git\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhayujie%2Fcowagent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhayujie%2Fcowagent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhayujie%2Fcowagent/lists"}