openclaw-skill-openproject

openclaw-skill-openproject

OpenClaw skill for OpenProject — CRUD work packages, projects, users, relations, time entries, comments, attachments, wiki pages, and more via OpenProject API v3. Supports both cloud and self-hosted instances.

By Abdelkrim BOUJRAF / ALT-F1 SRL, Brussels 🇧🇪 🇲🇦

Table of Contents

• Features
• Quick Start
• Setup
• Commands
• Security
• ClawHub
• License
• Author
• Contributing

Features

• Work Packages — Create, read, update, delete, list with filters (status, assignee, type)
• Projects — List, read, create
• Users — List, search, read user details, view current user
• Documents — List, read, update documents
• Revisions — Read revisions, list by work package
• Capabilities & Actions — Permission introspection, list available actions
• My Preferences — Read and update personal preferences
• Render — Render markdown/plain text to HTML
• Posts — Read forum posts and attachments
• Reminders — CRUD for work package reminders
• Project Statuses — Read project health statuses
• Project Phases — List definitions, read phases (Enterprise)
• Portfolios — List, read, update, delete portfolios (Enterprise)
• Programs — List, read, update, delete programs (Enterprise)
• Placeholder Users — Full CRUD for virtual resource planning users (Enterprise)
• Budgets — List and read project budgets (Enterprise)
• Meetings — Read meetings, list/upload attachments (Enterprise)
• Days — Working/non-working days, week schedule, holiday calendar
• Configuration — View instance and project configuration
• OAuth — Read OAuth applications and client credentials
• Help Texts — List and read attribute help texts
• Custom Fields & Options — Browse hierarchical custom field items and option values
• Custom Actions — Read and execute workflow automation actions on work packages
• Groups — Full CRUD for user groups with member management
• News — Full CRUD for project news/announcements
• Watchers — List, add, remove watchers on work packages
• Relations — Create, read, update, delete relations between work packages (blocks, follows, precedes, etc.)
• Notifications — List, read, mark read/unread with filters (reason, project, work package)
• Comments — List and add comments on work packages
• Attachments — List, upload, and delete
• Time Entries — CRUD time tracking with hours, dates, and activity types
• Statuses & Transitions — List statuses, update work package status
• Reference Data — Types, priorities, members, versions, categories
• Wiki Pages — Read wiki pages, list and upload attachments
• Security — --confirm required for deletes, no secrets to stdout, rate-limit retry with backoff
• Auth — API token (works with cloud and self-hosted)

Quick Start

# 1. Clone
git clone https://github.com/ALT-F1-OpenClaw/openclaw-skill-openproject.git
cd openclaw-skill-openproject

# 2. Install
npm install

# 3. Configure
cp .env.example .env
# Edit .env with your OpenProject URL and API token

# 4. Use
node scripts/openproject.mjs project-list
node scripts/openproject.mjs wp-list --project my-project
node scripts/openproject.mjs wp-create --project my-project --subject "My first task"

Setup

1. Log in to your OpenProject instance
2. Go to My Account → Access Tokens → + Add
3. Create an API token and copy it
4. Copy .env.example to .env and fill in:
   • OP_HOST — your OpenProject URL (e.g. https://projects.xflowdata.com)
   • OP_API_TOKEN — the API token you just created
   • OP_DEFAULT_PROJECT — (optional) default project identifier

Commands

See SKILL.md for full command reference.

120 commands across 35 entities:

Security

• API token auth (Basic auth with apikey as username)
• No secrets or tokens printed to stdout
• All delete operations require explicit --confirm flag
• Path traversal prevention for file uploads
• Built-in rate limiting with exponential backoff retry
• Lazy config validation (only checked when a command runs)

ClawHub

Published as: openproject-by-altf1be

clawhub install openproject-by-altf1be

License

MIT — see LICENSE

Author

Abdelkrim BOUJRAF — ALT-F1 SRL, Brussels 🇧🇪 🇲🇦

• GitHub: @abdelkrim
• X: @altf1be

Contributing

Contributions welcome! Please open an issue or PR.