1. 什么是 CoPaw？
CoPaw 是阿里云通义实验室推出的个人 AI 智能体，可以在电脑上帮你处理各种任务（如信息整理、定时提醒、文件处理等），并支持接入钉钉、飞书、QQ 等聊天软件，实现 24 小时在线办公助手。
2. 系统要求
- 操作系统：Windows 10 或 Windows 11（64 位）
- Python：3.9 或更高版本（推荐 3.10）
- 内存：建议 4GB 以上（运行时占用约 200~500MB）
- 磁盘空间：至少 500MB 可用空间
- 网络：需要能够访问外网（用于调用大模型 API）
3. 安装步骤
3.1 安装 Python
- 访问 Python 官网 下载 Windows 安装包（如 Python 3.10 或 3.11）。
- 运行安装程序，务必勾选'Add Python to PATH'，然后选择'Install Now'。
- 验证安装：
python --version - 如果显示版本号，说明安装成功。
3.2 创建虚拟环境（推荐）
为了避免与其他 Python 项目冲突，建议为 CoPaw 创建一个虚拟环境：
# 创建一个名为 copaw-env 的虚拟环境
python -m venv copaw-env
# 激活虚拟环境
copaw-env\Scripts\activate
激活后，命令行前面会出现 (copaw-env) 提示符。
3.3 使用 pip 安装 CoPaw
在虚拟环境中执行：
pip install copaw
如果下载速度慢，可以使用国内镜像源加速：
pip install copaw -i https://mirrors.aliyun.com/pypi/simple/
4. 初始化配置
安装完成后，运行以下命令生成默认配置文件：
copaw init --defaults
这会在当前用户目录下创建一个 .copaw 文件夹（Windows 路径通常为 C:\Users\你的用户名\.copaw），里面包含了工作区、配置文件和示例技能。
5. 启动服务
在虚拟环境中执行：
copaw app
启动成功后，你会看到类似如下的输出：
INFO: Started server process [12345]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on http://127.0.0.1:8088 (Press CTRL+C to quit)
此时 CoPaw 的 Web 控制台已经运行在本地 8088 端口。
6. 访问 Web 控制台
打开浏览器，访问 http://127.0.0.1:8088，你将看到 CoPaw 的对话界面。
