电子邮件签名

安装指南

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

什么是

Email Signature 可帮助 AI 智能体在所有外发邮件中一致地使用用户保存的 Signatoro 签名。在起草或发送邮件之前，智能体会获取签名，并将其 HTML 或纯文本版本附加到邮件正文之后，因此用户无需记得提出添加签名的要求。此 Openclaw Skills 集成支持 Signatoro MCP 服务器或 REST API。
此技能还可防止虚构发件人信息：姓名、职务、电话号码、电子邮件地址和链接必须来自 Signatoro 的 sender 数据。如果签名服务不可用或返回错误，智能体会按照既定的回退行为处理并告知用户，而不是捏造签名。

应用场景

通过 Gmail、Outlook、SMTP 或邮件 API 发送新邮件前添加已保存的签名。
起草、回复或转发邮件时添加正确的签名。
如果无法确定预期的发件人，可在用户、AI 助手或公司智能体的签名之间进行选择。
适合使用简短姓名、职务行和链接时，使用简短签名变体。
处理凭据缺失、身份不可用、没有已保存的签名或请求配额限制时，不得虚构发件人信息。

工作原理

每次起草、回复、转发或发送电子邮件之前，检查 Signatoro MCP 工具是否可用。
如果可用，为该邮件调用 get_signature，并在每次操作时重新获取签名。如果无法确定预期身份，则调用 list_signatures，请用户选择，并将所选项传递给 get_signature。
如果 MCP 不可用，但已设置 SIGNATORO_API_KEY，则使用环境变量中的密钥向 Signatoro REST 端点请求签名。
在空行之后，将返回的 html 附加到 HTML 正文，或将 text 附加到纯文本正文。按返回内容使用签名，不要另外添加结束敬语或签名块。
用户个人信息仅使用 sender 中提供的值。省略缺失的值并告知用户，不要猜测。
如果两种集成都不可用，或错误导致无法获取签名，则遵循文档规定的回退方式：不添加签名块并发送邮件，同时通知用户。

配置指南

将 Email Signature 技能添加到 AI 智能体可用的技能中。
配置 Signatoro MCP 服务器及其 get_signature 工具（如果可用，也配置 list_signatures），或者将 REST API 密钥设为 SIGNATORO_API_KEY 环境变量。
将 API 密钥保存在环境变量中；不要在输出、日志、文件或对话中泄露。
如果使用 REST API，请通过以下方式获取签名：
curl -s https://signatoro.com/api/v1/signature \ -H "Authorization: Bearer $SIGNATORO_API_KEY" 确认用户在 Signatoro 中保存了签名。如果没有可用的 MCP 工具或 API 密钥，该技能会引导用户访问 https://signatoro.com/docs/install-signature/agent。来源未指定软件包管理器或安装命令。

数据架构

该技能从 Signatoro 获取签名数据；它不定义本地存储格式，也不生成持久文件。
字段或选项 用途
html 用于 HTML 电子邮件正文的签名内容。
text 用于纯文本电子邮件正文的签名内容。
sender 权威的发件人详细信息，例如姓名、职务、电话、电子邮件或链接。仅使用提供的值。
signature 可选的 MCP/API 选择项，用于指定某个 AI 助手或公司智能体的签名。
mode=short REST API 选项，返回姓名、职务行和一个链接。
choices 当 API 响应报告签名未知时所引用的选择项。
REST 端点为 GET https://signatoro.com/api/v1/signature。API 密钥通过 Authorization: Bearer 标头提供，必须保密。

高级特性

每封邮件都重新获取签名，而不是依赖可能过时的已保存副本。
同时支持 Signatoro MCP 工具和 REST API 回退方案。
可通过列出可用签名并询问用户来区分 AI 助手或公司智能体的签名。
支持 REST API 的
mode=short
选项，并可通过智能体 ID 或名称选择签名。
根据格式插入签名：HTML 签名用于 HTML 正文，纯文本签名用于纯文本正文。
明确处理 API 错误：遇到 401 时停止并通知用户；遇到 403、429 或凭据不可用时，不添加签名并通知用户；未保存签名时省略签名；签名选择无效时使用可用选项。
考虑内置 Gmail 和 Outlook 助手工具会剥离图片的情况：在这些工具中使用文本签名；如果必须保留签名图片，则通过 Gmail API
messages.send
或 SMTP 进行原始 MIME 发送。

name: email-signature description: Before sending, replying to, forwarding or drafting any email for the user, with any mail tool (Gmail, Outlook, SMTP or a mail API), fetch their saved email signature from Signatoro and append it after the body. Use it every time you are about to send or draft an email, even when the user does not mention a signature. Works with the Signatoro MCP server (get_signature, list_signatures) or the REST API (GET https://signatoro.com/api/v1/signature with SIGNATORO_API_KEY). license: MIT