OpenTag

这是什么？适合谁？

OpenTag 是一个开源的 Agent 协作平台，让你在 Slack、GitHub、GitLab、Linear 或 Lark 中 @ 任一 ACP 编码 Agent（Claude Code、Codex、Cursor 等），Agent 在本地执行任务后自动在对话线程中回复验证结果。

适合人群：开发团队（尤其是使用 Slack/GitHub 协作的团队）、技术管理者、需要将 AI Agent 集成到日常工作流的工程师。 使用前提：Node.js 22+，本地安装至少一个 ACP Agent（Claude Code / Codex / Cursor），Slack/GitHub 等平台的管理员权限（用于创建 App/Bot）。

快速上手（3 步）

第一步：安装 OpenTag

npm install -g opentag

或从源码安装：

git clone https://github.com/amplifthq/opentag
cd opentag
npm install
npm run build

第二步：配置平台连接

OpenTag 支持多种平台，以 Slack 为例：

1. 在 Slack API 页面创建一个 App，启用 Bot Token Scopes
2. 将 Bot Token 配置到 OpenTag：

opentag config set slack.token xoxb-your-token
opentag config set slack.signing-secret your-secret

3. 启动 OpenTag 服务：

opentag start

第三步：在对话中 @Agent

在 Slack 频道中发送消息：

@opentag 帮我审查这个 PR 的代码质量，重点检查安全漏洞和性能问题

OpenTag 会调用本地配置的 Agent 执行任务，完成后在对话线程中回复结果。

初级用法

场景一：PR 代码审查

配置 OpenTag 监听 GitHub 仓库的 PR 事件，每次新 PR 自动触发代码审查：

1. 在 GitHub 仓库设置 Webhook 指向 OpenTag
2. 配置审查规则（检查项、严重级别）
3. Agent 自动审查并在 PR 下评论

场景二：Issue 自动分类

让 Agent 自动分析 GitHub Issues 并打标签：

1. 配置 Issue 创建事件的触发规则
2. 定义分类标准（bug/feature/enhancement）
3. Agent 读取 Issue 内容，自动添加标签和优先级

场景三：Slack 按需问答

团队成员在 Slack 中直接提问技术问题，Agent 在本地执行代码验证后回答：

• “这个 SQL 查询有什么性能问题？”
• “帮我写一个 Python 脚本处理这个 CSV 文件”
• “这段代码的单元测试覆盖率怎么样？“

高级玩法

多 Agent 路由

OpenTag 支持根据任务类型自动路由到不同 Agent：

routing:
  - pattern: "代码审查|review"
    agent: claude-code
  - pattern: "测试|test"
    agent: codex
  - pattern: "文档|document"
    agent: cursor

自定义 Agent 插件

OpenTag 支持 ACP 协议，你可以开发自己的 Agent 插件：

1. 实现 ACP 协议接口
2. 注册到 OpenTag 插件目录
3. 在路由配置中引用

安全沙箱

为防止 Agent 误操作，OpenTag 提供安全沙箱：

• 限制 Agent 可访问的文件路径
• 拦截危险命令（rm -rf、sudo 等）
• 操作前需人工确认

常见踩坑（5 条）

踩坑 1：Slack 消息延迟

• 现象：@Agent 后 30 秒以上才收到回复
• 原因：Agent 执行耗时任务（如大型代码库分析）
• 解决：配置超时时间，超时后返回进度提示而非一直等待

踩坑 2：Agent 本地环境不一致

• 现象：Agent 在本地能运行但队友无法复现
• 原因：各成员本地 Node.js 版本、依赖版本不同
• 解决：使用 Docker 统一 Agent 运行环境，在 OpenTag 配置中指定 Docker 镜像

踩坑 3：GitHub Webhook 签名验证失败

• 现象：OpenTag 日志显示 Webhook 验证失败
• 原因：GitHub Webhook Secret 配置不一致
• 解决：确认 GitHub 仓库设置和 OpenTag 配置中的 Secret 完全一致

踩坑 4：Agent 回复过长被截断

• 现象：Slack 消息中 Agent 回复被截断
• 原因：Slack 单条消息有 40000 字符限制
• 解决：配置 OpenTag 自动将长回复拆分为多条消息或上传为文件

踩坑 5：API 费用不可控

• 现象：Agent 调用频繁导致 API 费用超出预期
• 原因：未设置速率限制和费用上限
• 解决：在 OpenTag 中配置每日 API 调用上限和成本告警

FAQ（5 个常见问题）

Q1：OpenTag 免费吗？ A：完全开源免费（MIT 协议）。仅需承担 Agent 的 API 调用费用和服务器运行成本。

Q2：支持哪些 Agent？ A：支持所有兼容 ACP（Agent Client Protocol）的 Agent，包括 Claude Code、Codex CLI、Cursor CLI、Gemini CLI 等。可通过插件扩展。

Q3：数据安全吗？ A：Agent 在本地执行，代码不会上传到第三方服务器。OpenTag 仅作为消息路由层，不存储你的代码。建议生产环境使用 HTTPS 和 Webhook Secret。

Q4：和 GitHub Copilot 有什么区别？ A：Copilot 是 IDE 内代码补全工具，OpenTag 是团队协作场景下的 Agent 调度平台。OpenTag 可以调用 Copilot 背后的 Agent，但侧重于异步协作而非实时编码。

Q5：支持私有部署吗？ A：完全支持。OpenTag 是自托管服务，你可以部署在自己的服务器上，无需依赖任何外部服务。

小技巧（5 条）

1. 使用 Markdown 模板：在 Slack 中创建消息模板，包含标准的 Prompt 前缀，提高 Agent 回复质量
2. 配置 Agent 白名单：限制哪些成员可以 @Agent，防止滥用
3. 监控 Agent 使用量：通过 OpenTag 仪表盘查看每个成员的 Agent 调用频率和成本
4. 定期审查 Agent 输出：每周抽查 Agent 回复质量，调整 Prompt 模板
5. 设置工作时段：配置 Agent 只在工作时间响应，避免深夜 API 调用浪费

进阶学习建议

掌握 OpenTag 后，你可以：

• 将 OpenTag 与 CI/CD 集成，实现自动化代码审查流水线
• 开发自定义 Agent 插件，对接内部工具（Jira、Confluence 等）
• 使用 OpenTag 的 Webhook 机制实现跨平台事件驱动自动化
• 结合 ACP 协议扩展更多 Agent 类型

参考链接

• OpenTag GitHub 仓库
• ACP 协议规范

本文基于公开资料于 2026-08-14 整理，社区指标反映 GitHub 公开数据。独立实测未进行，功能和配置项可能随版本更新而变化，请以官方文档为准。