安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install banger
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 banger。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

操作公司邮箱可将 AI 编程代理连接到 Banger，后者是公司电子邮件的权威记录系统。此技能通过 MCP 支持 Mailboxes、Product email、Broadcasts、Journeys、联系人、模板、域名、集成、送达能力、Approvals 和 Logs，同时让人工人员与代理基于相同的工作区状态协同工作。
采用此工作流程的 Openclaw Skills 优先考虑证据、用户意图和安全执行：代理会检查所选产品、遵循 Banger 保存的引导状态、尊重授权边界，并在报告成功前验证更改。起草和规划与发送或实施始终是不同的操作；Journey 激活和域名迁移等敏感操作仍须获得规定的人工批准。

应用场景

为新的或尚未完成设置的 Banger 工作区完成引导，并配置其品牌、域名和 Mailboxes。
创建、读取和管理公司 Mailboxes、标签及分流规则。
起草或发送 Product email，并准备、安排或管理 Broadcast。
构建并审核用于引导、激活、留存或挽回用户的自动化 Journeys。
安全导入联系人、映射字段、尊重退订状态，并创建受众或注册表单。
配置并验证发送域名、排查送达问题，并检查发送状况。
根据现有产品和业务背景规划电子邮件增长，不提前实施计划。
出现运营问题时检查集成、webhooks、账单限制、Approvals 和 Logs。

工作原理

在浏览器中使用 OAuth 将客户端连接到 Banger 的 MCP 服务器；绝不会在聊天中索取凭据。
使用 banger_list_products 检查可用产品。如果存在多个产品，请让用户选择一个，并在每项相关操作中使用其 product_id。
判断请求属于引导设置、具体运营任务，还是仅制定增长计划。如果设置是新的或尚未完成，则打开已保存的引导工作流程。
根据需要读取 Banger 中的权威状态和必需对象，包括品牌、受众、域名、就绪情况或发送健康信息。
说明相关选项和边界，然后只执行用户请求或批准的操作。明确区分草稿、跳过、发送和批准。
使用 Banger 受治理的工具和不可变执行回执进行更改。首次激活或发生实质性更改后的 Journey 激活，以及域名迁移，均须遵循具体的人工授权要求。
修改后重新读取权威状态。报告哪些内容已保存、排队、安排、发送、受阻或等待审核；未经确认，不得声称已送达或已验证。
以结果、下一项已获批准的操作，以及需要用户处理的任何依赖项作为总结。

配置指南

在客户端的 MCP 设置中添加 Banger 的远程 MCP 服务器，并通过浏览器 OAuth 流程登录。无需 API key，且不得在聊天中分享密码或令牌。

MCP server URL to add in the client's settings

https://api.bangermail.com/mcp
按照 https://bangermail.com/banger-mcp/ 上针对客户端的说明操作。如果没有可用的 banger_* 工具，请让用户先完成此连接，再尝试电子邮件操作。
对于新的或尚未完成设置的工作区，首先调用 banger_onboarding_open_setup，并遵循 Banger 当前保存的课程。继续已完成的工作，不要从头重来。
操作前选择正确的产品。只有在用户确认需要隔离时才创建单独的产品；不得根据电子邮件地址、域名、代码库或记忆推断产品身份。
仅完成用户选择的设置步骤：连接 AI、配置 Brand，以及可选的域名配置。使用 Banger 托管邮件不需要域名。
设置域名时，使用 Banger 发现的权威 DNS 记录，提供完整的记录计划，并仅在所有记录均已保存后进行验证。替换现有电子邮件设置需要在 Banger 中获得指定管理员的授权。
正常引导期间不要发送连接测试邮件。仅当用户明确要求可选诊断时，才使用 banger_onboarding_send_agent_test。

数据架构

Banger 是受治理的权威记录系统；此技能读取并更新工作区的权威状态，而不是维护单独的本地电子邮件数据库。
Scope or object Organization and evidence
Workspace 每个连接对应一个已授权工作区。使用 banger_get_workspace 确认其名称和所有者；访问其他工作区需要重新授权。
Products 电子邮件资源由 product_id 限定。按产品隔离 Mailboxes、受众、域名、Broadcasts 和 Journeys。
Onboarding 已保存的工作流程状态包括当前课程、指导、可用操作和缺失的设置。域名设置依次经过 Connect、Verify 和 Add inboxes。
Brand and designs 产品品牌设置包括身份和电子邮件样式。模板和电子邮件设计通过 Banger 工具保存；预览显示实际保存的电子邮件。
Contacts and audiences 导入使用映射后的列、验证结果、订阅状态和 BCP 47 区域标记。列表和细分群体不会自动产生同意。
Domains and DNS 使用 Banger 提供的权威域名记录集和验证状态。DNS 传播与验证结果分别跟踪。
Activity and approvals 不可变执行回执、待处理操作、Approvals 和 Logs 可作为更改及待审核事项的证据。
Integrations Webhooks 和 API keys 在 Banger 中管理。重试非幂等创建操作前，先检查现有资源。
此技能不会仅凭尝试执行操作就宣称成功：它会重新读取已保存状态，并区分已保存、排队、已安排、已发送、已送达、受阻和等待审核。

高级特性

按产品限定操作，避免意外混用品牌、受众、域名或电子邮件工作流程。
引导式设置在浏览器和 MCP 客户端中使用相同的已保存工作流程，并在支持的情况下提供交互式设置卡片。
Journey 治理要求首次激活前以及发生实质性更改后进行人工审核；未更改且已审核的 Journeys 可在获批范围内继续运行。
域名防护涵盖权威 DNS 指引、异步验证、现有服务商检测，以及经管理员批准的迁移。
联系人导入防护会映射字段、标记含义不明确的列、验证记录并保留退订状态。
电子邮件设计工作流程支持入门模板、结合品牌的自定义设计、已保存的预览和迭代反馈。
Broadcast 就绪情况和受众检查有助于在发送前发现阻碍；不可逆删除或取消操作需要用户确认。
分流工作流程支持规则预览、标签管理，以及对错误分流操作进行撤销。
集成处理会保护凭据，在不确定是否重试前检查现有 webhooks 或 API keys，并验证 webhook 证据。
发送健康检查会在恢复发送或重新激活 Mailbox 前显示退信和投诉信号。
增长规划可将获准使用的公司背景综合为按优先级排序、可供审核的计划，但不会将计划视为实施授权。

name: operate-company-email description: Operate Banger's canonical company-email system through MCP. Use when onboarding or configuring Banger; creating or reading mailboxes; sending Product email or Broadcasts; managing contacts, audiences, designs, Journeys, domains, connections, approvals, deliverability, or Logs; or finding email growth opportunities from product and business context.