通过 API 以编程方式触发 Gitea 和 Forgejo 的 workflow_dispatch 事件。
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install gitea-workflow-dispatch
2. 手动安装
将技能文件夹复制到以下位置之一
~/.openclaw/skills/ <project>/skills/ 优先级：工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 gitea-workflow-dispatch。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
更倾向于下载？
获取包含原生技能文件的ZIP压缩包。
什么是 Gitea 工作流调度？
Gitea 工作流调度技能是一款专门设计的工具，旨在通过编程方式在 Gitea 或 Forgejo 实例上触发 CI/CD 流水线。通过利用 Openclaw Skills，开发人员可以直接从本地环境或通过 AI 代理自动化仓库操作，如部署、构建和测试。这种集成简化了与自托管 Git 服务的交互，使其成为希望通过 Openclaw Skills 优化开发生命周期的团队的重要组件。
该技能充当了自动化工作流与 Gitea Actions 引擎之间的桥梁。它提供了一个简洁的界面用于分发事件，允许进行复杂的编排，其中外部触发器可以启动内部仓库流程，而无需手动 UI 操作。
Gitea 工作流调度 应用场景
- 从 CLI 环境手动触发部署工作流。
- 使用 Openclaw Skills 将 Gitea 自动化集成到更广泛的 AI 驱动开发工作流中。
- 通过 inputs 对象将动态参数传递给 Forgejo Actions 以进行自定义构建。
- 在实际执行前，使用 dry-run 功能验证 API 连接性和工作流路径。
Gitea 工作流调度 工作原理
- 使用个人访问令牌和实例 URL 对您的 Gitea 或 Forgejo 实例进行身份验证。
- 在 Openclaw Skills 参数中指定目标所有者、仓库和工作流文件。
- 定义 Git 引用（分支或标签）以及工作流所需的任何必要输入变量。
- 执行该技能以向 Gitea Actions API 端点发送安全的 POST 请求，从而触发 workflow_dispatch 事件。
Gitea 工作流调度 配置指南
要开始使用，请确保已安装 Node.js 并配置环境变量，以授予该技能访问您的 Gitea 实例的权限：
export GITEA_URL="http://your-gitea-instance-url"
export GITEA_TOKEN="your-api-token"
然后，您可以在 Openclaw Skills 框架内使用 Node.js 脚本调用该技能，以触发特定的仓库工作流。
Gitea 工作流调度 数据架构与分类体系
该技能需要一个包含以下元数据和参数的输入对象：
| 属性 | 类型 | 必填 | 描述 |
|---|---|---|---|
| owner | 字符串 | 是 | 仓库所有者或组织名称。 |
| repo | 字符串 | 是 | 目标仓库的名称。 |
| workflow | 字符串 | 是 | 工作流 YAML 文件的文件名（例如 deploy.yml）。 |
| ref | 字符串 | 否 | Git 分支或标签（默认为 master）。 |
| inputs | 对象 | 否 | 工作流特定输入的键值对。 |
| dryRun | 布尔值 | 否 | 模拟请求而不触发实际操作。 |
Gitea 工作流调度 高级特性
- 与 Forgejo 完全兼容，为基于 Gitea 的生态系统提供统一界面。
- 灵活的输入处理，允许在 Openclaw Skills 中进行复杂的多参数工作流配置。
- Dry-run 验证模式，可在不影响生产环境的情况下安全测试 API 负载和逻辑。
- 详细的响应报告，捕获 API 状态和成功标志，以实现稳健的错误处理。
SKILL.md
加载中
