← Back to Skills Marketplace
31
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install agnespaint
Description
调用 Agnes AI 免费 API 生成图片/视频。从 AGNES_API_KEY 环境变量读取密钥。
README (SKILL.md)
Agnes画影 — Agnes AI 多模态创作
Keywords
多模态生成、图片生成、视频生成、Agnes AI、API 调用
Summary
调用 Agnes AI 免费全模态 API，据用户描述生成图片或视频，返回结果 URL。
Strategy
- 意图识别 — 用户要图片还是视频（默认图片）
- 确认 Prompt — 向用户复述并确认描述
- 调 API — 按类型调用对应端点，视频需轮询
- 返结果 — 返回 URL，询问是否继续
AVOID
- 勿将 API Key 暴露在日志或 prompt 中
- 勿高频轮询视频接口（间隔 ≥10 秒）
- 勿一次生成多张图/多个视频而未先问用户
- 勿假设视频同步返回——必须轮询至 complete
- 勿假设用户使用 zsh——每次配置前须侦测 OS 与 shell
- 勿在 Windows 上使用 Linux 路径语法（如 ~/.zshrc）
前置条件
AGNES_API_KEY环境变量（运行时自动侦测 OS 与 shell，见下方配置步骤）- API 基础地址：
https://apihub.agnes-ai.com/v1
获取 API Key
| 步骤 | 操作 |
|---|---|
| 1 | 打开 platform.agnes-ai.com，注册/登录 |
| 2 | 左侧导航 → API Keys → Create API Key |
| 3 | 复制生成的 sk- 开头密钥 |
| 4a | 侦测环境：uname -s 判 OS，echo $SHELL 判 shell |
| 4b | 配置命令（据上一步结果选择）：\x3Cbr>• Linux/macOS + zsh → echo 'export AGNES_API_KEY="sk-..."' >> ~/.zshrc && source ~/.zshrc\x3Cbr>• Linux + bash → echo 'export AGNES_API_KEY="sk-..."' >> ~/.bashrc && source ~/.bashrc\x3Cbr>• macOS + bash → echo 'export AGNES_API_KEY="sk-..."' >> ~/.bash_profile && source ~/.bash_profile\x3Cbr>• Windows + PowerShell → Add-Content -Path $PROFILE -Value '$env:AGNES_API_KEY="sk-..."'\x3Cbr>• 其他环境 → 询问用户其 shell 配置文件名 |
| 5 | 验证：curl -s https://apihub.agnes-ai.com/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer $AGNES_API_KEY" -d '{"model":"agnes-2.0-flash","messages":[{"role":"user","content":"hi"}]}'，返回含 choices 即成功 |
工作流
1. 识别意图
| 用户说 | → 操作 |
|---|---|
| "画/生成图片/做张图……" | 图片 |
| "生成视频/短片/短视频……" | 视频 |
| 未明确 | 默认图片，可反问确认 |
2. 确认 Prompt（Human-in-the-Loop）
向用户展示你要发送的描述文字，确认后再调 API。
3. 调用 API
详细参数与 curl 示例见 modules/01-api-reference.md。
快速参考：
| 能力 | 端点 | 模型名 |
|---|---|---|
| 图片 | POST /v1/images/generations |
agnes-image-2.0-flash |
| 视频 | POST /v1/video/generations |
agnes-video-v2.0（带 v） |
- 图片：从响应
.data[0].url取 URL - 视频：异步任务，轮询
.data.status至completed，从.data.remixed_from_video_id取 URL
4. 返回结果
展示 URL，问用户"还要再生成吗？"
使用示例
用户：画一只在云朵上睡觉的柴犬，治愈风
→ 确认 Prompt → 调图片 API → 返回图片 URL
用户：做一段赛博朋克城市夜景，5 秒
→ 确认 Prompt → 调视频 API → 轮询至完成 → 返回视频 URL
Usage Guidance
Install only if you are comfortable sending generation prompts to Agnes AI under your own API key. Avoid placing secrets or personal data in prompts, and be aware that the suggested shell-profile setup stores AGNES_API_KEY persistently until you remove it.
Capability Tags
Capability Assessment
Purpose & Capability
The stated purpose, API endpoints, API-key requirement, prompt confirmation, and image/video generation workflow are coherent. Bash access is broader than ideal but is used in the artifacts for curl calls, environment detection, and setup guidance rather than hidden or unrelated behavior.
Instruction Scope
The trigger phrases include generic image/video generation terms, so the skill may activate for ordinary generation requests, but those requests match the skill's purpose and the workflow requires prompt confirmation before API calls.
Install Mechanism
The package contains only markdown skill instructions and an API reference, with no executable install script or dependency package behavior. Static scan and VirusTotal telemetry are clean.
Credentials
Use of Agnes AI's external API and the AGNES_API_KEY credential is proportionate to the skill's purpose and disclosed through endpoints and curl examples, though the documentation could more plainly warn that prompts and request data leave the local environment.
Persistence & Privilege
The skill documents persistent shell-profile edits to store AGNES_API_KEY. This is user-visible setup behavior, not stealth persistence, but users should understand it stores a credential in their shell profile until removed.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agnespaint - After installation, invoke the skill by name or use
/agnespaint - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
运行时自动侦测 OS 与 shell，按环境给出对应配置指令
v1.1.0
首次发布：支持图片/视频/文本多模态生成
Metadata
Frequently Asked Questions
What is Agnes画影?
调用 Agnes AI 免费 API 生成图片/视频。从 AGNES_API_KEY 环境变量读取密钥。 It is an AI Agent Skill for Claude Code / OpenClaw, with 31 downloads so far.
How do I install Agnes画影?
Run "/install agnespaint" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Agnes画影 free?
Yes, Agnes画影 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Agnes画影 support?
Agnes画影 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Agnes画影?
It is built and maintained by fslong (@fslong520); the current version is v1.1.1.
More Skills