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

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

🌐 官网  ·  📖 文档中心  ·  🚀 快速开始  ·  ☁️ 在线体验

简介

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

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

声明

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

演示

• 使用说明( Agent 模式)：CowAgent 介绍

• 免部署在线体验：CowAgent

• DEMO 视频(对话模式)：https://cdn.link-ai.tech/doc/cow_demo.mp4

社区

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

企业服务

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

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

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

🏷 更新日志

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

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

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

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

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

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

🚀 快速开始

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

在终端执行以下命令：

Linux / macOS：

bash <(curl -fsSL https://cdn.link-ai.tech/code/cow/run.sh)

Windows（PowerShell）：

irm https://cdn.link-ai.tech/code/cow/run.ps1 | iex

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

一、准备

1. 模型API

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

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

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

2.环境安装

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

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

(1) 克隆项目代码：

git clone https://github.com/zhayujie/chatgpt-on-wechat
cd chatgpt-on-wechat/

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

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

pip3 install -r requirements.txt

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

pip3 install -r requirements-optional.txt

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

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

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

pip3 install -e .

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

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

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

cow install-browser

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

二、配置

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

  cp config-template.json config.json

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

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

配置补充说明:

1. 语音配置

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

2. 其他配置

• model: 模型名称，Agent 模式下推荐使用 MiniMax-M2.7、glm-5-turbo、kimi-k2.5、qwen3.5-plus、claude-sonnet-4-6、gemini-3.1-pro-preview，全部模型名称参考common/const.py文件
• character_desc：普通对话模式下的机器人系统提示词。在 Agent 模式下该配置不生效，由工作空间中的文件内容构成。
• subscribe_msg：订阅消息，公众号和企业微信 channel 中请填写，当被订阅时会自动回复， 可使用特殊占位符。目前支持的占位符有{trigger_prefix}，在程序中它会自动替换成 bot 的触发词。

3. LinkAI 配置

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

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

三、运行

1.本地运行

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

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

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

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

2.服务器部署

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

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

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

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

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

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

3.Docker部署

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

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

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

curl -O https://cdn.link-ai.tech/code/cow/docker-compose.yml

下载完成后打开 docker-compose.yml 填写所需配置，例如 CHANNEL_TYPE、OPEN_AI_API_KEY 和等配置。

(2) 启动容器

在 docker-compose.yml 所在目录下执行以下命令启动容器：

sudo docker compose up -d         # 若docker-compose为 1.X 版本，则执行 `sudo  docker-compose up -d`

运行命令后，会自动取 docker hub 拉取最新 release 版本的镜像。当执行 sudo docker ps 能查看到 NAMES 为 chatgpt-on-wechat 的容器即表示运行成功。最后执行以下命令可查看容器的运行日志：

sudo docker logs -f chatgpt-on-wechat

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

模型说明

以下对所有可支持的模型的配置和使用方法进行说明，模型接口实现在项目的 models/ 目录下。

OpenAI

1. API Key 创建：在 OpenAI平台 创建 API Key

2. 填写配置

{
    "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参数 一致，支持包括 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

LinkAI

1. API Key 创建：在 LinkAI平台 创建 API Key

2. 填写配置

{
    "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，可在 控制台 中创建
• model: 模型列表中的全部模型均可使用

MiniMax

方式一：官方接入，配置如下(推荐)：

{
    "model": "MiniMax-M2.7",
    "minimax_api_key": ""
}

• model: 可填写 MiniMax-M2.7、MiniMax-M2.5、MiniMax-M2.1、MiniMax-M2.1-lightning、MiniMax-M2、abab6.5-chat 等
• minimax_api_key：MiniMax 平台的 API-KEY，在 控制台 创建

方式二：OpenAI 兼容方式接入，配置如下：

{
  "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.5、MiniMax-M2.1、MiniMax-M2.1-lightning、MiniMax-M2，参考API文档
• open_ai_api_base: MiniMax 平台 API 的 BASE URL
• open_ai_api_key: MiniMax 平台的 API-KEY

智谱AI (GLM)

方式一：官方接入，配置如下(推荐)：

{
  "model": "glm-5-turbo",
  "zhipu_ai_api_key": ""
}

• model: 可填 glm-5-turbo、glm-5、glm-4.7、glm-4-plus、glm-4-flash、glm-4-air、glm-4-airx、glm-4-long 等, 参考 glm 系列模型编码
• zhipu_ai_api_key: 智谱AI 平台的 API KEY，在 控制台 创建

方式二：OpenAI 兼容方式接入，配置如下：

{
  "bot_type": "openai",
  "model": "glm-5-turbo",
  "open_ai_api_base": "https://open.bigmodel.cn/api/paas/v4",
  "open_ai_api_key": ""
}

• bot_type: OpenAI 兼容方式
• model: 可填 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 接入，配置如下(推荐)：

{
    "model": "qwen3.5-plus",
    "dashscope_api_key": "sk-qVxxxxG"
}

• model: 可填写 qwen3.5-plus、qwen3-max、qwen-max、qwen-plus、qwen-turbo、qwen-long、qwq-plus 等
• dashscope_api_key: 通义千问的 API-KEY，参考 官方文档 ，在 控制台 创建

方式二：OpenAI 兼容方式接入，配置如下：

{
  "bot_type": "openai",
  "model": "qwen3.5-plus",
  "open_ai_api_base": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "open_ai_api_key": "sk-qVxxxxG"
}

• bot_type: OpenAI 兼容方式
• model: 支持官方所有模型，参考模型列表
• open_ai_api_base: 通义千问 API 的 BASE URL
• open_ai_api_key: 通义千问的 API-KEY

Kimi (Moonshot)

方式一：官方接入，配置如下：

{
    "model": "kimi-k2.5",
    "moonshot_api_key": ""
}

• model: 可填写 kimi-k2.5、kimi-k2、moonshot-v1-8k、moonshot-v1-32k、moonshot-v1-128k
• moonshot_api_key: Moonshot 的 API-KEY，在 控制台 创建

方式二：OpenAI 兼容方式接入，配置如下：

{
  "bot_type": "openai",
  "model": "kimi-k2.5",
  "open_ai_api_base": "https://api.moonshot.cn/v1",
  "open_ai_api_key": ""
}

• bot_type: OpenAI 兼容方式
• model: 可填写 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

豆包 (Doubao)

1. API Key 创建：在 火山方舟控制台 创建API Key

2. 填写配置

{
    "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，在 控制台 创建
• ark_base_url: 可选，默认为 https://ark.cn-beijing.volces.com/api/v3

Claude

1. API Key 创建：在 Claude控制台 创建 API Key

2. 填写配置

{
    "model": "claude-sonnet-4-6",
    "claude_api_key": "YOUR_API_KEY"
}

• model: 参考 官方模型ID ，支持 claude-sonnet-4-6、claude-opus-4-6、claude-sonnet-4-5、claude-sonnet-4-0、claude-opus-4-0、claude-3-5-sonnet-latest 等

Gemini

API Key 创建：在 控制台 创建 API Key ，配置如下

{
    "model": "gemini-3.1-flash-lite-preview",
    "gemini_api_key": ""
}

• model: 参考官方文档-模型列表，支持 gemini-3.1-flash-lite-preview、gemini-3.1-pro-preview、gemini-3-flash-preview、gemini-3-pro-preview 等

DeepSeek

1. API Key 创建：在 DeepSeek 平台 创建 API Key

2. 填写配置

方式一：官方接入（推荐）：

{
    "model": "deepseek-chat",
    "deepseek_api_key": "sk-xxxxxxxxxxx"
}

• model: 可填 deepseek-chat、deepseek-reasoner，分别对应的是 DeepSeek-V3.2（非思考模式）和 DeepSeek-R1（思考模式）
• deepseek_api_key: DeepSeek 平台的 API Key
• deepseek_api_base: 可选，默认为 https://api.deepseek.com/v1，可修改为第三方代理地址

方式二：OpenAI 兼容方式接入：

{
    "model": "deepseek-chat",
    "bot_type": "openai",
    "open_ai_api_key": "sk-xxxxxxxxxxx",
    "open_ai_api_base": "https://api.deepseek.com/v1"
}

Azure

1. API Key 创建：在 Azure平台 创建 API Key

2. 填写配置

{
  "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 版本以及以上参数可以在部署的 模型配置 界面查看

百度文心 方式一：官方 SDK 接入，配置如下：

{
    "model": "wenxin-4", 
    "baidu_wenxin_api_key": "IajztZ0bDxgnP9bEykU7lBer",
    "baidu_wenxin_secret_key": "EDPZn6L24uAS9d8RWFfotK47dPvkjD6G"
}

• model: 可填 wenxin和wenxin-4，对应模型为 文心-3.5 和 文心-4.0
• baidu_wenxin_api_key：参考 千帆平台-access_token鉴权 文档获取 API Key
• baidu_wenxin_secret_key：参考 千帆平台-access_token鉴权 文档获取 Secret Key

方式二：OpenAI 兼容方式接入，配置如下：

{
  "bot_type": "openai",
  "model": "ERNIE-4.0-Turbo-8K",
  "open_ai_api_base": "https://qianfan.baidubce.com/v2",
  "open_ai_api_key": "bce-v3/ALTxxxxxxd2b"
}

• bot_type: OpenAI 兼容方式
• model: 支持官方所有模型，参考模型列表
• open_ai_api_base: 百度文心 API 的 BASE URL
• open_ai_api_key: 百度文心的 API-KEY，参考 官方文档 ，在 控制台 创建 API Key

讯飞星火

方式一：官方接入，配置如下：
参考 官方文档-快速指引 获取 APPID、 APISecret、 APIKey 三个参数

{
  "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: 填写参考 官方文档-请求地址 的说明

方式二：OpenAI 兼容方式接入，配置如下：

{
  "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 ，因模型而已

ModelScope

{
  "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: 参考模型列表
• modelscope_api_key: 参考 官方文档-访问令牌 ，在 控制台
• modelscope_base_url: modelscope 平台的 BASE URL
• text_to_image: 图像生成模型，参考模型列表

Coding Plan

Coding Plan 是各厂商推出的编程包月套餐，所有厂商均可通过 OpenAI 兼容方式接入：

{
  "bot_type": "openai",
  "model": "模型名称",
  "open_ai_api_base": "厂商 Coding Plan API Base",
  "open_ai_api_key": "YOUR_API_KEY"
}

目前支持阿里云、MiniMax、智谱 GLM、Kimi、火山引擎等厂商，各厂商详细配置请参考 Coding Plan 文档。

通道说明

以下对可接入通道的配置方式进行说明，应用通道代码在项目的 channel/ 目录下。

支持同时可接入多个通道，配置时可通过逗号进行分割，例如 "channel_type": "feishu,dingtalk"。

1. Weixin - 微信

接入个人微信，扫码登录即可使用，支持文本、图片、语音、文件等消息收发。

{
    "channel_type": "weixin"
}

启动后终端会显示二维码，使用微信扫码授权即可，也可以在 Web 控制台的「通道」页面中扫码接入。登录凭证会自动保存至 ~/.weixin_cow_credentials.json，下次启动无需重新扫码，如需重新登录删除该文件后重启即可。

详细步骤和参数说明参考 微信接入

2. Web

项目启动后会默认运行 Web 控制台，配置如下：

{
    "channel_type": "web",
    "web_port": 9899
}

• web_port: 默认为 9899，可按需更改，需要服务器防火墙和安全组放行该端口
• 如本地运行，启动后请访问 http://localhost:9899/chat ；如服务器运行，请访问 http://ip:9899/chat

注：请将上述 url 中的 ip 或者 port 替换为实际的值

3. Feishu - 飞书

飞书支持两种事件接收模式：WebSocket 长连接（推荐）和 Webhook。

方式一：WebSocket 模式（推荐，无需公网 IP）

{
    "channel_type": "feishu",
    "feishu_app_id": "APP_ID",
    "feishu_app_secret": "APP_SECRET",
    "feishu_event_mode": "websocket"
}

方式二：Webhook 模式（需要公网 IP）

{
    "channel_type": "feishu",
    "feishu_app_id": "APP_ID",
    "feishu_app_secret": "APP_SECRET",
    "feishu_token": "VERIFICATION_TOKEN",
    "feishu_event_mode": "webhook",
    "feishu_port": 9891
}

• feishu_event_mode: 事件接收模式，websocket（推荐）或 webhook
• WebSocket 模式需安装依赖：pip3 install lark-oapi

详细步骤和参数说明参考 飞书接入

4. DingTalk - 钉钉

钉钉需要在开放平台创建智能机器人应用，将以下配置填入 config.json：

{
    "channel_type": "dingtalk",
    "dingtalk_client_id": "CLIENT_ID",
    "dingtalk_client_secret": "CLIENT_SECRET"
}

详细步骤和参数说明参考 钉钉接入

5. WeCom Bot - 企微智能机器人

企微智能机器人使用 WebSocket 长连接模式，无需公网 IP 和域名，配置简单：

{
    "channel_type": "wecom_bot",
    "wecom_bot_id": "YOUR_BOT_ID",
    "wecom_bot_secret": "YOUR_SECRET"
}

详细步骤和参数说明参考 企微智能机器人接入

6. QQ - QQ 机器人

QQ 机器人使用 WebSocket 长连接模式，无需公网 IP 和域名，支持 QQ 单聊、群聊和频道消息：

{
    "channel_type": "qq",
    "qq_app_id": "YOUR_APP_ID",
    "qq_app_secret": "YOUR_APP_SECRET"
}

详细步骤和参数说明参考 QQ 机器人接入

7. WeCom App - 企业微信应用

企业微信自建应用接入需在后台创建应用并启用消息回调，配置示例：

{
    "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"
}

详细步骤和参数说明参考 企微自建应用接入

8. WeChat MP - 微信公众号

本项目支持订阅号和服务号两种公众号，通过服务号（wechatmp_service）体验更佳。

个人订阅号（wechatmp）

{
    "channel_type": "wechatmp",
    "wechatmp_token": "TOKEN",
    "wechatmp_port": 80,
    "wechatmp_app_id": "APPID",
    "wechatmp_app_secret": "APPSECRET",
    "wechatmp_aes_key": ""
}

企业服务号（wechatmp_service）

{
    "channel_type": "wechatmp_service",
    "wechatmp_token": "TOKEN",
    "wechatmp_port": 80,
    "wechatmp_app_id": "APPID",
    "wechatmp_app_secret": "APPSECRET",
    "wechatmp_aes_key": ""
}

详细步骤和参数说明参考 微信公众号接入

9. Terminal - 终端

修改 config.json 中的 channel_type 字段：

{
    "channel_type": "terminal"
}

运行后可在终端与机器人进行对话。

🔗 相关项目

• bot-on-anything：轻量和高可扩展的大模型应用框架，支持接入 Slack, Telegram, Discord, Gmail 等海外平台，可作为本项目的补充使用。
• AgentMesh：开源的多智能体( Multi-Agent )框架，可以通过多智能体团队的协同来解决复杂问题。本项目基于该框架实现了Agent 插件，可访问终端、浏览器、文件系统、搜索引擎 等各类工具，并实现了多智能体协同。

🔎 常见问题

FAQs： https://github.com/zhayujie/chatgpt-on-wechat/wiki/FAQs

或直接在线咨询 项目小助手 (知识库持续完善中，回复供参考)

🛠️ 开发

欢迎接入更多应用通道，参考 飞书通道 新增自定义通道，实现接收和发送消息逻辑即可完成接入。同时欢迎贡献新的 Skills，参考 技能创建文档。

✉ 联系

欢迎提交PR、Issues进行反馈，以及通过 🌟Star 支持并关注项目更新。项目运行遇到问题可以查看 常见问题列表 ，以及前往 Issues 中搜索。个人开发者可加入开源交流群参与更多讨论，企业用户可联系产品客服咨询。

🌟 贡献者