Gitea Actions for Openclaw

A powerful integration to trigger, monitor, and manage Gitea or Forgejo Actions workflows directly through your AI agent.

qizhou-guo
v0.1.0
Feb 25, 2026
0
974
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install gitea-actions

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install gitea-actions 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 Actions?

The Gitea Actions skill enables seamless interaction with Gitea and Forgejo CI/CD pipelines. By leveraging the Gitea API, it allows developers and AI agents to automate workflow dispatches and query job statuses without leaving their development environment. As a key component of the Openclaw Skills ecosystem, it bridges the gap between AI-driven code generation and automated deployment pipelines.

Whether you are managing a self-hosted instance or a professional Forgejo setup, this skill provides the necessary endpoints to ensure your software delivery lifecycle is fully observable and controllable through simple commands.

Gitea Actions Use Cases

  • Triggering a deployment workflow automatically after code changes.
  • Checking the status of a specific CI/CD run to verify build success or failure.
  • Listing all recent workflow runs to audit repository activity and history.
  • Integrating automated testing triggers into complex AI agent workflows.

How Gitea Actions Works

  1. The skill initializes a connection to the Gitea instance using the configured GITEA_URL and GITEA_TOKEN.
  2. Based on the user or agent input, it selects one of three primary actions: dispatch, runs, or run.
  3. It sends an authenticated request to the Gitea API to execute the desired operation (e.g., triggering a .yml workflow file).
  4. The skill parses the response from the server and returns a structured output for the agent to process or display.

Gitea Actions Setup

To use this skill within the Openclaw Skills framework, you must configure your Gitea credentials as environment variables:

export GITEA_URL="http://your-gitea-instance:10000"
export GITEA_TOKEN="your_personal_api_token"

The skill can then be invoked via Node.js by referencing the local installation path: ~/.openclaw/skills/gitea-actions/index.js.

Gitea Actions Data Schema & Taxonomy

The skill utilizes the following input parameters to interact with the Gitea API:

Field Type Required Description
action string Yes The operation: dispatch, runs, or run.
owner string Yes The repository owner or organization.
repo string Yes The name of the repository.
workflow string No The specific workflow filename (e.g., main.yml).
ref string No The Git branch or tag (defaults to master).
runId number No The specific ID for a workflow run (required for 'run' action).

Gitea Actions Advanced Features

  • Full compatibility with both Gitea and Forgejo action runners.
  • Support for custom Git refs, allowing agents to trigger workflows on experimental branches.
  • Real-time status querying for individual runs to enable automated error recovery.
  • Highly modular design suitable for inclusion in multi-step Openclaw Skills automation sequences.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*