# 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)