mirror of
https://github.com/zhayujie/chatgpt-on-wechat.git
synced 2026-03-12 18:01:30 +08:00
This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
CowAgent项目安装运行脚本
本文档介绍如何在Linux和Macos系统使用 run.sh 脚本部署和管理 CowAgent 项目，Windows系统请参考快速开始进行安装。
目录
前置要求
在使用脚本前，请确保系统已安装：
- Python 3.7及以上版本：脚本会检测 Python 版本是否符合要求，但不会自动安装
推荐使用``Ubuntu 22.04` 系统
快速开始
方式一：远程一键安装
bash <(curl -sS https://cdn.link-ai.tech/code/cow/run.sh)
脚本自动执行流程：
- 检查 Python 环境（需要 Python 3.7+）
- 安装必要工具（git、curl 等）
- 克隆项目代码到
~/chatgpt-on-wechat - 安装 Python 依赖
- 引导配置 AI 模型和通信渠道
- 启动服务
方式二：项目内使用
如果已经克隆了项目：
cd chatgpt-on-wechat # 进入项目根目录
chmod +x run.sh # 脚本给予执行权限
./run.sh # 开始配置模型和渠道
配置说明
AI 模型选择
脚本支持以下 AI 模型提供商：
1. Claude
- API Key：从 Claude 控制台 获取
- 默认模型：
claude-sonnet-4-5 - 可选模型：
claude-opus-4-0,claude-3-7-sonnet-latest等 - API Base：
https://api.anthropic.com/v1
2. Zhipu AI (智谱)
- API Key：从 智谱 AI 控制台 获取
- 默认模型：
glm-4.7 - 可选模型：
glm-4.6等
3. Gemini
- API Key：从 Google AI Studio 获取
- 默认模型：
gemini-3-flash-preview - 可选模型：
gemini-2.5-pro等 - API Base：
https://generativelanguage.googleapis.com
4. OpenAI GPT
- API Key：从 OpenAI 平台 获取
- 默认模型：
gpt-4.1 - 可选模型：
gpt-5.2,gpt-4.1等 - API Base：
https://api.openai.com/v1
5. Qwen (通义千问)
- API Key：从 阿里云百炼平台 获取 DashScope API Key
- 默认模型：
qwen3-max - 可选模型：
qwen-plus,qwq-plus等
6. MiniMax
- API Key：从 MiniMax 平台 获取
- 默认模型：
MiniMax-M2.1 - 可选模型：
MiniMax-M2.1-lightning等
7. LinkAI
- API Key：从 LinkAI 平台 获取
- 默认模型：
claude-sonnet-4-5 - 特点：
- 一个 API 接入多种模型（OpenAI、Claude、DeepSeek、Kimi、Qwen 等）
- 支持知识库、工作流、联网搜索、文档总结等 Agent 能力
- 无需配置多个 API Key
通道配置
脚本支持以下通信渠道：
1. Feishu (飞书)
所需参数：
- App ID：飞书应用 ID
- App Secret：飞书应用密钥
- Bot Name：机器人名称
获取方式：
- 访问 飞书开放平台
- 创建企业自建应用
- 在"凭证与基础信息"中获取参数
详细教程： 飞书接入文档
2. DingTalk (钉钉)
所需参数：
- Client ID：钉钉应用 Client ID
- Client Secret：钉钉应用密钥
获取方式：
- 访问 钉钉开发者后台
- 创建企业内部应用
- 获取 Client ID 和 Client Secret
详细教程： 钉钉接入文档
3. WeCom (企微应用)
所需参数：
- Corp ID：企业微信企业 ID
- App Token：应用 Token
- App Secret：应用密钥
- Agent ID：应用 Agent ID
- AES Key：消息加密密钥
- Port：服务端口（默认 9898）
获取方式：
- 访问 企业微信管理后台
- 创建自建应用
- 在应用详情中获取相关参数
详细教程： 企微接入文档
4. Web (网页)
所需参数： 无
特点：
- 零配置，开箱即用
- 适合本地测试和开发
访问地址：
- 本地：
http://localhost:9899/chat - 服务器：
http://your-server-ip:9899/chat
注意：服务器部署需要在防火墙和安全组中开放 9899 端口
管理命令
配置完成后，可以使用以下命令管理服务：
命令格式
./run.sh <command>
可用命令
start - 启动服务
./run.sh start
启动 CowAgent 服务，进程在后台运行，终端关闭后服务继续运行。
stop - 停止服务
./run.sh stop
停止 CowAgent 服务并清理后台进程。
restart - 重启服务
./run.sh restart
停止并重新启动服务，适用于更新配置后重新加载。
status - 查看状态
./run.sh status
查看服务运行状态，包括进程 PID、运行时长等信息。
logs - 查看日志
./run.sh logs
实时查看服务日志，按 Ctrl+C 退出（不影响服务运行）。
config - 重新配置
./run.sh config
备份当前配置并重新执行配置向导，旧配置会保存为 config.json.backup。
update - 更新项目
./run.sh update
从 Git 仓库拉取最新代码并自动重启服务。
help - 查看帮助
./run.sh help
显示使用说明和所有可用命令。
常见问题
1. 如何修改配置？
方法一：使用 config 命令
./run.sh config
方法二：手动编辑
vi config.json # 自行学习vi命令使用方法
./run.sh restart
2. 如何切换 AI 模型？
编辑 config.json，修改模型相关字段后重启服务：
./run.sh restart
3. 如何切换通信渠道？
编辑 config.json，修改 channel_type 以及对应的渠道参数字段：
{
"channel_type": "feishu" // 可选: feishu, dingtalk, wechatcom_app, web
}
4. Python 版本不符合要求怎么办？
脚本要求 Python 3.7+，请手动安装：
# Ubuntu/Debian
sudo apt update && sudo apt install python3.9 python3.9-pip
# CentOS/RHEL
sudo yum install python39 python39-pip
# macOS
brew install python@3.9
5. 依赖安装失败怎么办？
脚本默认使用清华源，如仍失败可手动安装：
pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
6. 脚本执行权限问题
chmod +x run.sh
./run.sh
或直接使用 bash 执行：
bash run.sh
7. Web 页面无法访问
检查：
- 服务是否运行：
./run.sh status - 端口是否开放：检查防火墙和安全组规则
- 默认端口：9899
8. 如何查看详细错误日志？
# 查看实时日志
./run.sh logs
# 或查看完整日志文件
cat nohup.out
获取帮助
- 项目文档： https://docs.link-ai.tech/cow
- GitHub Issues： https://github.com/zhayujie/chatgpt-on-wechat/issues
- 常见问题： https://github.com/zhayujie/chatgpt-on-wechat/wiki/FAQs
感谢使用 CowAgent！