CowAgent

环境要求

• Linux / macOS（使用 bash 安装脚本）或 Windows（使用 PowerShell 脚本）
• 能访问外网，可下载 https://cdn.link-ai.tech 上的安装脚本
• 本机端口 9899 未被占用（Web 控制台默认端口）
• 若用 Docker 方式部署，需先安装 Docker 与 docker compose
• 部署到服务器时需在防火墙/安全组放行 9899 端口

安装与启动步骤

1. 1一键安装（Linux/mac）

   在终端执行官方一行安装脚本，脚本会自动处理依赖、配置与启动，无需手动装 Python 包。

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

   复制

2. 2一键安装（Windows）

   打开 PowerShell 执行官方脚本，同样自动完成依赖安装、配置和启动流程。

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

   复制

3. 3或用 Docker 部署

   下载官方 docker-compose.yml 后后台启动容器，适合不想在本机装环境的用户。

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

   复制

4. 4打开 Web 控制台

   浏览器访问 http://localhost:9899，即可与智能体对话、配置模型、接入渠道和安装技能。

5. 5服务器部署加固

   部署在服务器时，在 config.json 里把 web_host 设为 0.0.0.0、设置 web_password，并放行 9899 端口。

6. 6用 cow CLI 管理服务

   安装后可用 cow 命令控制服务启停、查看状态日志、升级版本和安装技能。

   cow status
   cow logs

   复制

关键配置

如何确认成功

安装完成后浏览器打开 http://localhost:9899 能进入 Web 控制台，说明启动成功；也可用 cow status 查看服务状态。

常见问题

注意事项

• README 中的一行安装脚本会自动处理依赖、配置与启动，通常无需手动 pip 安装。
• Web 控制台默认端口为 9899，公网部署务必设置 web_password 并放行端口。
• 更多细节见官方文档 https://docs.cowagent.ai/guide/quick-start 与手动安装、升级指南。
• macOS / Windows 也有桌面客户端可在 cowagent.ai/download 下载，开箱即用。