Skip to content

CowAgentQuickStart

Jump to bottom
vision edited this page Feb 3, 2026 · 2 revisions

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)

脚本自动执行流程：

  1. 检查 Python 环境（需要 Python 3.7+）
  2. 安装必要工具（git、curl 等）
  3. 克隆项目代码到 ~/chatgpt-on-wechat
  4. 安装 Python 依赖
  5. 引导配置 AI 模型和通信渠道
  6. 启动服务

方式二：项目内使用

如果已经克隆了项目：

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 (智谱)

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：机器人名称

获取方式：

  1. 访问 飞书开放平台
  2. 创建企业自建应用
  3. 在"凭证与基础信息"中获取参数

详细教程： 飞书接入文档

2. DingTalk (钉钉)

所需参数：

  • Client ID：钉钉应用 Client ID
  • Client Secret：钉钉应用密钥

获取方式：

  1. 访问 钉钉开发者后台
  2. 创建企业内部应用
  3. 获取 Client ID 和 Client Secret

详细教程： 钉钉接入文档

3. WeCom (企微应用)

所需参数：

  • Corp ID：企业微信企业 ID
  • App Token：应用 Token
  • App Secret：应用密钥
  • Agent ID：应用 Agent ID
  • AES Key：消息加密密钥
  • Port：服务端口（默认 9898）

获取方式：

  1. 访问 企业微信管理后台
  2. 创建自建应用
  3. 在应用详情中获取相关参数

详细教程： 企微接入文档

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 页面无法访问

检查：

  1. 服务是否运行：./run.sh status
  2. 端口是否开放：检查防火墙和安全组规则
  3. 默认端口：9899

8. 如何查看详细错误日志？

# 查看实时日志
./run.sh logs

# 或查看完整日志文件
cat nohup.out

获取帮助

感谢使用 CowAgent！

Clone this wiki locally