CoPaw 简介
CoPaw 是阿里云通义实验室推出的个人 AI 智能体，本质上是一个运行在本地电脑上的自动化助手。它能帮你处理信息整理、定时提醒、文件处理等任务，并支持接入钉钉、飞书、QQ 等聊天软件，实现 24 小时在线办公。
环境准备
在开始之前，请确保你的 Windows 机器满足以下基础要求：
- 操作系统：Windows 10 或 Windows 11（64 位）
- Python 版本：3.9 或更高（推荐 3.10）
- 内存：建议 4GB 以上（运行时占用约 200~500MB）
- 磁盘空间：至少 500MB 可用空间
- 网络：需能访问外网以调用大模型 API
安装步骤
1. 检查 Python 环境
如果尚未安装 Python，请访问官网下载 Windows 安装包。安装时务必勾选 Add Python to PATH，然后选择 Install Now。安装完成后打开命令行输入 python --version，看到版本号即表示环境就绪。
2. 创建虚拟环境
为了保持项目依赖独立，避免污染全局环境，建议为 CoPaw 单独创建一个虚拟环境：
# 创建名为 copaw-env 的虚拟环境
python -m venv copaw-env
# 激活虚拟环境
copaw-env\Scripts\activate
激活成功后，命令行提示符前会出现 (copaw-env) 字样，说明已进入隔离环境。
3. 安装 CoPaw
在虚拟环境中执行 pip 安装命令。国内用户建议使用镜像源以提升下载速度：
pip install copaw -i https://mirrors.aliyun.com/pypi/simple/
初始化与配置
安装完成后，运行初始化命令生成默认配置文件：
copaw init --defaults
这会在当前用户目录下生成 .copaw 文件夹（路径通常为 C:\Users\你的用户名\.copaw），其中包含工作区、配置文件和示例技能。
启动服务
继续在虚拟环境中执行启动命令：
copaw app
启动成功后，终端会输出 Uvicorn 运行日志，提示服务已监听在 http://127.0.0.1:8088。此时直接在浏览器访问该地址即可进入 Web 控制台。
核心功能配置
1. 接入大模型 API
CoPaw 本身没有'大脑'，需要接入外部大模型才能具备理解与回复能力。目前支持多种提供商，如 ModelScope（魔搭）、DashScope（阿里云）或兼容 OpenAI 格式的自定义接口。
在 Web 控制台左侧菜单点击 Models，选择 Add Model。以阿里云 DashScope 为例：
- 访问 DashScope 控制台注册/登录。
- 在 API-KEY 管理页面创建新密钥并复制。
- 在 CoPaw 配置页粘贴 Key，选择模型（如
qwen-max、qwen-plus），保存即可。
注意：API 调用通常涉及费用，请留意云厂商的计费说明。
