confluence

What This Skill Does

The Confluence skill provides a robust command-line interface for interacting with Atlassian Confluence directly from your OpenClaw agent. It allows users to search, retrieve, create, and manage documentation without leaving the terminal environment. Whether you need to quickly look up a deployment guide, create a meeting minutes page, or update technical documentation, this skill acts as a bridge between your agent and your company's knowledge base. It supports advanced features like page hierarchy management, file-based content uploads using storage formats, and bulk exports including attachments, making it an essential tool for documentation-heavy workflows.

Installation

To start, install the CLI via npm: npm install -g confluence-cli. Next, generate an API token at the Atlassian Security portal. Once you have the token, run confluence init and provide your Atlassian domain (e.g., yourcompany.atlassian.net), your email, and the generated token. Verify your installation by running confluence spaces to list your available environments. Configuration files are stored securely at ~/.confluence-cli/config.json.

Use Cases

This skill is perfect for developers and project managers who want to automate documentation tasks. Use it to automatically post build logs as child pages, synchronize technical specifications from local Markdown files into your wiki, or organize space hierarchies. It is particularly useful for agents managing large documentation silos where manual browsing in the web UI is too slow.

Example Prompts

1. "Find the page titled 'System Architecture' and display the content so I can review the components."
2. "Create a new page in the 'ENGINEERING' space titled 'Post-Mortem: Incident 402' and set the body content to 'Summary of the recent API downtime.'"
3. "List all child pages under the 'Project Alpha' documentation root and export them to the './docs' folder with all attachments."

Tips & Limitations

Always remember that the domain configuration must not include 'https://'. When updating pages, using the --format storage flag ensures that your HTML-like Confluence storage format is processed correctly. Note that Page IDs are exclusively numeric and found in the URL. If you are uploading large amounts of content, consider using the --file flag instead of pasting long strings directly into the command, which helps prevent terminal buffer overflows and formatting errors. Keep your API token secure, as it provides read/write access to your company's wiki data.