NoClick

描述一个 Agent。看着它被构建出来。让它运行。
以 AI Agent 为核心的开源工作流自动化——可视化画布、约 160 种集成，以及真正能使用你的工具的编码 Agent。

网站 · 文档 · 自托管 · Discord · 参与贡献

快速开始

一行命令：

# macOS / Linux / Windows in WSL2 -- needs Docker: https://docs.docker.com/get-docker/
curl -fsSL https://noclick.com/install.sh | sh

也可以手动操作——效果相同，过程一目了然：

git clone --branch <tag> https://github.com/noclickapp/noclick.git && cd noclick
./scripts/noclick-setup.sh
NOCLICK_VERSION=<version> docker compose up -d

每种安装方式都会获取最新版本的源代码，生成此实例的密钥——包括凭据加密密钥，该密钥会在重复运行时保留——并拉取该版本的镜像：首次下载约需 1.5 GB，且不会在你的机器上编译任何内容。重新运行即可原地更新。使用 NOCLICK_REF=<tag> 固定版本，版本可在 发布页面查看； NOCLICK_REF=main 则运行开发分支。前端镜像按默认本地 URL 构建，因此使用其他公开 URL 安装时会自行构建该镜像；而 NOCLICK_BUILD=1 会从检出目录构建所有内容。所有安装选项均记录在 install.sh 的开头。

然后打开 http://localhost:3000 进入编辑器。

如果要从克隆的仓库运行，就像参与 NoClick 项目开发时那样，请先安装 Docker、Supabase CLI、Python 3.12、Node.js 20+ 和 pnpm，然后运行：

pip install -r requirements.txt
make local

---

什么是 NoClick？

NoClick 让你在可视化画布上构建自动化，并通过触发器运行它们—— webhook、计划任务、收件邮件，或来自 Slack、WhatsApp 等应用的聊天消息。它的特别之处在于 Agent 层：AI Agent 节点可以驱动真正的编码环境（Claude Code、Codex、opencode、hermes、OpenClaw），并将你连接的集成作为工具调用，这样 Agent 就能读取 Linear 问题、在 git 仓库中工作，并将结果发回 Slack。

此仓库包含整个平台，基于 AGPL 开源：工作流引擎、所有集成节点、React 编辑器、实时协作层、AI 工作流构建器，以及一个 MCP 服务。它与运行 noclick.com 的代码相同，并且可以在你自己的机器上端到端运行，所有功能均不受限制。

你可以构建什么

• 在画布上构建自动化 — 将约 160 种集成（Slack、Gmail、Notion、 Linear、HubSpot、Stripe、Postgres、Google Sheets、……）与分支、 迭代、筛选器和代码节点串联起来。
• 触发器 — webhook、cron 计划任务、收件邮件，以及来自 Slack/Discord/HubSpot 的应用事件；可以在对话发生的地方回复的频道式 Agent，每个工作流可按需配置多个触发器。
• 配备真实工具的 AI Agent — 将集成节点接入 Agent 的工具接口，它就能直接调用相应操作。Agent 节点既可以在进程内运行（支持任何兼容 OpenAI/Anthropic/OpenRouter 的模型），也可以通过你安装的 CLI 作为编码环境运行。
• 界面 — 在任何工作流上发布表单、仪表板或聊天界面。
• 借助 AI 构建 — 描述你的需求，构建器就会在画布上组装工作流。它也通过 MCP 提供，因此你可以让 Claude Code（或任何 MCP 客户端）连接到你的实例并代你构建。

工作原理

1. 描述需求。 在构建器中输入你的需求，或者让任何 MCP 客户端连接到你的实例，由编码 Agent 来描述。
2. 构建器组装工作流。 节点会出现在画布上，并连接到真实操作；它只会询问真正需要的信息：凭据，以及只有你才能做出的选择。
3. 通过触发器运行。 消息到达、webhook 触发、计划任务运行时，工作流就会执行，Agent 会调用工具，并将结果发送到你指定的位置。每次运行都会记录工具调用、耗时和 Agent 的响应，让你准确了解发生了什么。

自托管

上方的安装程序是最快的部署方式。若要进行正式部署——配置自己的 Postgres、对象存储、集成用的 OAuth 应用、模型提供商，以及各组件所需的环境变量——请阅读**自托管指南**。

