OpenClaw 集成 Agnes AI 完整教程,一句话生成图片和视频

你："帮我画一张赛博朋克城市夜景"      ↓小龙虾（理解意图）→ 调用 Agnes 生图 Skill      ↓Agnes API 生成图片 → 返回 URL      ↓小龙虾下载图片 → 保存到桌面/打开预览

macOS/Linux: ~/.openclaw/skills/Windows:     C:\Users\<用户名>\.openclaw\skills\

agnes-image-gen/├── skill.json          # Skill 元数据，Agent 靠这个识别你├── main.py             # 核心逻辑└── requirements.txt    # 依赖

{  "name": "agnes-image-gen",  "version": "1.0.0",  "description": "调用 Agnes AI 生成图片",  "author": "你的名字",  "entry": "main.py",  "triggers": [    "画一张",    "生成图片",    "帮我画",    "画个",    "出一张图"  ],  "config": {    "api_key": "",    "default_size": "1024x1024",    "default_style": "realistic"  }}

import osimport timeimport jsonfrom pathlib import Pathfrom urllib.request import urlopen, Request# 读取 Skill 配置CONFIG_PATH = Path(__file__).parent / "skill.json"with open(CONFIG_PATH, "r", encoding="utf-8") as f:    CONFIG = json.load(f)API_KEY = os.environ.get("AGNES_API_KEY") or CONFIG["config"]["api_key"]API_BASE = "https://apihub.agnes-ai.com/v1"def generate_image(prompt: str, size: str = None, style: str = None, output_dir: str = None) -> dict:    """调用 Agnes AI 生图 API，下载到本地"""    if not API_KEY:        return {"error": "AGNES_API_KEY 未设置，请在环境变量或 skill.json 中配置"}    size = size or CONFIG["config"]["default_size"]    style = style or CONFIG["config"]["default_style"]    try:        width, height = map(int, size.split("x"))    except ValueError:        return {"error": f"尺寸格式错误: {size}，请用 宽x高 如 1024x1024"}    # 默认保存到桌面    if not output_dir:        output_dir = os.path.expanduser("~/Desktop")    out_path = Path(output_dir) / f"agnes_img_{int(time.time())}.png"    # 调用 Agnes API    req = Request(        f"{API_BASE}/images/generations",        method="POST",        headers={            "Authorization": f"Bearer {API_KEY}",            "Content-Type": "application/json",        },        data=json.dumps({            "model": "agnes-image-2.1-flash",            "prompt": prompt,            "width": width,            "height": height,            "style": style,            "n": 1,        }).encode("utf-8")    )    try:        with urlopen(req, timeout=120) as resp:            data = json.loads(resp.read().decode())            img_url = data.get("data", [{}])[0].get("url", "")        if not img_url:            return {"error": "API 未返回图片链接"}        # 下载图片        with urlopen(img_url, timeout=60) as img_resp:            out_path.write_bytes(img_resp.read())        return {            "success": True,            "file_path": str(out_path),            "dimensions": f"{width}x{height}",            "style": style,            "prompt": prompt,        }    except Exception as e:        return {"error": str(e)}# Skill 入口：Agent 会调用这个函数def run(agent_context: dict) -> dict:    """Agent 传入的 context 包含用户原始输入和解析后的参数"""    prompt = agent_context.get("prompt", "")    size = agent_context.get("size")    style = agent_context.get("style")    output_dir = agent_context.get("output_dir")    result = generate_image(prompt, size, style, output_dir)    if result.get("success"):        return {            "message": f"图片已生成并保存到: {result['file_path']}",            "action": "open_file",            "file_path": result["file_path"],            "details": result,        }    else:        return {"error": result.get("error", "未知错误")}

# 标准库够用，不需要额外依赖# 如果后续需要异步，再加 aiohttp

# 写进 ~/.zshrc 或 ~/.bashrcexport AGNES_API_KEY="你的Key"

~/.openclaw/skills/agnes-video-gen/├── skill.json├── main.py└── requirements.txt

{  "name": "agnes-video-gen",  "version": "1.0.0",  "description": "调用 Agnes AI 生成视频",  "author": "你的名字",  "entry": "main.py",  "triggers": [    "生成视频",    "做一段视频",    "生成一段",    "帮我做视频",    "出一段视频"  ],  "config": {    "api_key": "",    "default_resolution": "720p",    "default_duration": 4,    "default_fps": 24  }}

