Files

80 lines
3.1 KiB
Markdown

# 1-h Tools (`1h-tools`)
OpenClaw 统一私有扩展插件集合,聚合了自定义 Agent 工具、媒体生成驱动(视频/图像,支持 OpenAI 与 Gemini 双协议)以及内置技能库。
各模块采用**就近同构原则(Co-location)**维护其独立代码、测试与文档,避免全局单页膨胀与文档漂移。
---
## 包含模块清单
| 模块类别 | 标识符 (ID) | 契约类型 | 协议支持 | 说明 | 详细文档 |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **视频生成** | `1h-openai-video` | `videoGenerationProviders` | OpenAI `/v1/videos` | OpenAI 格式视频生成驱动(支持自建网关 / gemini-web2api / Sora 协议) | [查看文档 →](src/video/README.md) |
| **图像生成 (OpenAI)** | `1h-openai-image` | `imageGenerationProviders` | OpenAI `/v1/images` | OpenAI 格式图像生成驱动(支持 gpt-image-2 等,修复 16:9 尺寸 Bug 与 URL 模式) | [查看文档 →](src/image/README.md) |
| **图像生成 (Gemini)** | `1h-gemini-image` | `imageGenerationProviders` | Gemini `:generateContent` | Gemini 原生图像生成驱动(专职适配 gemini-3.1-flash-image,秒级出图) | [查看文档 →](src/image/README.md) |
| **基础工具** | `echo` | `tools` | Tool Plugin | 基础测试与连通性回显工具 | [查看文档 →](src/tools/README.md) |
| **内置技能** | `agent-access` | `skills` | OpenClaw Skill | Bitwarden Agent Access 自动化技能 | [查看技能 →](skills/agent-access/SKILL.md) |
---
## 安装与更新
### 安装插件
在 OpenClaw Gateway 主机上执行:
```bash
openclaw plugins install git:https://git.1-h.cc/OpenClaw/openclaw-plugin-tools.git --force --acknowledge-install-policy-warning --accept-capabilities
```
### 插件更新
当 Gitea 仓库有新提交时,在终端执行:
```bash
openclaw plugins update 1h-tools
```
### 开发与验证
```bash
# 运行单元测试
pnpm test
# 编译 TypeScript 产物
pnpm run build
```
---
## 项目结构
```text
openclaw-plugin-tools/
├── openclaw.plugin.json # 插件统一清单与契约配置
├── package.json # 包元数据与入口定义
├── README.md # 根目录索引导航
├── src/
│ ├── index.ts # 插件注册统一入口
│ ├── index.test.ts # 统一注册测试
│ ├── types.d.ts # Plugin SDK 补充类型定义
│ ├── tools/ # 工具模块集合
│ │ ├── echo.ts
│ │ └── README.md # 📍 工具专属说明
│ ├── video/ # 视频生成驱动模块
│ │ ├── openai.ts # 1h-openai-video 驱动实现
│ │ └── README.md # 📍 视频驱动专属说明
│ └── image/ # 图像生成驱动模块集合
│ ├── openai.ts # 1h-openai-image 驱动实现
│ ├── gemini.ts # 1h-gemini-image 驱动实现
│ └── README.md # 📍 图像驱动专属说明
└── skills/ # 官方规范就近内置技能
└── agent-access/
└── SKILL.md # 📍 技能自描述文件
```
---
## License
[MIT](LICENSE)