上方的部署按钮无需任何配置：Railway 和 Render 会在经过审查的发布镜像旁创建 Postgres 数据库（DigitalOcean 会绑定一个你需要预先创建的、名为 noclick-db 的托管集群），实例会在首次启动时完成其余工作——运行自己的身份验证层、准备数据库并生成自己的密钥。Railway 使用 railway.template.json，Render 使用 render.yaml，DigitalOcean 使用 .do/deploy.template.yaml，Fly 使用 fly.toml。关于每种部署方式会配置什么，以及密钥的存放位置，请参阅**托管部署指南**。

运行的是发布版本：每次上游合并都会更新 main，标签代表有意发布的版本，每个标签都会将镜像发布到 GHCR，因此 compose 堆栈会拉取镜像而非构建镜像。使用 NOCLICK_VERSION 固定版本。

从源代码构建

先决条件：Docker、Supabase CLI、 Python 3.12（暂不支持 3.13——部分固定版本的 wheel 无法在其上构建）、 Node.js 20 或更高版本，以及 pnpm 10.34.4（运行包脚本也可使用 npm）。

pip install -r requirements.txt
make local

这会在你的机器上启动所有服务——本地 Supabase（Postgres、身份验证、 存储）、后端和前端——并输出一个 URL。使用任意邮箱注册；本地身份验证会立即确认。无需云账户或 API 密钥， 即可打开运行中的画布。

# Backend
cd backend && python server.py       # or: uvicorn server:web_app
pytest                               # test suite

# Frontend
cd frontend && npm run dev
npm run typecheck && npm run build && npm test

# Database migrations
cd infra && supabase migration up --local

架构

路径	内容
backend/nodes/	所有集成节点——每个服务一个模块，并包含自描述的配置架构
backend/wss/	Socket.IO 事件层：处理程序、类型化事件、工作流执行引擎
backend/coder/workflow/	XML 工作流 DSL、图状态和 AI 构建器
backend/mcp_server.py	MCP 服务，可向任何 MCP 客户端开放工作流构建功能
backend/utils/	共享服务：Webhook、凭据、存储、中继、cron
frontend/app/	Remix + Vite 应用：ReactFlow 画布、配置面板、界面构建器
infra/supabase/	数据库迁移
sdk/	用于嵌入已发布工作流的 noclick TypeScript SDK

节点配置界面由后端的 Pydantic 模型生成，因此添加集成通常只需编写一个 Python 模块——编辑器会自动识别。

NoClick Cloud

noclick.com 是托管平台。它运行此引擎以及托管基础设施：保留 Agent 运行时，让各轮交互能够即时恢复；扩展 Webhook 和 cron 投递能力；提供额外的托管构建器功能，以及托管存储和电子邮件服务。可自托管版本与云端共用相同的工作流格式，因此工作流可以在两者之间原样迁移；云端的运营层则为开源引擎提供资金支持。

贡献

欢迎提交问题和拉取请求。添加集成节点是最简单的入门方式：复制 backend/nodes/ 中最接近的现有节点，在 backend/nodes/core/registry.py 中注册它，配置界面便会自动生成。

CONTRIBUTING.md 介绍了你需要了解的架构，以及此代码库要求遵循的约定。AGENTS.md / CLAUDE.md 为编码 Agent 提供相同的指导，因此让 Claude Code 或 Codex 处理一份代码库副本，就能获得可用的修改，而不只是看似合理的修改。

欢迎来 Discord 打个招呼——这是最快获得问题答复的方式。

许可证

NoClick Community 根据 GNU Affero 通用公共许可证第 3 版（AGPL-3.0-only）开源。你可以在工作场所或任何其他地方运行、修改并自行托管它。Fork 前值得了解的唯一条件是：如果你修改 NoClick，并通过网络让其他人使用修改后的版本，就必须按照相同许可证向他们提供其源代码。这一条件确保 NoClick 及其分支保持开源。

sdk/typescript 和 sdk/python 中的 SDK 采用 Apache-2.0 许可证，因此你基于它们构建的组件、外部应用和脚本不受 AGPL 义务约束；任何通过 NoClick 的 HTTP 或 MCP API 与其通信的内容也不受该义务约束。你使用 NoClick 编写的工作流、函数和组件归你所有：许可证覆盖的是 NoClick 本身，而不是你用它创作的内容。

需要以其他条款使用 NoClick，例如将其嵌入不想开源的产品中？可通过 [email protected] 获取商业许可证。名称和徽标受商标政策约束，而非许可证约束。v0.2.12 及之前的版本仍按随附的 Sustainable Use License 1.0 提供。本节仅为摘要；以 LICENSE 为准。