跳转到主要内容
项目提供了一键安装、配置、启动、管理程序的脚本，推荐使用脚本快速运行。 支持 Linux、macOS、Windows 操作系统，需安装 Python 3.7 ~ 3.13（推荐 3.9）。

​
安装命令

脚本自动执行以下流程：
  1. 检查 Python 环境（需要 Python 3.7+）
  2. 安装必要工具（git、curl 等）
  3. 克隆项目代码到 ~/CowAgent
  4. 安装 Python 依赖和 Cow CLI
  5. 引导配置 AI 模型和通信渠道
  6. 启动服务
运行后默认启动 Web 控制台，访问 http://localhost:9899 开始对话和管理Agent。
服务器部署需要公网访问控制台时，请在 config.json 中将 web_host 设为 0.0.0.0（默认仅监听 127.0.0.1 本机访问），同时强烈建议设置 web_password 启用鉴权。然后通过 http://<server-ip>:9899 访问，并确保防火墙/安全组放行 9899 端口。

​
管理命令

安装完成后，使用 cow CLI 管理服务： 更多命令和用法参考 命令文档。
如果 cow 命令不可用，也可以使用 ./run.sh <命令>（Linux/macOS）或 .\scripts\run.ps1 <命令>（Windows）作为替代，功能等效。