openproject-by-altf1be

What This Skill Does

The openproject-by-altf1be skill provides a comprehensive CLI-based interface for the OpenProject API v3, enabling the OpenClaw agent to perform full CRUD operations on your project management ecosystem. It bridges the gap between your AI agent and your project tracking software, allowing for automated management of work packages, project structures, time tracking, and team collaboration. Whether you are managing complex development tasks, tracking billable hours, or updating project wiki pages, this skill streamlines these workflows by executing commands directly against your OpenProject instance, supporting both self-hosted and cloud configurations.

Installation

1. Install the skill via terminal: clawhub install openclaw/skills/skills/abdelkrim/openproject-by-altf1be.
2. Log in to your OpenProject instance and navigate to My Account → Access Tokens to generate a new API token.
3. Configure your environment by creating a .env file in the skill's base directory or setting the following variables: OP_HOST (your OpenProject URL), OP_API_TOKEN (the token you generated), and OP_DEFAULT_PROJECT.
4. Ensure Node.js is installed on your system, then run npm install within the skill directory to download necessary dependencies.

Use Cases

• Project Management: Automatically generate work packages based on AI-analyzed requirements or meeting minutes.
• Time Tracking: Log billable hours against specific work packages directly from the AI chat interface upon completion of a task.
• Collaboration: Add comments, track statuses, and manage attachments like screenshots or bug reports without leaving your IDE or console.
• Reporting: Quickly pull lists of open work packages or time logs for specific projects to generate progress summaries.

Example Prompts

• "List all open work packages assigned to me in the current project."
• "Create a new bug report in OpenProject with the subject 'UI alignment issue' and attach the file ./logs/ui-error.png."
• "Log 2 hours for work package #42 with the comment 'Finished implementing the authentication module'."

Tips & Limitations

• Security: Ensure that the API token provided has the minimum necessary permissions required for the tasks assigned to the agent.
• Confirmations: Destructive commands like wp-delete, attachment-delete, and time-delete require the --confirm flag to prevent accidental data loss.
• Environment Variables: Keep your OP_API_TOKEN secret; do not commit the .env file to public version control repositories.
• Compatibility: This skill interacts with API v3. Verify your OpenProject instance version supports this API if you encounter connectivity issues.