import osimport timeimport jsonfrom pathlib import Pathfrom urllib.request import urlopen, RequestCONFIG_PATH = Path(__file__).parent / "skill.json"with open(CONFIG_PATH, "r", encoding="utf-8") as f:    CONFIG = json.load(f)API_KEY = os.environ.get("AGNES_API_KEY") or CONFIG["config"]["api_key"]API_BASE = "https://apihub.agnes-ai.com/v1"RESOLUTIONS = {    "480p": (854, 480),    "720p": (1280, 720),    "1080p": (1920, 1080),}def generate_video(prompt: str, duration: int = None,                   resolution: str = None, fps: int = None,                   output_dir: str = None) -> dict:    """调用 Agnes AI 生视频 API，轮询等待完成后下载"""    if not API_KEY:        return {"error": "AGNES_API_KEY 未设置"}    resolution = resolution or CONFIG["config"]["default_resolution"]    duration = duration or CONFIG["config"]["default_duration"]    fps = fps or CONFIG["config"]["default_fps"]    if resolution not in RESOLUTIONS:        return {"error": f"不支持的分辨率: {resolution}"}    width, height = RESOLUTIONS[resolution]    if not output_dir:        output_dir = os.path.expanduser("~/Desktop")    out_path = Path(output_dir) / f"agnes_vid_{int(time.time())}.mp4"    # 1. 创建视频任务    req = Request(        f"{API_BASE}/videos",        method="POST",        headers={            "Authorization": f"Bearer {API_KEY}",            "Content-Type": "application/json",        },        data=json.dumps({            "model": "agnes-video-v2.0",            "prompt": prompt,            "width": width,            "height": height,            "duration": duration,            "fps": fps,        }).encode("utf-8")    )    try:        with urlopen(req, timeout=30) as resp:            data = json.loads(resp.read().decode())            task_id = data.get("task_id", "")        if not task_id:            return {"error": "API 未返回 task_id"}        # 2. 轮询等待完成        print(f"⏳ 视频生成中，任务ID: {task_id}")        video_url = _poll_task(task_id)        # 3. 下载视频        print(f"✅ 生成完成，正在下载...")        with urlopen(video_url, timeout=120) as vid_resp:            out_path.write_bytes(vid_resp.read())        return {            "success": True,            "file_path": str(out_path),            "duration": f"{duration}s",            "resolution": resolution,            "fps": fps,            "prompt": prompt,        }    except Exception as e:        return {"error": str(e)}def _poll_task(task_id: str, max_wait: int = 600, interval: int = 5) -> str:    """轮询任务状态，最长等10分钟"""    elapsed = 0    while elapsed < max_wait:        req = Request(            f"{API_BASE}/videos/{task_id}",            headers={"Authorization": f"Bearer {API_KEY}"},        )        with urlopen(req, timeout=30) as resp:            data = json.loads(resp.read().decode())            status = data.get("status", "")            if status == "completed":                return data.get("output", {}).get("url", "")            if status == "failed":                raise RuntimeError(f"任务失败: {data.get('error', '未知错误')}")            progress = data.get("progress", 0)            if progress > 0:                print(f"  进度: {progress}%")        time.sleep(interval)        elapsed += interval    raise TimeoutError(f"任务 {task_id} 超时")def run(agent_context: dict) -> dict:    prompt = agent_context.get("prompt", "")    duration = agent_context.get("duration")    resolution = agent_context.get("resolution")    fps = agent_context.get("fps")    output_dir = agent_context.get("output_dir")    result = generate_video(prompt, duration, resolution, fps, output_dir)    if result.get("success"):        return {            "message": f"视频已生成: {result['file_path']}",            "action": "open_file",            "file_path": result["file_path"],            "details": result,        }    else:        return {"error": result.get("error", "未知错误")}

你：帮我画一张日落时分的海边灯塔虾：正在生成图片...虾：图片已生成并保存到: /Users/你的名字/Desktop/agnes_img_1735123456.png     [自动打开图片预览]

你：做一段樱花飘落的视频，5秒，1080p虾：⏳ 视频生成中，任务ID: vid_abc123虾：  进度: 30%虾：  进度: 60%虾：  进度: 90%虾：✅ 生成完成，正在下载...虾：视频已生成: /Users/你的名字/Desktop/agnes_vid_1735123789.mp4     [自动打开视频播放]

你：帮我画一张赛博朋克城市的概念图虾：[生成图片并打开]你：基于这张图的主题，做一段4秒的视频虾：理解，基于"赛博朋克城市"主题生成视频...     [自动调用视频 Skill，无需重复描述]

# 在 run() 返回前加一段from datetime import datetimetarget_dir = Path.home() / "Documents" / "Agnes生成" / datetime.now().strftime("%Y-%m")target_dir.mkdir(parents=True, exist_ok=True)out_path.rename(target_dir / out_path.name)return {"message": f"已保存到: {target_dir / out_path.name}"}