阿里copaw mac版 v0.0.7官方版

阿里copaw mac版是针对苹果电脑而开发的一款更易用、可本地部署也可云端部署的个人智能助理，采用的是独立打包的桌面应用，内置完整Python 环境、所有依赖和前端资源，用户双击即用，无需命令行，无需预装任何工具，主打追求安装极简与「本地 + 云端」统一体验，并以云原生（cloud native）为发展目标，让「数字搭档」既能扎根本地，也能无缝延展到云上。

在功能方面，阿里云通义copaw支持多种定时任务，用户可以告知它何时需要完成特定事项，例如提醒、整理待办等，内置的Skills涵盖文档创建、新闻阅读、文件管理等日常操作，用户可以轻松交给CoPaw完成诸如阅读邮件、查找新闻、整理待办、监控股价等任务。同时为了满足用户的多样需求，阿里copaw还允许用户在工作目录下自定义Skills，甚至可以通过简单的控制台操作来启用、禁用或编辑这些功能。软件不仅是技术的进步，更是个人智能助理领域的一次重要创新，将智能与人性化的设计相结合，极大地提升了用户的工作效率和生活质量。

软件核心优势

1、模块化重构，按需定制

核心组件彻底解耦，支持像插件一样自由组装 Agent 与接入多频道，可独立扩展任意模块，轻松构建消息稳定、功能专属的个性化智能体。

2、主动式智能，越用越懂

创新引入主动心跳机制与长期记忆功能。它能自主执行定时任务并持续学习用户偏好，使用时间越长，越能精准洞察您的需求。

3、全模态适配，自由部署

全面兼容主流模型与 Ollama 等本地自建服务，灵活适配各类推理环境，让用户在保障数据隐私的同时，真正掌握模型自主权。

阿里copaw mac版安装指南如下：

一、系统要求

1、操作系统: macOS 14 (Sonoma) 或更高版本

2、架构:

Apple Silicon (M1/M2/M3/M4) - 推荐，支持 MLX 本地模型加速

Intel 芯片 - 可能可以运行，但无法使用 MLX 加速功能

二、安装步骤

1、下载本站提供的阿里云通义copaw for mac压缩包

2、解压缩 双击 .zip 文件自动解压，得到 CoPaw.app 应用

3、移动到应用程序文件夹 (可选) 将 CoPaw.app 拖到 /Applications 文件夹

三、首次启动：解除系统安全限制

1、为什么需要手动信任？

CoPaw 应用未经过 Apple 开发者签名和公证（Notarization），macOS Gatekeeper 会默认阻止运行。

2、为什么没有签名？

开发者签名需要额外成本和流程，后续版本会补上

当前影响：

1、不影响功能：应用完全正常运行

2、首次需手动信任：一次操作后永久有效

3、安全性：开源代码可审计，构建过程透明（CI/CD）

四、如何解除限制？

方法 1：右键打开 (推荐)

右键点击（或 Control + 点击）CoPaw.app

1、在菜单中选择 "打开"

2、在弹出的对话框中，再次点击 "打开" 按钮

3、之后双击即可正常启动，不会再弹窗

方法 2：系统设置解除拦截

如果仍被拦截：

1、打开 系统设置 → 隐私与安全性

2、向下滚动，找到类似以下提示： "已阻止使用 'CoPaw'，因为无法验证开发者"

3、点击 "仍要打开" 或 "允许" 按钮

4、输入管理员密码确认

方法 3：终端命令解除隔离

# 移除下载隔离属性

xattr -cr /Applications/CoPaw.app

注意: 此方法会完全移除安全检查，仅当您完全信任应用来源时使用。

五、权限请求

首次启动时，macOS 可能会弹窗请求以下权限：

桌面文件访问权限 用于访问您的文件（如果使用文件相关功能）

- 点击 "允许" 以正常使用

- 点击 "不允许" 应用仍可运行，但部分功能受限

启动方式

正常启动（双击）

1、双击 CoPaw.app 即可启动

2、应用会在后台运行，打开浏览器窗口

3、日志输出到：~/.copaw/desktop.log

终端启动的优势：

1、实时查看所有日志输出

