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 ...