CoPaw 本地部署与使用全指南
一、前置准备
系统要求：Windows 10+/macOS 12+/Linux（64 位），建议4GB 以上内存，至少500MB 可用磁盘空间
工具要求：Windows 需用 PowerShell（勿用 CMD），macOS/Linux 用终端；Docker 部署需先安装 Docker
网络：稳定联网（用于下载依赖、获取 API 密钥）
Python：pip 安装方式需 Python 3.10-3.13；一键安装脚本会自动安装适配版本
二、三种安装方式（任选其一）
方式 1：一键安装（推荐，自动处理所有依赖）
Windows（PowerShell）：以管理员身份打开 PowerShell，执行
powershell
irm https://copaw.agentscope.io/install.ps1 | iex
安装完成后需重启 PowerShell使环境变量生效
macOS/Linux（终端）：执行
bash
运行
curl -fsSL https://copaw.agentscope.io/install.sh | bash
安装完成后执行source ~/.zshrc（zsh）或source ~/.bashrc（bash）刷新环境
扩展安装（支持本地模型）：
Windows：irm https://copaw.agentscope.io/install.ps1 | iex -ArgumentList "--extras ollama,llamacpp"
macOS/Linux：curl -fsSL https://copaw.agentscope.io/install.sh | bash -s -- --extras ollama,llamacpp
方式 2：pip 安装（适合已有 Python 环境的用户）
确保 Python 版本符合要求，执行
bash
运行
pip install copaw
若需指定版本：pip install copaw==0.0.4（最新稳定版）
方式 3：Docker 部署（适合追求隔离环境的用户）
安装 Docker 并启动服务
拉取镜像：docker pull agentscope/copaw:latest
运行容器：
bash
运行
docker run -p 8088:8088 -v copaw-data:/app/working agentscope/copaw:latest
（-v参数用于持久化数据，避免容器删除后配置丢失）
三、初始化配置
基础初始化（推荐新手，快速生成默认配置）
bash
运行
copaw init --defaults
阅读安全说明后输入yes确认，默认配置文件会生成在~/.copaw/config.json
交互式初始化（适合高级用户，自定义配置）
bash
运行
copaw init
按提示设置工作目录、日志级别、默认模型等参数
四、启动与访问服务
启动 CoPaw 服务
bash
运行
copaw app
服务默认运行在http://127.0.0.1:8088，日志会实时显示在终端
访问网页控制台
打开浏览器，输入http://127.0.0.1:8088
首次访问会显示欢迎页面，包含基础使用指南
Docker 部署启动：执行方式 3 中的docker run命令后，直接访问上述地址即可
五、核心使用流程
1. 基础聊天交互
在网页控制台的 “Chat” 页面，直接输入问题与 CoPaw 对话
支持 markdown 格式、代码块、文件上传（PDF/Office 文档）处理
2. 连接聊天应用（钉钉 / 飞书 / QQ 等）
在网页控制台进入 “Connections” 页面
选择要连接的应用（如飞书），按提示获取并输入 API 密钥 / 机器人令牌
保存配置后，即可通过该应用与 CoPaw 对话，无需打开浏览器
3. 技能管理与定时任务
“Skills” 页面：启用 / 禁用内置技能（如 PDF 处理、新闻摘要、定时任务）
“Schedules” 页面：配置定时任务（如每日早 8 点推送天气、每周五整理文件）
4. 本地模型使用（扩展安装后）
下载模型：copaw models download qwen/qwen3-4b-gguf（示例：通义千问 3-4B）
在控制台 “Models” 页面切换为本地模型，实现数据本地处理
六、关键命令速查
表格
功能 命令
初始化（默认配置） copaw init --defaults
启动服务 copaw app
查看帮助 copaw --help
下载模型 copaw models download [模型名称]
升级 CoPaw copaw upgrade（一键安装）/ pip install --upgrade copaw（pip 安装）
查看版本 copaw --version
七、常见问题与解决方法
端口占用：若 8088 端口被占用，启动时指定端口：copaw app --port 8089
初始化失败：删除~/.copaw目录后重新执行copaw init --defaults
依赖缺失：一键安装方式重新运行安装脚本；pip 方式执行pip install --force-reinstall copaw
本地模型无法运行：确保已安装 ollama/llamacpp 扩展，模型文件完整
聊天应用连接失败：检查 API 密钥 / 令牌有效性，确保网络可访问对应应用服务器
八、安全与隐私提示
CoPaw 本地部署时，所有数据均存储在本地，不经过第三方服务器
配置文件（~/.copaw/config.json）包含 API 密钥等敏感信息，切勿分享给他人
定期通过copaw upgrade更新版本，修复安全漏洞
九、完整流程总结
选择安装方式并执行对应命令
运行copaw init --defaults初始化
执行copaw app启动服务
浏览器访问http://127.0.0.1:8088进入控制台
配置聊天应用连接（可选）
开始使用 CoPaw 的各项功能
本资讯来自互联网，如有侵权强联系删除！