2、看到完整的 Python 错误堆栈

3、便于调试和报告问题

4、可添加 --log-level debug 查看更详细信息

六、常见问题

Q: 双击后没有任何反应？ A:

检查 ~/.copaw/desktop.log 文件查看错误

使用上述终端命令启动，查看实时输出

Q: 提示"Apple 无法验证此应用"？ A: 按照上述"解除系统安全限制"步骤操作

Q: 如何卸载？ A: 将 CoPaw.app 拖到废纸篓，然后删除 ~/.copaw 配置文件夹

Q: Intel Mac 可以用吗？ A: 可以运行，但无法使用 MLX 模型加速（MLX 仅支持 Apple Silicon）

Q: 应用为什么没有签名，为什么系统会提示有风险？

A:当前采用

1、开源透明：所有代码和构建流程公开在 GitHub

2、CI/CD 可验证：GitHub Actions 自动构建，日志可查

3、用户审计：可以自行检查代码并本地构建

4、一次信任：手动信任后永久有效

copaw能帮你做什么？

1、AI 辅助办公

自然语言交互即可快速完成表单、Word、Excel、PPT 等内容的处理、新闻摘要、文件阅读。

2、定时自动执行

无需手动触发，CoPaw 可按设定时间自动运行任务。无论是定时推送文案，还是周期查询待办，都能主动将结果发至指定频道，实现主动服务。

3、多通道无缝对话

支持钉钉、飞书、QQ 、Telegram 等主流软件，无论消息发至哪个频道，CoPaw 都能进行回复处理，实现查资料、记待办与问答的无缝衔接。

阿里云通义copaw控制台

控制台是CoPaw内置的Web管理界面。运行 copaw app 后，在浏览器中打开 http://127.0.0.1:8088/ 即可进入。

在控制台中你可以：

1、和 CoPaw 实时对话

2、启用/禁用消息频道

3、查看和管理所有聊天会话

4、管理定时任务

5、编辑 CoPaw 的人设和行为文件

6、开关技能以扩展 CoPaw 的能力

7、管理MCP客户端

8、修改运行配置

9、配置 LLM 提供商并选择使用的模型

10、管理工具所需的环境变量

11、查看 LLM Token 消耗统计

更新日志

v0.0.7版本

一、新增内容

1、安全性

- 工具守护：执行前的安全层，用于扫描工具参数中的风险模式（例如，shell命令中的 ）。风险电话会被拦截，直到用户通过 ;被拒绝的工具总是被阻挡。用于管理规则和审批的新安全设置页面。

2、频道与通信

- Mattermost 频道：完整集成 Mattermost 支持私信和线程对话，包含文本、图片、文件、视频和音频，并支持输入指示器和可配置访问策略

- 矩阵通道：采用矩阵-nio的新矩阵协议通道集成，支持文本、图像、视频、音频和文件消息

- 要求提及过滤：除非机器人@mentioned（或Telegram使用斜杠命令），群组消息被忽略，且可通过Discord、DingTalk、Feishu和Telegram按频道配置

- Telegram Markdown 渲染：Markdown 到 Telegram 的 HTML 转换，适用于 LLM 输出，包括加粗、斜体、代码块、链接、块引号、剧透等，发送失败时自动恢复纯文本

- Feishu 表情符号反应：当处理成功完成时，自动在最后一条 Feishu 回复中添加“完成”表情符号

- Feishu 富文本媒体：解析Feihu后文型富文本中的媒体文件（视频、音频及其他文件），支持自动下载和附件

- QQ 图像消息：支持通过代理输出中的标签发送图像消息，适用于私信和群聊

3、模型与人工智能特性

- 模型重试：针对暂时错误（速率限制、超时、连接）自动重试LLM API调用，支持指数退回，可通过。

- LM Studio Provider：作为内置模型提供者加入LM Studio，配备配置UI和文档

- 令牌使用跟踪：通过令牌使用设置页面、API和工具实现跨服务提供商的端到端令牌使用跟踪get_token_usage)

- 提供者高级配置：新增自定义生成参数编辑器（如温度、top_p、enable_thinking）;没有 API 密钥的提供者（如 Ollama、LM Studio）现在已正确显示为配置

