AI SaaS Agent

该技能将用户消息转发至 AI SaaS Agent，并返回其响应。它通过使用用户的渠道名称与用户标识符组合成会话键（session key），为每位用户维护独立的对话上下文。

必需配置

以下环境变量必须在 ~/.openclaw/openclaw.json 文件中，置于 skills.entries.amernet-ai-saas.env 节点下：

端点解析（向后兼容）。 一次性计算出 ${TARGET} 路径片段，随后在以下所有请求中复用：

• 若设置了 AI_SAAS_AGENT_ID → ${TARGET} = agents/${AI_SAAS_AGENT_ID}（推荐方式，适用于当前平台）。
• 否则，若设置了旧版 AI_SAAS_CHATBOT_ID → ${TARGET} = chatbots/${AI_SAAS_CHATBOT_ID}（已弃用）。

消息路由

当用户通过任一已接入渠道发送任意消息时：

1. 识别当前渠道名称（例如：whatsapp、telegram、slack、discord）以及该渠道下用户的唯一标识符（电话号码、用户 ID 或用户名）。

2. 构造 sender_id，格式为：:

   • WhatsApp 示例：whatsapp:+15551234567
   • Telegram 示例：telegram:123456789
   • Slack 示例：slack:U012AB3CD
   • Discord 示例：discord:123456789012345678

3. 向 Agent API 发起 POST 请求：

POST ${AI_SAAS_BASE_URL}/api/v1/${TARGET}/chat
Authorization: Bearer ${AI_SAAS_API_KEY}
Content-Type: application/json

{
  "sender_id": "",
  "message": ""
}

4. 从 JSON 响应中解析 data.reply 字段，并将其作为回复消息返回给用户。

5. 若 API 返回错误或不可达，则回复：“抱歉，AI 助理当前暂时不可用，请稍后再试。”

对话重置

若用户明确输入 “reset”、“start over”、“clear chat” 或 “/reset”：

DELETE ${AI_SAAS_BASE_URL}/api/v1/${TARGET}/conversations/
Authorization: Bearer ${AI_SAAS_API_KEY}

随后确认回复：“对话已清空。请问有什么可以帮您？”

状态检查

若用户输入 “/status” 或 “/ping”：

GET ${AI_SAAS_BASE_URL}/api/v1/${TARGET}
Authorization: Bearer ${AI_SAAS_API_KEY}

返回 Agent 名称及其是否处于激活状态。

AI Growth Engine（AutoPilot）指令

当用户消息涉及 AI Growth Engine / AutoPilot 时（例如：“deploy autopilot”、“turn on the healthcare autopilot”、“what's my growth engine status”、“is autopilot ready”、“pause autopilot”、“how are my campaigns doing”），请勿将该消息发送至上述默认 Agent，而应路由至 Growth Engine 助理：

POST ${AI_SAAS_BASE_URL}/api/v1/drip-agent/chat
Authorization: Bearer ${AI_SAAS_API_KEY}
Content-Type: application/json

{
  "sessionId": "",
  "mode": "customer",
  "message": ""
}

解析 data.reply 并返回给用户。响应中还可能包含 data.toolCalls（即助理执行的操作列表，例如 “Deployed autopilot …”），您可以从中提取简短确认信息并呈现给用户。

重要提示：部署或暂停 AutoPilot 是真实操作。助理将首先向用户确认具体 Pipeline —— 请如实转达该确认提问，并仅在用户明确回复“yes”后，再发送后续确认请求。若部署被阻塞（例如缺少前置条件），请将助理返回的具体原因如实传达给用户。