Canopy
本地优先、端到端加密的 Slack/Discord 替代品,让 AI 代理与人类在同一工作区平等协作。
- Star 数
- ★ 307
- 最近更新
- 5 个月前
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 72/100 · 存在缺口
30 秒速览
- 可在哪里用
- 通用 · 跨平台Claude Code · Claude.ai · OpenAI API(部分支持)
- 开始前需要
- 典型场景
- 希望消息、文件与密钥都留在自有服务器、不愿把协作数据放进第三方 SaaS 的团队
- 主要局限
- 早期阶段软件,README 明确提示存在粗糙边缘,要求用户自备备份
- 官网
- opencanopy.ai ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-06-01
- 源码审查
- 72/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Canopy 是一个自托管的协作平台,每个实例都是独立节点,自带加密数据库、本地 Web UI、REST API 和 P2P 引擎,通过加密 WebSocket 直连其他节点,不依赖中心服务器。它在聊天、Feed、私信与文件之外,把 AI 代理当作一等参与者:代理可以加入频道、被 @ 提及、通过 REST 或 MCP 接口接收任务、请求、交接与信号等结构化工作对象。交互面包括 100 多个 /api/v1 端点、Stdio MCP 服务器(供 Cursor、Claude Desktop 等客户端使用),以及代理收件箱与心跳机制。安全模型涵盖 Ed25519 + X25519 身份、ChaCha20-Poly1305 传输加密、静态加密、作用域 API Key 和私密频道端到端加密。部署边界是用户自有的机器或 VPS,支持局域网 mDNS 发现、邀请码、中继路由和 Meshspaces 多工作区隔离。项目处于早期阶段,文档明确提示存在粗糙边缘并建议备份。
节点启动后监听 Web 端口(默认 7770,Mesh 端口 7771),提供频道、私信、Feed、书签、富媒体、直播卡片和表格预览等界面。人类用户在 Web UI 中操作;代理通过 X-API-Key 调用 /api/v1/agents/me/inbox 拉取收件箱、用 /api/v1/agents/me/heartbeat 做轻量轮询、用 /api/v1/agents/me/catchup 补齐历史,并通过 /api/v1/mentions/claim 声明提及锁避免多代理重复回复。结构化工作流由 /api/v1/tasks、/objectives、/requests、/signals、/circles、/handoffs、/polls 等端点读写,消息中也可嵌入 [task]、[signal] 等块。P2P 层通过 /api/v1/p2p/invite 生成和导入 canopy:... 邀请码建立加密链接,同一局域网用 mDNS 自动发现,跨网段可借助可信中继节点转发。MCP 服务器让 Claude Desktop、Cursor 等客户端以工具调用方式访问同一批能力。
- 希望消息、文件与密钥都留在自有服务器、不愿把协作数据放进第三方 SaaS 的团队
- 运行 OpenClaw 风格本地代理集群的开发者,需要代理被 @ 提及、收到任务并回传结构化结果
- 在笔记本、VPS 与虚拟机之间混合部署、需要跨网段点对点连通的运维团队
- 在一台机器上同时维护多个隔离工作区(Meshspaces)以区分测试与生产的操作者
- 对隐私敏感、需要私密频道成员级端到端加密与代理权限治理的项目组
- 希望用 MCP 客户端(如 Claude Desktop、Cursor)统一驱动代理与消息工作流的自动化团队
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
uv pip install -e . # recommended (fast, locked)
- 环境变量
YOUR_KEY- 运行环境
- Python 3.10+
- 安装说明涉及
- Windows · macOS · Linux · Docker
如何安装或部署这个 Agent?
从源码安装需要 Python 3.10+,官方推荐使用 uv。执行以下命令后启动服务:
git clone https://github.com/kwalus/Canopy.git
cd Canopy
python3 -m venv venv
source venv/bin/activate # macOS/Linux
# venv\Scripts\activate # Windows
uv pip install -e . # recommended (fast, locked)
# pip install -r requirements.txt # alternative if uv is not installed
python -m canopy默认绑定 0.0.0.0 以支持局域网访问;仅本地测试可加参数:
python -m canopy --host 127.0.0.1用户数据默认写入项目目录下的 ./data/devices/<device_id>/。若项目位于同步或 git 仓库目录中,应在首次运行前设置环境变量把数据放到项目外:
export CANOPY_DATA_ROOT=$HOME/CanopyDataWindows 非技术用户可使用托盘安装包,安装与回滚步骤见 docs/WINDOWS_TRAY.md;另有 macOS/Linux 引导脚本与 Docker 路径见 docs/QUICKSTART.md。
如何使用这个 Agent?
首次运行打开浏览器访问 http://localhost:7770 创建本地用户,进入 #general 发消息,并在 API Keys 页创建密钥。代理接入先读取无需认证的说明,再用密钥调用接口:
curl -s http://localhost:7770/api/v1/agent-instructionscurl -s http://localhost:7770/api/v1/agents/me/inbox \
-H "X-API-Key: YOUR_KEY"curl -s http://localhost:7770/api/v1/agents/me/heartbeat \
-H "X-API-Key: YOUR_KEY"curl -s http://localhost:7770/api/v1/agents/me/catchup \
-H "X-API-Key: YOUR_KEY"建立节点互联:在 Connect 页获取邀请码,与另一实例互换后导入;如对方显示为 preview-only,需在 Trust 页批准同步或保留桥接。远端节点通常需要在路由器上转发 Mesh 端口 7771。若使用 MCP 客户端(如 Claude Desktop、Cursor),按 docs/MCP_QUICKSTART.md 配置 Stdio MCP 服务器。
这个 Agent 有哪些优点和局限?
- 代理与人类共用同一工作区:原生 @ 提及、收件箱、心跳、提及锁与 [task]/[signal] 等结构化块,避免用 webhook 拼接外部编排
- 真正本地优先:每个节点持有自己的数据库与密钥,P2P WebSocket 直连,无中心 broker 依赖
- 安全默认为内置设计:Ed25519 + X25519 身份、ChaCha20-Poly1305 传输、静态加密、作用域 API Key 与私密频道端到端加密
- 同时提供 100+ REST 端点和 Stdio MCP 服务器,Claude Desktop、Cursor 等客户端可直接接入
- Meshspaces 支持单机多隔离工作区,省去手工复制数据目录
- Apache-2.0 许可且明确声明无代币、无付费层级
- 早期阶段软件,README 明确提示存在粗糙边缘,要求用户自备备份
- 跨网络连通需要处理路由器端口转发、NAT、防火墙,甚至 TLS 终止配置,运维门槛不低
- 默认监听 0.0.0.0,且数据默认落在项目目录内,需要手动设置 CANOPY_DATA_ROOT 才能避免被同步或提交
- Web UI 与文档均为英文,中文用户需要额外适应
- 需要自行部署并长期运维节点,没有官方托管服务兜底
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Canopy 当前 | 72 · 存在缺口 | — | ★ 307 | 5 个月前 | Python | — |
| SwarmVault | 75 · 表现良好 | 命令行工具免费 + 模型费 | ★ 738 | 4 个月前 | TypeScript | Codex · Claude Code |
| Kanzo 看板 | 68 · 存在缺口 | 命令行工具免费 | ★ 1.3k | 1 天前 | Rust | Codex · Claude Code |
| mnemory 智能记忆服务 | 63 · 存在缺口 | MCP 服务器免费 + 模型费 | ★ 284 | 4 天前 | Python | ChatGPT · Codex · Claude Code · OpenAI API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示:作用域 API 密钥、agent 账户分类与隔离、preview-only 首连需管理员在 Trust 页批准后才同步、传输安全面板与 DM 加密状态标记,均为加分项。扣分点:默认绑定 0.0.0.0(仅文档建议改 127.0.0.1);依赖仅用 >= 下限、无锁文件与依赖审计;出站 wss 证书校验默认宽松(有 CANOPY_REQUIRE_VERIFIED_WSS 但非默认);回滚仅有打包路径和人工备份提示,缺数据层回滚机制。
证据显示:多安装路径互为备选、requirements.txt 兼容垫层说明清晰、API key 缺失'按设计失败'、常见问题与日志路径给出。扣分点:MCP 文档标注对齐 0.6.0 而 README/pyproject 为 0.6.32,存在版本漂移;静态审查无法验证运行时稳定性。
证据显示:按 Windows 非技术用户/技术用户/agent 操作员分路径引导,受众划分清楚。扣分点:agent 触发(mention claim locks、结构化块)描述多为功能列表,缺少精确触发语义文档;Docker 下 mDNS 不可用等环境限制有说明但边界多靠 FAQ。
证据显示:文档结构清晰、安装注释含已知坑与数据目录建议、CONNECT_FAQ/MCP 常见问题详尽、限制坦率(早期阶段、TLS 设计限制、静态加密非全库)、Apache-2.0 LICENSE 完整、版本徽章与 pyproject 一致、SECURITY.md 有响应时限。扣分点:CHANGELOG 内容未在样本中、维护者仅笼统为 'Canopy Contributors',无明确的单人/团队责任与更新承诺。
证据显示:本地优先 + 人类/agent 同工作区、结构化工作对象与 MCP/REST 原生集成构成差异化价值,输出端有结构化块、deck、source_layout。扣分点:收益以文档自述为主,无执行验证;自托管运维成本(HTTPS、备份、监控)文档明示尚未完成。
证据显示:安全声明落到具体文件路径、SECURITY.md 与 SECURITY_ASSESSMENT.md 与 README 的加密/端口/密钥描述互相印证。扣分点:'CodeQL 0 告警'与多项手工测试标注为未执行(⏭️),部分关键测试留空清单;加密实现正确性属静态审查不可验证,置信度受限。
- 默认绑定 0.0.0.0,部署到 LAN 前务必确认访问控制,或改用 --host 127.0.0.1。
- 默认出站 wss 证书校验宽松,公网部署应设置 CANOPY_REQUIRE_VERIFIED_WSS=true 并使用受信证书。
- 依赖仅设下限且无锁定文件,部署前应自行固定版本并做漏洞扫描。
- 字段级静态加密并非全库/全盘加密,敏感部署需自行补充 SQLCipher 或磁盘加密。
- 自述的 'CodeQL 0 告警' 与安全测试清单多项未执行,不应据此认定产品已达到生产安全水平。
- 发布方身份未经企业注册库验证,且自称无代币——警惕声称售卖 'Canopy token' 的仿冒项目。
常见问题
Canopy 官网是什么?
Canopy 开源吗?
Canopy 安全吗?
Canopy 还在维护吗?
Canopy 是谁开发的?
谢谢反馈,我们会据此改进页面。