通千算智 logo 通千算智 AI 数字员工
下载客户端
首页 / 文档 / 快速开始 / 手动安装

手动安装

手动部署 通千算智（源码 / Docker）

本文面向开发者与服务器运维，安装的是上游开源发行版源码。 只想尽快用起来的话，请走桌面客户端或团队工作台； 要自己搭团队版，另见服务器部署（团队版）。

源码部署

1. 克隆项目代码

bash
git clone https://github.com/zhayujie/CowAgent
cd CowAgent/
提示

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

2. 安装依赖

核心依赖（必选）：

bash
pip3 install -r requirements.txt

扩展依赖（可选，建议安装）：

bash
pip3 install -r requirements-optional.txt

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

3. 安装 通千算智 CLI

安装命令行工具，用于管理服务和技能：

bash
pip3 install -e .

安装后即可使用 cow 命令：

bash
cow help

此步骤为推荐操作。安装后可以使用 cow start、cow stop、cow update 等命令管理服务，也可以使用 cow skill 管理技能。如果不安装 CLI，可以使用 ./run.sh 或 python3 app.py 运行。

3.1 安装浏览器工具（可选）

如需使用浏览器工具（控制浏览器访问网页、填写表单等），运行：

bash
cow install-browser

该命令会自动安装 Playwright 和 Chromium 浏览器。详细说明参考 浏览器工具文档。

浏览器工具依赖较重（~300MB），如不需要可跳过，不影响其他功能正常使用。

4. 配置

复制配置文件模板并编辑：

bash
cp config-template.json config.json

在 config.json 中填写模型 API Key 和通道类型等配置，详细说明参考各 模型文档。

5. 运行

使用 通千算智 CLI 运行（推荐）：

bash
cow start

或者本地前台运行：

bash
python3 app.py

运行后默认启动 Web 控制台，访问 http://localhost:9899 开始对话和管理Agent。

服务器后台运行（不使用 CLI 时）：

bash
nohup python3 app.py & tail -f nohup.out
提示

服务器公网访问 Web 控制台：默认 web_host 仅监听 127.0.0.1（本机访问），需公网访问时请在 config.json 中将 web_host 设为 0.0.0.0，同时强烈建议设置 web_password 启用鉴权。此外还需在防火墙/安全组中放行 9899 端口，建议仅对指定 IP 开放以保证安全。

Docker 部署

使用 Docker 部署无需下载源码和安装依赖。Agent模式下更推荐使用源码部署以获得更多系统访问能力。

需要安装 Docker 和 docker-compose。

1. 下载配置文件

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

打开 docker-compose.yml 填写所需配置。

2. 启动容器

bash
sudo docker compose up -d

3. 查看日志

bash
sudo docker logs -f chatgpt-on-wechat

数据持久化：docker-compose.yml 默认将两个目录挂载到宿主机，容器重启、docker compose pull 升级换镜像后数据都不会丢失：

  • ./cow → 容器内 /home/agent/cow：工作空间，存放对话安装的技能、记忆、知识库、mcp.json 及对话产物。
  • ./cow-data → 容器内 /home/agent/.cow：数据目录，由 COW_DATA_DIR 指定，存放 Web 控制台保存的 config.json、运行日志、通道凭据等。

两个目录默认位于 docker-compose.yml 同级路径下，请勿删除。

提示

Docker 公网访问 Web 控制台：在 docker-compose.yml 中将 WEB_HOST 设为 0.0.0.0（容器内默认绑定 127.0.0.1 无法从宿主机外访问），同时强烈建议设置 WEB_PASSWORD 启用鉴权。此外需确保 9899 端口正确映射到宿主机，并在防火墙/安全组放行该端口。

核心配置项

参数 环境变量 说明 默认值
channel_type CHANNEL_TYPE 接入渠道类型 web
model MODEL 模型名称 deepseek-flash
agent AGENT 是否启用 Agent 模式 true
agent_workspace - Agent 工作空间路径 ~/cow
agent_max_context_tokens AGENT_MAX_CONTEXT_TOKENS 最大上下文 tokens 40000
agent_max_context_turns AGENT_MAX_CONTEXT_TURNS 最大上下文记忆轮次 30
agent_max_steps AGENT_MAX_STEPS 单次任务最大决策步数 15
cow_lang COW_LANG 界面、命令文案、系统提示词等的语言，auto 自动检测，可设为 zh / en auto
提示

全部配置项可在项目 config.py 文件中查看。Docker 部署时，配置项名称需转为大写环境变量格式。