confluence-v2

What This Skill Does

The confluence-v2 skill provides a robust, direct interface for interacting with the Confluence Cloud REST API v2. It acts as an integration layer that empowers the OpenClaw agent to programmatically manage almost every aspect of a Confluence instance. Unlike standard connectors, this skill covers the full spectrum of v2 resources, including Pages, Spaces, Folders, Whiteboards, Databases, Comments, Labels, Tasks, and Properties. It handles the complexities of authentication, pagination, and request formatting, allowing users to perform complex administrative tasks, bulk content updates, or data extraction without writing custom boilerplate code for every API call. The skill includes built-in migration paths for those transitioning from older command-line tools, ensuring a seamless shift to a more automated AI-driven workflow.

Installation

To integrate this skill into your environment, execute the following command in your terminal or OpenClaw interface: clawhub install openclaw/skills/skills/pangin/openclaw-confluence-skill. After installation, you must configure your environment variables. Ensure CONFLUENCE_BASE_URL is set to your Atlassian site domain (e.g., https://your-site.atlassian.net/wiki). You must then choose between Basic Auth (using your email and API token) or OAuth (using an access token) by setting the CONFLUENCE_AUTH_METHOD variable accordingly. If migrating from the legacy confluence-cli, you can simply map your existing ~/.confluence-cli/config.json values to these environment variables to maintain your current access patterns.

Use Cases

• Bulk Content Management: Automatically archive old pages, update metadata across thousands of documents, or re-organize space structures using folder operations.
• Automated Reporting: Extract lists of pages, recent comments, or task statuses across an entire workspace to compile summary reports or audit content compliance.
• Migration and Syncing: Transfer content between spaces or sync database records from Confluence to external tools through automated scripts.
• Administrative Auditing: Programmatically retrieve and list all labels or properties across a site to identify inconsistent documentation practices.

Example Prompts

1. "List all pages created in the 'Engineering' space within the last 30 days and export the titles to a summary report."
2. "Find every page that has the label 'deprecated' and add a comment to each one stating that this page is scheduled for archival."
3. "Move all pages located in the 'Drafts' folder of the 'Operations' space into the new 'Archived' sub-folder."

Tips & Limitations

When working with the REST API v2, always leverage the scripts/client.js wrapper as it handles pagination automatically, preventing incomplete data fetches. Note that some operations may require administrative scopes; if you encounter permission errors, verify your API token has sufficient permissions for the requested resource. For complex bulk operations, run tests on a sandbox space first to ensure your script logic behaves as expected. The skill is designed for direct API interaction, meaning it reflects the exact state of the Confluence server; be cautious when running delete or move commands, as these actions cannot be easily undone without backups.