4、控制台与界面

- Workspace 拖放：在 Agent Workspace 中对启用的系统提示文件进行拖放重排序，控制提示文件优先级

- 聊天模型选择：聊天页面上的模型选择器下拉菜单，用于对话中切换模型

- 代理语言选择器：直接从控制台代理配置页面

- 工具批处理开关：工具页面上的“全部启用”和“全部禁用”按钮用于批量管理

- 聊天URL路由：通过自动URL同步直接访问特定聊天会话的URL

- 上下文管理界面：代理配置中新增的上下文管理部分，支持可调紧凑比率、储备比率和工具结果压缩设置，显示衍生令牌阈值

- 在导航中保留聊天：切换到其他页面时聊天保持挂载状态，保留正在进行的消息、光标位置和运行状态

5、技能

- AI技能优化：技能编辑器中的“AI优化”按钮利用当前模型重写技能内容并同步输出;支持英语、中文和俄语提示

- 技能卡描述：技能卡现在会显示来自 SKILL.md 的前置信息，这样你无需打开就能看到每个技能的作用

6、安装与平台

- 自动PyPI镜像：安装脚本中自动选择PyPI镜像，检测连接并回退至阿里云镜像，适用于中国用户

- Docker 秘密目录：新增于 Docker 布局中，用于持久提供者设置和 API 密钥

二、更改内容

1、模式与提供者

- 提供者连接测试：连接测试方法现在返回描述性失败消息，而不仅仅是布尔值，使诊断配置问题更为容易

- ModelScope 默认值：将默认模型更新为 和 Qwen3.5-122B-A10BGLM-5

- 提供者ID冲突解决：重复的提供者ID现在会自动解决（例如→），而不是引发错误;自定义提供者的连接测试被禁用

- 按需模型发现：打开提供者页面不再自动触发模型获取;使用“发现模型”按钮刷新模型列表

2、性能

- 异步压缩处理：工作区的压缩/解压操作现在异步运行，以防止下载和上传时的阻塞

- 异步会话加载：将会话加载转换为异步功能，防止磁盘操作阻碍服务器

3、控制台、技能与系统

- 具页面样式：更新工具卡悬停效果、启用/禁用状态和状态指示器

- 容器检测：简化的容器检测逻辑，以实现更可靠的环境变量处理

- 内置技能提升：更新了docx、pdf、pptx、xlsx技能，包含更清晰的先决条件和新的pdf/forms和pptx/编辑文档;在文件操作中增加了 Home 目录支持，并为 shell 子进程启用了 venv Python

- 喜马拉雅邮件技能：通过附件处理文档和163条邮件配置说明更新了发送/写作支持。

- 内存文档重构：重新组织内存和上下文文档结构，更新 README 链接，并提升至 0.3.0.6b3

- 模型选择器样式：在聊天标题中固定模型选择器对齐以实现布局一致

- 配置与安全页面重构：重构代理配置和安全设置页面，布局更清晰，样式改进，响应更快

三、修复内容

1、频道修复

- DingTalk 认证失败清理：当认证失败时，DingTalk 通道现在会干净地关闭，正确取消主任务，而非依赖固定时间睡眠

- Discord 消息拆分：超过 Discord 2000 字符限制的消息在换行处自动拆分，保留 markdown 代码的界限

- 通道配置类型对齐：Matrix、Mattermost 和 MQTT 通道配置现在通过 API

2、平台兼容性

- Windows Shell 编码：Windows 上的 Shell 命令输出现在采用智能解码（先用 UTF-8，区域备份）以可靠处理混合编码输出

- Windows 进程清理：Windows 上的 Shell 命令执行现在能在超时时正确终止整个进程树，防止后代进程保持管道开启导致卡顿

- 桌面SSL和Windows：通过certifi修复了打包桌面应用中的SSL证书加载;运载火箭中保存的系统PATH;增加支持;Windows上的日志文件锁定和子进程输出阻塞问题已解决

- 桌面IME及导航：输入时已固定回车键提交聊天，启用系统浏览器中的外部URL打开，以及在网页视图中选择文本