【人工智能】- 手把手教你本地部署（CaPaw）

AI_Auto

438人浏览 · 2026-04-11 09:00:00

AI_Auto · 2026-04-11 09:00:00 发布

Copaw,你的专属AI助理，数据全程私有，还能接入钉钉、飞书、QQ

最近AI圈又迎来一位重磅选手——CoPaw。它由阿里通义实验室基于AgentScope框架打造，定位是个人AI Workstation（个人AI工作站）。简单说，你可以在自己电脑上部署一个24小时待命的AI助理，它能通过钉钉、飞书、QQ等渠道和你对话，还能操作本地文件、执行定时任务，而且所有数据都留在你自己的环境里，不依赖任何云服务。

2026年2月4日发布，2月28日正式在GitHub开源，短短一个月已经收获了不少关注。今天就带大家从零开始，在自己的电脑上跑起CoPaw，并接入QQ实测它的能力。

📋 基本信息速览

项目	信息
项目名称	CoPaw
GitHub地址	https://github.com/agentscope-ai/CoPaw
发布时间	2026.2.4 发布，2.28 开源
核心框架	AgentScope（阿里通义实验室）
官方定位	个人 AI Workstation
典型场景	多渠道个人助手（钉钉、飞书、QQ、Discord等）

一句话总结：一个可以自己部署、能接入各种聊天软件、完全听你指挥的AI智能体。

🚀 本地部署：从环境到运行，全程图解

部署前确保你已经有、conda 和 Node.js（用于构建前端）。推荐使用 conda 创建虚拟环境，避免依赖冲突。

第一步：创建虚拟环境

conda create -n copaw-env python=3.12

第二步：安装copaw

建议使用 开发模式 安装（包含测试和格式化工具），方便后续折腾：

conda activate copaw-env

如果只想正常使用，也可以运行：

pip install copaw

第三步：初始化

copaw init

这一步实现服务的初始化，稍后启动服务时自动使用。

第四步：启动CoPaw服务

回到项目根目录，执行：

copaw app

启动成功后，终端会显示 http://127.0.0.1:8088，用浏览器打开，就能看到CoPaw的控制台界面了。

⚠️ 如果8088端口被占用，可以用 copaw app --port 9090 指定其他端口。

第五步：配置LLM模型

第一次打开，CoPaw会提示“没有配置模型”。你需要：

在左侧导航栏进入 设置 → 模型
CoPaw内置了OpenAI、通义千问、Gemini等供应商的默认配置，只需要填入对应的 API Key 并保存（新手推荐kimi）
如果使用本地模型（如Ollama），也可以在界面中添加

💡 高阶技巧：界面允许添加供应商，但无法直接添加模型——模型名称是代码硬编码的。如果你用的模型不在列表中，可以直接修改源码文件 src/copaw/providers/registry.py，按照现有的格式添加你自己的供应商和模型名称。改完重启服务即可。

第六步：配置环境变量（重要！）

CoPaw需要一个地方存储对话产生的文件（比如你让它生成的报告、下载的图片等）。建议直接在CoPaw控制台的 设置 → 环境变量 里配置，这样只影响当前项目，不污染系统变量。

你需要设置的关键变量通常是 COPAW_STORAGE_PATH，指向一个本地文件夹路径。当然，也可以直接在系统用户变量里配置，看个人习惯。

到这里，一个基础的CoPaw就已经跑起来了！ 你可以在网页上直接和它对话，测试一下基本功能。

💬 接入QQ实测：它真的能干活

CoPaw最吸引人的地方是多渠道接入。官方GitHub提供了接入钉钉、飞书、QQ、Discord的详细教程，照着操作即可。下面是我实测QQ的日志片段：

INFO src\copaw\app\channels\qq\channel.py:734 | 2026-03-04 15:35:08 | qq recv c2c from=61C643... text='我需要知道最近一周ai最火的三件事情'
INFO src\copaw\app\runner\runner.py:68 | Handle agent query: {
  "session_id": "qq:61C643...",
  "user_id": "61C643...",
  "channel": "qq",
  "msgs_len": 1,
  "msgs_str": "[Msg(id='msg_...', name='user', content=[{'type': 'text', 'text': '我需要知道最近一周ai最火的三件事情'}], role='user')]..."
}

可以看到，我在QQ上给CoPaw发了一条消息，它成功接收并开始处理。随后它会调用内置的搜索或摘要能力，把答案返回给我——整个过程就像在和一个真人助理聊天，但背后完全是本地运行的AI。