CoPaw 超详细安装指南:6 种方式一键部署你的 AI 个人助理

1、一键脚本安装(推荐新手)

最适合新手,无需预装 Python,安装脚本自动管理一切。

macOS / Linux 安装

curl -fsSL https://copaw.agentscope.io/install.sh | bash

安装完成后打开新终端或执行 source ~/.zshrc。

Windows (PowerShell) 安装

irm https://copaw.agentscope.io/install.ps1 | iex

高级选项

# 安装指定版本
curl -fsSL https://copaw.agentscope.io/install.sh | bash -s -- --version 0.0.2

# 安装本地模型支持
bash install.sh --extras llamacpp    # llama.cpp
bash install.sh --extras mlx         # MLX (Apple Silicon)
bash install.sh --extras ollama      # Ollama

2、pip 安装

适合自行管理 Python 环境的用户(需 Python >= 3.10, < 3.14)。

基础安装

pip install copaw

使用虚拟环境

# 创建虚拟环境
python -m venv .venv

# 激活虚拟环境 (Linux/macOS)
source .venv/bin/activate

# 激活虚拟环境 (Windows)
.venv\Scripts\Activate.ps1

# 安装
pip install copaw

安装可选依赖

pip install 'copaw[llamacpp]'   # 本地模型
pip install 'copaw[mlx]'        # MLX
pip install 'copaw[ollama]'     # Ollama

3、桌面应用 (Beta)

零配置,下载后双击即可运行。

特点

  • ✅ 零配置:下载后双击即可运行
  • ✅ 跨平台:支持 Windows 10+ 和 macOS 14+
  • ✅ 可视化:自动打开浏览器界面
  • ⚠️ Beta 阶段:功能持续完善中

下载与使用

  1. 前往 GitHub Releases 下载
  2. Windows 双击 exe 安装,macOS 解压后右键打开
  3. 首次启动可能需要 10-60 秒,请耐心等待

4、Docker 部署

# 拉取镜像 (Docker Hub)
docker pull agentscope/copaw:latest

# 阿里云 ACR (国内推荐)
docker pull agentscope-registry.ap-southeast-1.cr.aliyuncs.com/agentscope/copaw:latest

# 运行容器
docker run -p 127.0.0.1:8088:8088 \
  -v copaw-data:/app/working \
  -v copaw-secrets:/app/working.secret \
  agentscope/copaw:latest

5、阿里云 ECS 部署

  1. 打开阿里云 ECS 部署页面
  2. 按页面提示填写部署参数
  3. 确认费用并创建实例
  4. 部署完成后获取访问地址

6、初始化与启动

步骤一:初始化

# 快速初始化 (默认配置)
copaw init --defaults

# 交互式初始化 (推荐)
copaw init

# 覆盖已有配置
copaw init --force

步骤二:启动服务

copaw app

服务默认监听 127.0.0.1:8088

高级启动选项

# 自定义地址
copaw app --host 0.0.0.0 --port 9090

# 开发模式
copaw app --reload

# 详细日志
copaw app --log-level debug

验证安装

方式一:访问控制台

浏览器打开 http://127.0.0.1:8088/

方式二:API 测试

curl -N -X POST "http://localhost:8088/api/agent/process" \
  -H "Content-Type: application/json" \
  -d '{"input":[{"role":"user","content":[{"type":"text","text":"你好"}]}],"session_id":"session123"}'

方式三:查看状态

copaw daemon status
copaw daemon version
copaw daemon logs -n 50

常用 CLI 命令

模型管理

copaw models list       # 查看提供商和模型
copaw models config     # 交互式配置
copaw models set-llm    # 切换模型

频道管理

copaw channels list     # 查看频道状态
copaw channels config   # 配置频道

定时任务

copaw cron list         # 列出任务
copaw cron create       # 创建任务
copaw cron delete   # 删除任务

技能管理

copaw skills list       # 列出技能
copaw skills config     # 启用/禁用技能

📚 接下来做什么?

  • 配置频道 → 接入钉钉/飞书/QQ/Discord
  • 配置心跳 → 编辑 HEARTBEAT.md
  • 学习 CLI → 了解更多命令
  • 扩展技能 → 自定义 Skills

💡 小贴士

  • 工作目录默认在 ~/.copaw
  • 配置文件:config.json、HEARTBEAT.md
  • 升级:重新运行安装命令
  • 卸载:copaw uninstall

🔗 相关链接

CoPaw 由 AgentScope 团队构建。有问题欢迎反馈交流!🐾

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注