ClawHub

agclaw

API key required
Other

AppGrowing 智能广告素材分析助手，对接探索模式，自动化分析用户意图，查找最符合需求的广告素材并自动化解析，让用户直接和素材对话。触发：关键词 投放分析、分析素材、素材分析、素材解析；命令 /agclaw

Install

openclaw skills install agclaw

agclaw

AppGrowing 智能广告素材分析助手，对接探索模式 API，可自动化分析用户意图，查找最符合客户需求的广告素材并完成自动化解析，让用户直接和素材对话。

权限说明

仅对 AppGrowing 策略版、游戏 plus 版、至尊版 用户开放。获取API Key方式：登录 AppGrowing → 个人中心 → 企业信息。

触发方式

  • 关键词：投放分析、分析素材、素材分析、素材解析
  • 命令：/agclaw → 调用Skill，进入探索模式
  • ⚠️ 触发行为准则：当用户意图明显是触发 agclaw 时，直接执行分析流程，不要解释系统机制。 例如用户输入 /agclaw 后收到平台报错、或说"帮我用 agclaw 分析"，应立即进入执行流程（检查Key→调API→返回结果），而不是解释为什么 /agclaw 不是斜杠命令或 Skill 如何工作。用户要的是结果，不是教程。

执行流程

  1. 检查API Key（从环境变量读取）：

    • 读取环境变量 YOUCLOUD_API_KEY：
      • 有值 → 继续
      • 为空 → 提示用户配置： 
        请先配置API Key：
1. 登录 AppGrowing → 个人中心 → 企业信息 获取API Key
2. 设置为环境变量 YOUCLOUD_API_KEY，例如：
   - Linux/macOS: export YOUCLOUD_API_KEY="your-key-here"
   - Windows: $env:YOUCLOUD_API_KEY="your-key-here"
3. 配置完成后重新发送请求即可。
    • ✅ 规则：没有有效 API Key，绝不发送请求

  2. ⚠️ 强制红线规则（公共Skill必须严格遵守）

    • API 请求超时为 600秒
    • 🔴 绝对禁止：未到超时时间不得中断请求，不得提前给用户发送任何「正在处理」「需要等待」「结果出来后告诉你」这类消息
    • 必须：一直等待API返回结果，拿到完整结果后再一次性回复给用户
    • 只有两种情况允许发消息：
      1. API返回了完整分析结果 → 直接输出结果
      2. API超时/请求报错 → 输出错误提示

  3. 调用API：

    • 新的分析请求 → 开启新会话，不携带 session_id，仅传 input
    • 跟进提问（关于之前的分析） → 复用之前的 session_id，仅传 input
    • 响应返回后直接展示结果。

API Specification

  • URL: https://aichat-appgrowing-cn.youcloud.com/aichat/ag/claw
  • Method: POST JSON
  • Headers: Authorization: Bearer {KEY}, Content-Type: application/json
  • Parameters:
    • input: User question (required)
    • session_id: For follow-up questions, omit for new conversations
  • Response: JSON {"session_id":"...", "output":"..."} — 提取 output 中的 output 字段（markdown）原样输出，不要修改；保存 session_id 用于后续追问
  • Timeout: ≥600s
  • 💡 调用方式：以当前运行环境选用调用方式，PowerShell 调用模板仅作为 powershell 环境下调用的最佳方式。

PowerShell 调用模板

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$apiKey = $env:YOUCLOUD_API_KEY
$body = @{input="Your analysis request"} | ConvertTo-Json -Compress
$params = @{
  Uri = "https://aichat-appgrowing-cn.youcloud.com/aichat/ag/claw"
  Method = "Post"
  ContentType = "application/json; charset=utf-8"
  Headers = @{Authorization="Bearer $apiKey"}
  Body = $body
  TimeoutSec = 600
}
Invoke-RestMethod @params | Select-Object -ExpandProperty output

错误处理

  • 401/认证失败： 
    API Key 认证失败，请检查密钥是否激活/过期？请在 AppGrowing 个人中心-企业信息 获取Api Key，或向售后人员咨询。
  • 超时："还在分析中，稍后再问我结果或者再次请求。"
  • 其他错误："请求返回错误 (code={code})，请检查API Key权限、账号配额或联系客服"