šŸ¦žOpenClaw Guide
← All Integrations
šŸŽ«

Jira

Mediumā±ļø 15-20 minutes

AI Jira management via natural language

OpenClaw Jira Integration

Manage your Jira projects without leaving your messaging app. OpenClaw connects to the Jira REST API so you can create tickets, update sprints, track bugs, and manage your backlog through natural language.

Setup

Step 1: Create Jira API Token

  1. Go to id.atlassian.com/manage-profile/security/api-tokens
  2. Click "Create API token"
  3. Name it "OpenClaw" → copy the token

Step 2: Configure OpenClaw

yaml
integrations:  jira:    enabled: true    baseUrl: "https://your-org.atlassian.net"    email: "you@company.com"    apiToken: "your-jira-api-token"    defaultProject: "ENG"  # Project key

Creating Issues

bash
Create bug: Login fails on iOS 17, priority high, assign to @john→ Bug ENG-245 created, assigned to John āœ“Feature request: Add dark mode, add to Q2 backlog→ Story ENG-246 created in Q2 backlog āœ“Create a task: Update API documentation by Friday→ Task ENG-247 created, due Friday āœ“

Querying Issues

bash
What's blocking the sprint?→ 3 blockers: ENG-234 (waiting on design), ENG-238 (external dependency)...Show me John's open tickets→ 8 open tickets assigned to John. Oldest: ENG-201 (12 days)What did I close this week?→ 5 tickets closed: ENG-240, 241, 242...

Sprint Management

bash
What's in the current sprint?→ Sprint "Week 8" — 23 tickets: 12 in progress, 8 to do, 3 doneMove ENG-234 to the backlog→ Moved āœ“Add ENG-256 to current sprint→ Added to Sprint: Week 8 āœ“

Issue Updates

bash
Close ENG-245, add comment: Fixed in PR #267→ ENG-245 closed, comment added āœ“Change priority of ENG-238 to critical→ Priority updated āœ“Assign ENG-250 to sarah@company.com→ Reassigned āœ“

Team Reporting

bash
What's the sprint velocity this month?→ Sprints: Week 6 (34pts), Week 7 (28pts), Week 8 (in progress, 18pts so far)List all open bugs in the ENG project→ 14 open bugs. Critical: 2, High: 5, Medium: 7

Troubleshooting

Authentication error? Jira uses email + API token (not password). Verify both are correct.

Project not found? Use the project key (e.g., "ENG"), not the full name.

Permission denied? Ensure your account has permission to create/edit issues in that project.

Features

Issue creation

Create bugs, stories, tasks, and epics via natural language

Sprint management

Move issues, check velocity, and manage active sprints

Backlog queries

Search and filter issues by assignee, priority, and status

Issue updates

Update status, priority, assignee, and add comments

Team reporting

Sprint velocity, open bugs, and team workload at a glance

Workflow automation

Trigger issue transitions and notifications from chat

Use Cases

→

Bug reporting

Create bug tickets from Slack or Telegram without opening Jira

→

Sprint planning

Review and organize the backlog for upcoming sprints via chat

→

Daily standup

Get a status update on all open tickets before standup

→

PM reporting

Generate sprint summaries and velocity reports on demand

Setup Guide

Requirements

  • āœ“Jira Cloud account
  • āœ“Atlassian API token
  • āœ“OpenClaw running on a server or Mac
1

Create an Atlassian API token

Go to id.atlassian.com/manage-profile/security/api-tokens and create a new API token. Save it securely.

2

Get your Jira domain

Note your Jira Cloud URL (e.g., yourcompany.atlassian.net).

3

Configure OpenClaw

Add your Jira domain, email, and API token to the OpenClaw configuration.

4

Set up OAuth (optional)

For enhanced security, configure Atlassian OAuth 2.0 instead of API tokens. Create an OAuth app in developer.atlassian.com.

5

Test the connection

Ask your assistant 'What Jira projects do I have access to?' to verify everything works.

Configuration Example

jira:
  domain: \"yourcompany.atlassian.net\"
  email: \"you@company.com\"
  apiToken: \"your-atlassian-api-token\"
  # Or use OAuth:
  # oauth:
  #   clientId: \"your-oauth-client-id\"
  #   clientSecret: \"your-oauth-secret\"

Limitations

  • āš ļøJira Server/Data Center requires different authentication
  • āš ļøSome advanced features depend on your Jira project configuration
  • āš ļøLarge JQL result sets are summarized

Frequently Asked Questions

Does it work with Jira Server?

This integration is optimized for Jira Cloud. Jira Server/Data Center may work with API tokens but requires different configuration.

Can it access all my projects?

Access depends on your Jira permissions. Your assistant can access any project your account has access to.

How does natural language JQL work?

Your assistant understands queries like 'bugs created this week' and translates them to proper JQL (e.g., 'type = Bug AND created >= -7d').

Can it create subtasks and epics?

Yes, it supports all standard issue types including subtasks, epics, stories, tasks, and bugs.

Is my data secure?

OpenClaw runs on your infrastructure. Jira API calls go directly from your instance to Atlassian. No data passes through third-party services.

Can multiple team members use it?

Each user needs their own API token. For team deployments, consider OAuth with proper scopes for each user.

šŸ”„ Your AI should run your business, not just answer questions.

We'll show you how.Free to join.

Join Vibe Combinator →

šŸ™ Your AI should run your business.

Weekly live builds + template vault. We'll show you how to make AI actually work.Free to join.

Join Vibe Combinator →