[特殊字符] CoPaw（阿里龙虾AI）Windows 安装及应用

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

1. 访问 Python 官网 下载 Windows 安装包（如 Python 3.10 或 3.11）。

2. 运行安装程序，务必勾选“Add Python to PATH”，然后选择“Install Now”。python --version

3. 如果显示版本号，说明安装成功。

3.2 创建虚拟环境（推荐）

为了避免与其他 Python 项目冲突，建议为 CoPaw 创建一个虚拟环境：

bash

# 创建一个名为 copaw-env 的虚拟环境
python -m venv copaw-env

# 激活虚拟环境
copaw-env\Scripts\activate

激活后，命令行前面会出现 (copaw-env) 提示符。

3.3 使用 pip 安装 CoPaw

在虚拟环境中执行：

bash

pip install copaw

如果下载速度慢，可以使用国内镜像源加速：

bash

pip install copaw -i https://mirrors.aliyun.com/pypi/simple/

4. 初始化配置

安装完成后，运行以下命令生成默认配置文件：

bash

copaw init --defaults

这会在当前用户目录下创建一个 .copaw 文件夹（Windows 路径通常为 C:\Users\你的用户名\.copaw），里面包含了工作区、配置文件和示例技能。

5. 启动服务

在虚拟环境中执行：

bash

copaw app

启动成功后，你会看到类似如下的输出：

text

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 的对话界面。

7. 配置大模型 API（必须步骤）

CoPaw 本身没有“大脑”，需要接入外部的大模型 API 才能理解和回复。目前支持多种 API 提供商：

7.1 进入模型配置页面

在 Web 控制台左侧菜单栏点击 “Models” 或 “模型”。

7.2 添加模型

点击 “Add Model”，选择你需要的提供商：

• ModelScope（魔搭）：注册后可能获得免费额度。

• DashScope（阿里云）：阿里云的模型服务，需开通并获取 API Key。

• Custom（自定义）：支持兼容 OpenAI 格式的 API，如硅基流动、DeepSeek 等。

7.3 填写 API Key

以 DashScope（阿里云） 为例：

• 访问 阿里云 DashScope 控制台 注册/登录。

• 在“API-KEY 管理”中创建一个新的 API Key，并复制。

• 在 CoPaw 配置页面中粘贴 API Key，选择模型（如 qwen-max、qwen-plus 等），点击保存。

注意：API 调用会产生费用（通常很低），请留意阿里云的计费说明。

8. 设置人设（PROFILE.md）

人设文件 PROFILE.md 位于工作区目录（默认为 C:\Users\你的用户名\.copaw\PROFILE.md）。你可以用文本编辑器（如记事本、VS Code）打开它，用自然语言定义 CoPaw 的身份、性格和习惯。例如：

markdown

# CoPaw 的人设
你是我的私人 AI 助手，名字叫“小虾米”。你性格活泼，喜欢用表情符号，称呼我为“老板”。你擅长整理信息、设置提醒，并且总是主动提供帮助。

保存文件后，重启 copaw app 或刷新控制台即可生效。

9. 基础应用

9.1 直接对话

在 Web 控制台的输入框中输入消息，CoPaw 会调用配置好的模型进行回复，并执行内置的 Skills（如查新闻、读文件等）。

9.2 创建定时任务

你可以直接对 CoPaw 说：“每天早上 9 点提醒我带工牌” 或 “每天下午 5 点帮我总结今日热点”。CoPaw 会自动在后台创建定时任务，并在指定时间触发。

9.3 查看和管理任务

在控制台左侧菜单栏点击 “Tasks” 或 “任务”，可以查看所有已创建的定时任务，并支持编辑或删除。

10. 进阶玩法

10.1 接入聊天软件

CoPaw 支持接入钉钉、飞书、QQ、iMessage 等平台，让你在常用 App 里直接使用它。具体配置方法请参考官方文档（http://copaw.agentscope.io/），通常需要获取机器人的 Webhook 地址并在 CoPaw 中设置。

10.2 扩展自定义 Skills

如果你熟悉 Python，可以在工作区的 skills 文件夹（C:\Users\你的用户名\.copaw\skills\）下添加自己的脚本。CoPaw 会自动加载这些技能，你可以在对话中调用它们。例如，创建一个 weather.py 实现天气查询，然后对 CoPaw 说“调用 weather 查询北京天气”即可。

11. Windows 常见问题

Q1：运行 copaw 命令提示“不是内部或外部命令”

原因：Python Scripts 目录未添加到 PATH。
解决：重新运行 Python 安装程序，选择“Modify”，勾选“Add Python to environment variables”。或者手动将 C:\Users\你的用户名\AppData\Local\Programs\Python\Python310\Scripts 添加到系统环境变量 PATH 中。

Q2：启动 copaw app 后无法访问 http://127.0.0.1:8088

原因：可能是防火墙阻止了端口，或者端口被其他程序占用。
解决：

• 检查防火墙设置，允许 Python 或 copaw 通过。

• 更换端口：启动时指定其他端口，如 copaw app --port 8089。

• 确保服务启动成功（命令行未报错）。

Q3：虚拟环境激活失败

原因：PowerShell 执行策略限制。
解决：以管理员身份打开 PowerShell，执行 Set-ExecutionPolicy RemoteSigned，然后重新激活。

Q4：模型 API 调用失败

原因：API Key 错误、网络问题或模型名称填写错误。
解决：

• 确认 API Key 有效且余额充足。

• 检查网络是否能够访问 API 服务（可能需要科学上网）。

• 在 CoPaw 模型配置中确认模型名称是否正确（如 qwen-max 等）。

12. 获取帮助

• 官方文档：http://copaw.agentscope.io/

• GitHub 仓库：https://github.com/agentscope-ai/CoPaw（可提 Issue）

• 魔搭社区：https://modelscope.cn/studios/fork?target=AgentScope/CoPaw（在线体验与交流）