/install clawdbot-jira-skill
Jira Skill
Work with Jira issues and worklogs from Clawdbot (search, status, create, log work, worklog summaries).
Setup
- Get your API key: https://id.atlassian.com/manage-profile/security/api-tokens
- Click "Create API Token"
- Set environment variables:
export JIRA_EMAIL="[email protected]" export JIRA_API_TOKEN="your-api-token" export JIRA_URL="https://your-domain.atlassian.net" # Optional project scope (comma-separated). Empty = search all. export JIRA_BOARD="ABC"
Requires curl, jq, bc, and python3.
Quick Commands
All commands live in {baseDir}/scripts/jira.sh.
{baseDir}/scripts/jira.sh search "timeout" [max]— fuzzy search by summary or key insideJIRA_BOARD{baseDir}/scripts/jira.sh link ABC-123— browser link for an issue{baseDir}/scripts/jira.sh issue ABC-123— quick issue details{baseDir}/scripts/jira.sh status ABC-123 "In Progress"— move an issue (validates available transitions){baseDir}/scripts/jira.sh transitions ABC-123— list allowed transitions{baseDir}/scripts/jira.sh assign ABC-123 "name or email"— assign by user search{baseDir}/scripts/jira.sh assign-me ABC-123— assign to yourself{baseDir}/scripts/jira.sh comment ABC-123 "text"— add a comment{baseDir}/scripts/jira.sh create "Title" ["Description"]— create a Task inJIRA_BOARD{baseDir}/scripts/jira.sh log ABC-123 2.5 [YYYY-MM-DD]— log hours (defaults to today UTC){baseDir}/scripts/jira.sh my [max]— open issues assigned to you{baseDir}/scripts/jira.sh hours 2025-01-01 2025-01-07— your logged hours by issue (JSON){baseDir}/scripts/jira.sh hours-day 2025-01-07 [name|email]— logged hours for a day grouped by user/issue; optional filter (name/email; also resolves to accountId){baseDir}/scripts/jira.sh hours-issue ABC-123 [name|email]— logged hours for an issue; optional filter (name/email; also resolves to accountId)
Command Reference
-
Search issues
{baseDir}/scripts/jira.sh search "payment failure" [maxResults] -
Issue link
{baseDir}/scripts/jira.sh link ABC-321 -
Issue details
{baseDir}/scripts/jira.sh issue ABC-321 -
Update status
{baseDir}/scripts/jira.sh status ABC-321 "Done" -
List transitions
{baseDir}/scripts/jira.sh transitions ABC-321 -
Assign issue
{baseDir}/scripts/jira.sh assign ABC-321 "Jane Doe" -
Assign to yourself
{baseDir}/scripts/jira.sh assign-me ABC-321 -
Add comment
{baseDir}/scripts/jira.sh comment ABC-321 "Deployed to staging" -
Create issue
{baseDir}/scripts/jira.sh create "Fix auth timeout" "Users being logged out after 5m" -
Log hours
{baseDir}/scripts/jira.sh log PB-321 1.5 2025-01-18 -
My open issues
{baseDir}/scripts/jira.sh my [maxResults] -
Logged hours by issue (me)
{baseDir}/scripts/jira.sh hours 2025-01-01 2025-01-05 -
Logged hours for a day (everyone)
{baseDir}/scripts/jira.sh hours-day 2025-01-05 -
Logged hours for a day (user filter)
{baseDir}/scripts/jira.sh hours-day 2025-01-05 "jane" -
Logged hours for an issue
{baseDir}/scripts/jira.sh hours-issue ABC-321 "jane"
Notes
- Worklog commands use Jira's worklog/updated + worklog/list combo and may take a few seconds on large projects.
hoursfilters byJIRA_EMAIL;hours-dayreturns all users with totals per issue and user.- Outputs for hours commands are JSON for reuse in other tools.
- Status transitions are validated against the server-provided transition list before applying.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install clawdbot-jira-skill - 安装完成后,直接呼叫该 Skill 的名称或使用
/clawdbot-jira-skill触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Jira 是什么?
Manage Jira issues, transitions, and worklogs via the Jira Cloud REST API. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2825 次。
如何安装 Jira?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install clawdbot-jira-skill」即可一键安装,无需额外配置。
Jira 是免费的吗?
是的,Jira 完全免费(开源免费),可自由下载、安装和使用。
Jira 支持哪些平台?
Jira 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Jira?
由 kyjus25(@kyjus25)开发并维护,当前版本 v1.0.2。