jira

What This Skill Does

The Jira skill for OpenClaw provides a robust, command-line interface for interacting with Jira Cloud directly from your terminal or AI-driven workflow. It serves as a bridge between your project management environment and automated tasks, allowing you to search for issues, update task statuses, log time, and create new tickets without switching browser tabs. By utilizing the Jira Cloud REST API, this skill streamlines development velocity through automation, ensuring that issue tracking remains in sync with your actual work progress. Whether you are performing quick lookups, managing complex transitions, or generating detailed time-tracking reports for invoicing and internal audits, this skill acts as a powerful backend operator for your Jira instance.

Installation

Installation is straightforward using the OpenClaw ecosystem. First, ensure your environment has curl, jq, bc, and python3 installed, as these are critical dependencies for parsing API responses and calculating time logs. To install the skill, run the command clawhub install openclaw/skills/skills/kyjus25/clawdbot-jira-skill. After installation, configure the required environment variables: JIRA_EMAIL, JIRA_API_TOKEN, and JIRA_URL. Optionally, you can set JIRA_BOARD to restrict your operations to a specific project, which helps reduce API noise and speeds up search operations.

Use Cases

This skill is ideal for developers who need to keep their focus on the command line while maintaining compliance with agile workflows. Common use cases include:

1. Automated Status Updates: Instantly move tasks to 'In Progress' or 'Done' as part of a deployment pipeline.
2. Time Tracking: Quickly log hours spent on specific tasks after completing a coding session.
3. Quick Audits: Retrieve reports on team output or personal workload using the hours-day or hours-issue subcommands.
4. Context Switching: Retrieve issue details or links while debugging, ensuring you have the exact requirements at your fingertips.

Example Prompts

1. "OpenClaw, can you search for any open issues related to payment failures and give me the status of the first one?"
2. "Please log 2 hours for task ABC-123 for today and add a comment that the API integration is complete."
3. "Show me all issues assigned to me, and then give me a summary of my logged hours for this week."

Tips & Limitations

• Security: Since this tool uses API tokens, ensure your environment files are strictly protected and never committed to public repositories.
• Scope: If you have access to dozens of Jira boards, always set the JIRA_BOARD environment variable to prevent slow global search queries.
• Reporting: The hours reports rely on local shell calculations using bc; ensure your environment has this installed, or the time-summation features will fail.
• Transitions: If a status move fails, use the transitions command to verify that the specific transition you are requesting is actually available for that issue's current state.