项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1416
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Docker Compose(用于启动 Control Plane 与内置 PostgreSQL)
- PostgreSQL:使用仓库 Compose 配置自带的 profile,无需单独安装
- 一个 Slack 可以访问的公网 HTTPS 域名(作为 Control Plane 入口)
- 按 .env.example 完成所有占位符替换所需的自有配置与密钥
安装与启动步骤
-
1克隆项目仓库
把 OpenTag 源码拉到本地,后续所有部署命令都在该仓库目录内执行。
git clone https://github.com/amplifthq/opentag.git -
2进入部署目录
部署所需的环境变量模板与 compose 配置都放在 deploy/compose 目录内。
cd opentag/deploy/compose -
3生成环境变量文件
从模板复制出一份 .env,后续只需修改这份文件,不要直接改模板。
cp .env.example .env -
4填写配置与密钥
把 .env 里所有占位符替换为真实值,并按官方文档创建 Slack 与 relay-content 的文件式密钥。
-
5构建并启动服务
必须在上一步完成后执行;该命令会构建镜像并拉起 Control Plane 及内置 PostgreSQL。
docker compose --env-file .env up --build
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
.env | 是 | 由 .env.example 复制而来,其中所有占位符都必须替换为真实值 | /your/path/opentag/deploy/compose/.env |
file-backed secrets | 是 | 按文档创建的 Slack 与 relay-content 文件式密钥,供 Control Plane 读取 | /your/path/secrets/slack-secret |
如何确认成功
观察 docker compose 启动日志无报错,并确认 Slack 能通过配置好的公网 HTTPS 地址访问到自托管 Control Plane。
常见问题
Q:配对的电脑离线时还能用吗?
A:可以。在 Slack 中 @ 代理会把任务排队,等 Runner 就绪后再通过 ACP 调用本地编码代理,并在原线程回报状态与证据。
Q:我的源码会被上传到服务器吗?
A:不会。源码、本地 checkout 与 worktree、编码代理的登录态和 GitHub 凭证都留在 Runner 上,Control Plane 只保存协作信息。
Q:部署前必须准备什么?
A:Docker Compose、Compose 内置 profile 提供的 PostgreSQL、一个 Slack 可访问的公网 HTTPS 地址,以及填好的 .env 密钥文件。
Q:可以只用 OpenAI 之外的编码代理吗?
A:可以。OpenTag 通过 ACP 接入主流编码代理(如 Claude Code、Codex、Cursor 等),由 Runner 侧自行选择。
注意事项
- 执行 docker compose up --build 之前,务必先替换 .env 中所有占位符,否则服务无法正常启动。
- Control Plane 必须暴露在 Slack 可访问的公网 HTTPS 地址上,否则 Slack 无法回传消息。
- Slack 凭证与 Control Plane 服务凭证放在 Control Plane 侧,代码与代理会话留在 Runner 侧,注意两者不要混放。
核心亮点
- 本地执行代码,避免云端泄露敏感代码,安全可控
- 原生支持 Slack、GitHub、GitLab、Linear、Lark 五大协作平台,覆盖面广
- 基于 ACP 协议,可灵活接入 Claude Code、Codex、Cursor 等多种代理,不锁定单一厂商
不足之处
- 依赖 ACP 协议生态,非 ACP 代理接入需要额外适配
- 文档/社区待观察
适用场景
- 开发团队在 Slack 中快速请求代码审查或修复,无需切换工具
- 远程协作时,通过 GitHub/GitLab 评论触发本地代理执行任务
- 在 Linear 或 Lark 中管理任务时,直接调用编码代理生成实现方案
替代项目
Cody (Sourcegraph)、Continue、Aider
同类项目推荐
ai-orchestrator
开源
用 Bash 编排本地多 AI 角色,自动完成开发全流程
Portable multi-agent AI developer setup for Claude Code + Ollama. Role-based local L···
sandboxd
开源
一条命令自托管,AI 智能体在沙箱里帮你把应用跑起来
Open-source, self-hosted AI app builder — an agent builds real apps in isolated san···
jarvis_ai
开源
自托管钢铁侠语音助手,语音指挥智能体,HUD 实时反馈
Iron-Man-style voice assistant + holographic HUD for Hermes Agent. Local Whisper STT···
ai-developer-with-sandbox
开源
在安全沙箱里,让 AI 帮你写代码、跑测试
AI Developer is an AI agent powered by GPT-4-Turbo that's using custom E2B Sandbox
cherry-studio
开源
一个客户端搞定多模型聊天和 AI 智能体,开箱即用
Your AI workspace for models, agents, and productivity.
OpenShell
开源
给自主智能体套上安全沙箱,放心跑命令
OpenShell is the safe, private runtime for autonomous AI agents.
flue
开源
让 AI 智能体在沙箱里安全动手干活
The sandbox agent framework.
Aivatar-Demo
开源
代码写累了抬头看,AI 伙伴就在桌面上陪你。
Aivatar is a local-first desktop companion for AI coding agents. It turns Codex, Cla···
go-agent
开源
用 Go 构建带图记忆和多智能体协作的生产级 AI 应用
An agent framework for Go with graph-aware memory, UTCP-native tools, and multi-agen···
