Trigger Gitea and Forgejo workflow_dispatch events programmatically via the API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gitea-workflow-dispatch
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install gitea-workflow-dispatch using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Gitea Workflow Dispatch?
The Gitea Workflow Dispatch skill is a specialized tool designed to programmatically trigger CI/CD pipelines on Gitea or Forgejo instances. By utilizing Openclaw Skills, developers can automate repository actions like deployments, builds, and tests directly from their local environment or through an AI agent. This integration simplifies interaction with self-hosted git services, making it a vital component for teams looking to optimize their development lifecycle through Openclaw Skills.
This skill acts as a bridge between your automated workflows and the Gitea Actions engine. It provides a clean interface for dispatching events, allowing for complex orchestration where external triggers can initiate internal repository processes without manual UI interaction.
Gitea Workflow Dispatch Use Cases
- Manually triggering a deployment workflow from a CLI environment.
- Integrating Gitea automation into a broader AI-driven developer workflow using Openclaw Skills.
- Passing dynamic parameters to Forgejo Actions via the inputs object for custom builds.
- Validating API connectivity and workflow paths using the dry-run capability before live execution.
How Gitea Workflow Dispatch Works
- Authenticate with your Gitea or Forgejo instance using a personal access token and the instance URL.
- Specify the target owner, repository, and workflow file within the Openclaw Skills parameters.
- Define the git reference (branch or tag) and any necessary input variables required by the workflow.
- Execute the skill to send a secure POST request to the Gitea Actions API endpoint to trigger the workflow_dispatch event.
Gitea Workflow Dispatch Setup
To get started, ensure you have Node.js installed and configure your environment variables to grant the skill access to your Gitea instance:
export GITEA_URL="http://your-gitea-instance-url"
export GITEA_TOKEN="your-api-token"
You can then invoke the skill within the Openclaw Skills framework using a Node.js script to trigger your specific repository workflows.
Gitea Workflow Dispatch Data Schema & Taxonomy
The skill expects an input object with the following metadata and parameters:
| Property | Type | Required | Description |
|---|---|---|---|
| owner | string | Yes | The repository owner or organization name. |
| repo | string | Yes | The name of the target repository. |
| workflow | string | Yes | The filename of the workflow YAML file (e.g., deploy.yml). |
| ref | string | No | The git branch or tag (defaults to master). |
| inputs | object | No | Key-value pairs for workflow-specific inputs. |
| dryRun | boolean | No | Simulates the request without triggering the action. |
Gitea Workflow Dispatch Advanced Features
- Full compatibility with Forgejo, providing a unified interface for Gitea-based ecosystems.
- Flexible input handling allowing for complex, multi-parameter workflow configurations within Openclaw Skills.
- Dry-run validation mode to safely test API payloads and logic without affecting production environments.
- Detailed response reporting that captures API status and success flags for robust error handling.
SKILL.md
Loading
Related Openclaw Skills
Gitea Actions
A powerful integration to trigger, monitor, and manage Gitea or Forgejo Actions workflows directly through your AI agent.
Sentry-AI
A multi-chain meme coin scanner and security auditor designed to detect rugs and scams on Solana and Base.
Meta AI Search (秘塔AI搜索)
A professional AI-driven search skill optimized for Chinese language understanding and structured data retrieval.
Video Gen AI Skill
An advanced AI video generation skill leveraging ByteDance's Doubao Seedance model to transform text, images, and audio into cinematic video content.
AI Paper Digest
An automated research assistant that fetches and filters the latest AI papers from arXiv and HuggingFace for your daily workflow.
Estimate Builder
A Python-powered engine for generating detailed, professional construction project estimates with categorized cost breakdowns and automated markup calculations.
Featured*
