Canopy

本地优先、端到端加密的 Slack/Discord 替代品,让 AI 代理与人类在同一工作区平等协作。

源仓库
kwalus/Canopy
Star 数
★ 307
最近更新
5 个月前
License
Apache-2.0
主语言
Python

30 秒速览

可在哪里用
通用 · 跨平台Claude Code · Claude.ai · OpenAI API(部分支持)
开始前需要
Python 3.10+uv(推荐)pip(备选)Shell / 命令行网络访问本地文件系统MCP Server
典型场景
希望消息、文件与密钥都留在自有服务器、不愿把协作数据放进第三方 SaaS 的团队
主要局限
早期阶段软件,README 明确提示存在粗糙边缘,要求用户自备备份
官网
opencanopy.ai ↗ 来自 GitHub 仓库设置
维护状态
近半年有提交最近提交 2026-06-01

这个 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 等客户端以工具调用方式访问同一批能力。

  1. 希望消息、文件与密钥都留在自有服务器、不愿把协作数据放进第三方 SaaS 的团队
  2. 运行 OpenClaw 风格本地代理集群的开发者,需要代理被 @ 提及、收到任务并回传结构化结果
  3. 在笔记本、VPS 与虚拟机之间混合部署、需要跨网段点对点连通的运维团队
  4. 在一台机器上同时维护多个隔离工作区(Meshspaces)以区分测试与生产的操作者
  5. 对隐私敏感、需要私密频道成员级端到端加密与代理权限治理的项目组
  6. 希望用 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/CanopyData

Windows 非技术用户可使用托盘安装包,安装与回滚步骤见 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-instructions
curl -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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
72/ 100 五分制 3.6 / 5
信任安全 19/29
可靠稳定 9/14
适用触发 14/18
规范维护 16/18
有效结果 9/13
证据核验 5/8
查看各维度的扣分理由
信任安全19 / 29 · 3.3/5

证据显示:作用域 API 密钥、agent 账户分类与隔离、preview-only 首连需管理员在 Trust 页批准后才同步、传输安全面板与 DM 加密状态标记,均为加分项。扣分点:默认绑定 0.0.0.0(仅文档建议改 127.0.0.1);依赖仅用 >= 下限、无锁文件与依赖审计;出站 wss 证书校验默认宽松(有 CANOPY_REQUIRE_VERIFIED_WSS 但非默认);回滚仅有打包路径和人工备份提示,缺数据层回滚机制。

可靠稳定9 / 14 · 3.2/5

证据显示:多安装路径互为备选、requirements.txt 兼容垫层说明清晰、API key 缺失'按设计失败'、常见问题与日志路径给出。扣分点:MCP 文档标注对齐 0.6.0 而 README/pyproject 为 0.6.32,存在版本漂移;静态审查无法验证运行时稳定性。

适用触发14 / 18 · 3.9/5

证据显示:按 Windows 非技术用户/技术用户/agent 操作员分路径引导,受众划分清楚。扣分点:agent 触发(mention claim locks、结构化块)描述多为功能列表,缺少精确触发语义文档;Docker 下 mDNS 不可用等环境限制有说明但边界多靠 FAQ。

规范维护16 / 18 · 4.4/5

证据显示:文档结构清晰、安装注释含已知坑与数据目录建议、CONNECT_FAQ/MCP 常见问题详尽、限制坦率(早期阶段、TLS 设计限制、静态加密非全库)、Apache-2.0 LICENSE 完整、版本徽章与 pyproject 一致、SECURITY.md 有响应时限。扣分点:CHANGELOG 内容未在样本中、维护者仅笼统为 'Canopy Contributors',无明确的单人/团队责任与更新承诺。

有效结果9 / 13 · 3.5/5

证据显示:本地优先 + 人类/agent 同工作区、结构化工作对象与 MCP/REST 原生集成构成差异化价值,输出端有结构化块、deck、source_layout。扣分点:收益以文档自述为主,无执行验证;自托管运维成本(HTTPS、备份、监控)文档明示尚未完成。

证据核验5 / 8 · 3.1/5

证据显示:安全声明落到具体文件路径、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' 的仿冒项目。
证据充分度:低 评估于 2026年11月21日 审查版本 0d959f3bfbe3
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/canopy.svg?lang=zh)](https://followagents.com/zh/agents/canopy)
<a href="https://followagents.com/zh/agents/canopy"><img src="https://followagents.com/badge/canopy.svg?lang=zh" alt="FARS 评测"></a>

常见问题

Canopy 官网是什么?
Canopy 的 GitHub 仓库填写的官网是 https://opencanopy.ai/。这个链接由仓库作者设置;源码在 GitHub(kwalus/Canopy)。
Canopy 开源吗?
开源。源码在 GitHub(kwalus/Canopy),许可证是 Apache-2.0。
Canopy 安全吗?
FollowAgents 的 FARS 评审(2026年11月21日)给 Canopy 的“信任与安全”打了 19/29 分。评审检查的 8 项安全措施没有完全缺失的。
Canopy 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-06-01,在最近半年内,但不在最近 30 天内。
Canopy 是谁开发的?
Canopy 由 GitHub 账号 kwalus 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念