SoloSmart Generate Image Plugin for OpenClaw
功能
为 OpenClaw 智能体提供 AI 图片生成能力，基于 SoloSmart API。
前置要求
- Node.js >= 22
- OpenClaw Gateway >= 2026.3.24-beta.2
- 已申请 SoloSmart
X-API-Key
安装
方式一：本地安装（开发调试）
openclaw plugins install ./SoloSmartGenerateImage
方式二：通过 ClawHub 安装
clawhub package publish ./SoloSmartGenerateImage --family code-plugin --dry-run clawhub package publish ./SoloSmartGenerateImage --family code-plugin
配置
在 openclaw.config.json 中添加： { "plugins": { "entries": { "solosmart-generate-image": { "enabled": true, "config": { "apiKey": "你的_X-API-Key", "apiBaseUrl": "https://solosmart-uat.issmart.com.cn" } } } } }
使用
安装并重启 Gateway 后，智能体即可调用 generate_image 工具。
示例对话：
用户：请帮我生成一张未来城市的图片 智能体：调用 generate_image，prompt 为 "霓虹灯下的赛博朋克城市， rainy night"
发布前检查清单
在重新执行 clawhub package publish 前，请确认：
| 检查项 | 要求 | 位置 |
|---|---|---|
openclaw.compat.pluginApi | 必需 | package.json → openclaw.compat.pluginApi |
openclaw.build.openclawVersion | 必需 | package.json → openclaw.build.openclawVersion |
openclaw.build.pluginSdkVersion | 建议填写 | package.json → openclaw.build.pluginSdkVersion |
openclaw.compat.minGatewayVersion | 建议填写 | package.json → openclaw.compat.minGatewayVersion |
注意：openclaw.build.openclawVersion 的值应与你本地安装的 OpenClaw 版本一致。可通过 openclaw --version 查看当前版本，若版本不同请相应修改。
推荐发布流程
1. 先 dry-run 预检，确认元数据完整
clawhub package publish ./SoloSmartGenerateImage --family code-plugin --dry-run
2. 无报错后再正式上传
clawhub package publish ./SoloSmartGenerateImage --family code-plugin
如果之前已经尝试发布过且版本号 1.0.0 被锁定，请将 package.json 中的 "version" 提升为 "1.0.1" 后重试。
插件文件结构
SoloSmartGenerateImage/ ├── openclaw.plugin.json # 插件清单（必需） ├── package.json # 包元数据（含 openclaw.build.openclawVersion） ├── index.ts # 插件入口（注册 generate_image 工具） └── README.md # 本文件
###API 说明
| 项目 | 说明 |
|---|---|
| 接口地址 | POST https://solosmart-uat.issmart.com.cn/ai-agent-backend/app-system-prompt/api/GenerateImage |
| 请求头 | Content-Type: application/json、X-API-Key: xxx |
| 请求体 | {"prompt": "描述文本"} |
| 响应体 | {"imageUrl": "图片链接"} |
常见问题 Q: 发布时提示 "软件包范围必须与选定的所有者匹配"？ A: 确保 package.json 中的 name 字段以你的 ClawHub 账号名开头，例如 @wolf521/openclaw-generate-image。 Q: 发布时提示 "缺少必需的 OpenClaw 软件包元数据：openclaw.build.openclawVersion"？ A: 在 package.json 的 openclaw 对象下添加 build.openclawVersion 字段，值与当前 OpenClaw 版本一致。
核心修正点对比
原文件（错误）：
```bash
openclaw plugins install ./SoloSmartGenerateImage
### 方式二：通过 ClawHub 安装 ← 这行被困在代码块里！
clawhub package publish ...