Halo CMS Skill for Openclaw

A professional blog management skill for the Halo CMS that enables automated post creation, comment replies, and taxonomy management via REST API.

thomasoscar
v1.0.0
Mar 23, 2026
0
645
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install openclaw-halo-cms

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install openclaw-halo-cms using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Halo CMS Skill?

The Halo CMS skill is a specialized tool within the Openclaw Skills ecosystem designed to interface directly with your Halo blog platform. It leverages the Halo REST API to provide developers and content creators with a programmatic way to handle common blogging tasks without leaving their terminal or agent environment. By integrating this skill, users can manage the entire lifecycle of a blog post, from draft creation to final publication.

This skill is built with a focus on security and efficiency. It utilizes Personal Access Tokens (PAT) for secure authentication and provides a Python-based interface to perform complex operations like category lookups and tag assignments. Whether you are automating a content pipeline or simply looking for a faster way to reply to reader comments, this Openclaw Skills extension offers a robust, developer-friendly solution.

Halo CMS Skill Use Cases

  • Automating the publication of technical articles directly from a local workspace.
  • Managing blog taxonomy by listing and assigning categories and tags programmatically.
  • Monitoring and replying to user comments on a Halo-powered blog.
  • Integrating blog drafting into an existing CI/CD or content generation pipeline.
  • Quick querying of existing blog posts and metadata for content audits.

How Halo CMS Skill Works

  1. The skill authenticates with the Halo server using a JWT token derived from the HALO_PAT_TOKEN environment variable.
  2. Commands are issued via a Python script (scripts/halo_api.py) which translates user intent into REST API requests.
  3. For post creation, the script processes titles, content, and metadata, optionally converting titles into URL slugs.
  4. It performs lookups for categories and tags based on display names to ensure correct UUID mapping.
  5. Depending on the flags provided (e.g., --publish), the content is either stored as a draft or live-published to the blog.
  6. Response data from the Halo API is returned to the user or agent to confirm the success of the operation.

Halo CMS Skill Setup

To use this within your Openclaw Skills environment, ensure you have python3 installed and set up your authentication.

# Set your Personal Access Token (strip the 'pat_' prefix)
export HALO_PAT_TOKEN="your_jwt_part_here"

# Clone the skill repository
git clone https://github.com/ThomasOscar/openclaw-halo-skill.git

# Test the connection by listing posts
python3 scripts/halo_api.py list_posts

Halo CMS Skill Data Schema & Taxonomy

The skill interacts with several core entities within the Halo ecosystem. Data is exchanged primarily in JSON format through the following endpoints:

Entity API Path Description
Public Posts /apis/api.content.halo.run/v1alpha1/posts Accesses published content
Admin Posts /apis/uc.api.content.halo.run/v1alpha1/posts Manage drafts and private content
Categories Internal Lookup Managed via displayName to UUID mapping
Tags Internal Lookup Managed via displayName to UUID mapping

All posts require a title, content (Markdown), and slug. Optional metadata includes categories and tags arrays.

Halo CMS Skill Advanced Features

  • Direct Publication Support: Use the --publish flag to skip the drafting phase and push content live immediately.
  • Intelligent Taxonomy Mapping: Automatically resolves category and tag names to their respective UUIDs, providing a list of available options if a match isn't found.
  • Automated Slug Generation: Converts post titles into URL-friendly slugs using Pinyin or English transliteration.
  • Built-in Security Guardrails: Prevents accidental data loss or disclosure of sensitive system information like IP addresses or API keys.
  • Comment Management: Supports programmatic replies to user engagement via comment UUIDs.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*