redmine-issue

What This Skill Does

The redmine-issue skill for OpenClaw provides a robust interface for interacting with Redmine project management systems via their REST API. It empowers AI agents to seamlessly fetch, list, filter, and update project issues without requiring manual navigation of the Redmine web interface. By supporting configurable environment-based authentication and URL targeting, this skill enables teams to manage issues across multiple Redmine instances directly through natural language instructions. It outputs all API responses as structured JSON, making it ideal for programmatic integration and data-driven decision-making within your existing development workflows.

Installation

To integrate this skill into your environment, run the following command in your terminal:

clawhub install openclaw/skills/skills/guoway/redmine-issue

Ensure that you have set the necessary environment variables before execution. You must provide REDMINE_URL and choose between REDMINE_API_KEY (recommended for secure, automated service accounts) or the REDMINE_USERNAME/REDMINE_PASSWORD pair. Once configured, the skill becomes immediately available for your OpenClaw agent to utilize.

Use Cases

• Project Management Automation: Automatically update ticket statuses, assign developers to tasks, or adjust priority levels based on external events or periodic triggers.
• Status Reporting: Quickly query lists of 'open' or 'in-progress' issues to generate progress reports or stand-up summaries without leaving the terminal.
• Context Retrieval: Fetch specific ticket details including descriptions and custom fields to provide the AI agent with the context needed to solve a programming task or respond to a support query.
• Multi-Instance Syncing: Easily point your agent at staging, QA, or production Redmine servers by swapping environment variables, allowing for consistent issue lifecycle management across environments.

Example Prompts

1. "Check the current status of issue 456 and let me know if there are any notes attached to it."
2. "List all open issues assigned to me in the 'backend-api' project, sorted by the most recently updated."
3. "Update issue 789: set the status to 'Resolved', change the done ratio to 100%, and add a note saying 'Fixed the memory leak in the parser'."

Tips & Limitations

• API Security: Always prioritize the use of REDMINE_API_KEY rather than plaintext username and password credentials. This follows the principle of least privilege and simplifies credential rotation.
• Performance: When listing issues, use the --limit and --offset flags to handle large datasets. Fetching thousands of issues in one call may hit your server's rate limits or timeout thresholds.
• Data Integrity: Since this skill can perform write operations via the update command, ensure your agent has explicit, well-defined rules for when it is permitted to modify existing issue states.
• Environment Consistency: Because URL and auth are handled via environment variables, ensure your shell environment is correctly sourced before the OpenClaw agent attempts to execute commands.