Halo CLI Auth for Openclaw

A comprehensive authentication management skill for the Halo CLI to handle logins, profile switching, and credential diagnostics.

ruibaby
v0.1.1
Mar 25, 2026
0
905
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install halo-cli-auth

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 halo-cli-auth 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 CLI Auth?

Halo CLI Auth is a specialized skill designed to streamline the authentication lifecycle within the Halo ecosystem. It serves as the foundational layer for developers and operators using Openclaw Skills, ensuring that secure communication is established before executing content or operational commands.

The skill provides a robust interface for managing multiple environments through a profile-based system. It abstracts the complexity of handling both basic and bearer token authentication, allowing users to switch contexts between local development and production environments effortlessly while maintaining security by leveraging the system keyring for sensitive data.

Halo CLI Auth Use Cases

  • Establishing initial authentication with a Halo instance using bearer tokens or credentials.
  • Managing multiple environment configurations via named profiles (e.g., local vs. production).
  • Switching active profiles during multi-stage deployment workflows.
  • Troubleshooting and fixing corrupted keyring credentials or expired tokens using diagnostic tools.
  • Automating secure login processes in non-interactive CI/CD pipelines.

How Halo CLI Auth Works

  1. The user initiates a login request defining the profile name, instance URL, and authentication strategy (basic or bearer).
  2. Sensitive credentials are securely offloaded to the host system's keyring, while non-sensitive metadata is stored in the local config.
  3. The skill validates the connection and establishes the 'current' active profile for subsequent CLI operations.
  4. Users can inspect, list, or switch between stored profiles to route commands to different Halo instances.
  5. If authentication fails, the doctor workflow identifies and rectifies credential or keyring mismatches.

Halo CLI Auth Setup

Ensure you have the halo binary installed on your system. This skill is optimized for use within the Openclaw Skills framework.

# Verify halo installation
halo --version

# Initialize a local profile with a bearer token
halo auth login \
  --profile local \
  --url http://127.0.0.1:8090 \
  --auth-type bearer \
  --token <your_token>

Halo CLI Auth Data Schema & Taxonomy

The skill manages data across two primary layers to ensure security and portability:

Data Type Storage Location Content
Profile Metadata Local Config File Profile names, Instance URLs, Auth types
Secrets System Keyring Bearer tokens, Passwords, API keys
Active Context Environment/Config Current active profile pointer

Use halo auth profile get <name> --json to retrieve structured metadata for integration with other tools.

Halo CLI Auth Advanced Features

  • Multi-profile support for managing disparate Halo instances simultaneously.
  • Keyring integration to prevent plain-text credential storage in configuration files.
  • Automated diagnostic 'doctor' command to identify and fix authentication drift.
  • JSON output flags for piping profile data into other Openclaw Skills or automation scripts.
  • Force-deletion and non-interactive overrides for headless environment management.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*