CoPaw国产AI助理快速上手指南：Docker部署与多平台集成教程

April 4, 2026

CoPaw是一款可部署在本地环境的个人AI助理产品。

核心功能亮点：

多平台对话集成：支持通过钉钉、飞书、QQ、Discord、iMessage等多种常用通讯渠道与你进行交互。
自动化定时任务：能够根据用户预设的配置，自动执行各类计划任务。
模块化技能扩展：其能力由丰富的Skills（技能）决定，具备无限潜力。产品内置了定时任务、PDF与表单处理、Office文档（Word/Excel/PPT）操作、新闻摘要、文件阅读等多种实用技能，并允许用户通过Skills机制进行自定义功能扩展。
数据本地化存储：所有数据均存储于用户本地，无需依赖任何第三方云托管服务，保障了数据隐私与安全。

部署方式选择建议：若你需要实现调用系统底层资源、自动化环境配置或部署复杂应用等高级功能，建议将CoPaw直接安装到操作系统底层。如果主要需求是作为日常AI助理，用于资料整理、信息通知等基础场景，那么采用Docker容器化部署方案会更加简便、灵活且安全。

Docker Compose快速安装

以下是使用Docker Compose部署CoPaw的服务配置示例：

services:
  copaw:
    image: agentscope/copaw:latest
    container_name: copaw
    ports:
      - 8088:8088
    volumes:
      - ./working:/app/working
    restart: always

关键参数说明（更多配置选项请参考官方文档）：

/app/working（容器内路径）：此目录用于存放CoPaw的配置文件与运行时产生的工作文件。通过卷挂载（volumes）将本地目录./working与之关联，可实现配置持久化与数据管理。

配置与实战操作

访问管理界面：在浏览器地址栏中输入 http://你的NAS或服务器IP:8088，即可访问CoPaw的Web管理界面。
切换中文界面：进入界面后，可点击右上角选项将语言切换为中文，方便后续操作。
配置AI模型：首先进入“模型配置”页面。CoPaw支持连接本地部署的Ollama模型以及各类云端大模型API。提示：本文示例使用硅基流动的API服务，你可通过其平台注册并获取API Key。点击“添加提供商”后，再点击“设置”，填入你从模型服务商处获得的API Key即可。建议添加几个常用或计划使用的模型。若追求更强的理解与生成能力，推荐选择参数规模较大的模型，例如最新推出的GLM-5系列模型（如Pro版本）。
基础对话测试：返回聊天主页面，发送一条测试消息，验证模型是否已成功连接并能够正常回复。收到连贯、合理的回复即表明模型调用配置无误。
对接通讯频道：核心功能之一是将CoPaw接入日常使用的通讯工具。官方提供了详细文档指导如何配置钉钉、飞书、QQ、Discord等频道，配置成功后即可直接在这些App内向CoPaw发送指令。提示：具体对接步骤可查阅官方文档：https://copaw.agentscope.io/docs/channels
管理对话与任务：所有通过Web界面或接入频道的对话记录，均可在“会话”页面中统一查看与管理。提示：定时任务通常可通过自然语言对话指令自动创建，例如直接告诉CoPaw“每天上午9点提醒我开会”。当然，用户也可以在“定时任务”页面中手动创建和管理复杂的计划任务。
使用工作区与技能：在“工作区”页面，理论上可以管理CoPaw生成和处理的文件。注意：在当前Docker部署的某些版本中，可能存在一个已知BUG，即界面无法正确识别通过卷挂载映射的本地工作目录中的文件（即使已尝试修改文件权限或为容器赋予最高权限）。不过，在宿主机对应的挂载文件夹内，通常能看到生成的文件实际已存在。在“技能”页面，则可以查看和管理CoPaw所有内置及自定义的Skills，涵盖了定时任务、文档处理、信息摘要等丰富功能。