ClawHub

Deprecated — historical reference. ClawHub is no longer a first-class source. Its dedicated Settings tab has been removed, and its discovery role is subsumed into the Extensions Store, which browses Skills, Plugins, and MCP servers under one Extension umbrella by functional category. The first-class sources are now the Claude/Aleph plugin marketplaces, the Official MCP Registry, and the Docker MCP Catalog. ClawHub is reachable only via the Store Agent's long-tail path (the agent reads a URL/repo for installs that no curated source covers). The architecture below is retained as historical reference for the clawhub module.

The clawhub module provides HTTP client integration with ClawHub, a skill registry for discovering and installing community-contributed skills.

Overview

ClawHub integration enables Aleph to:

Browse skills — Search and discover community skills
Install skills — Download and install skills from the registry
Sync metadata — Keep skill metadata up to date

Architecture

ClawHubClient
  ├── HTTP Client (reqwest)
  ├── Types — Request/response schemas
  └── Authentication (API tokens)

Core Components

ClawHubClient

HTTP client for the ClawHub API:

// src/clawhub/client.rs
pub struct ClawHubClient {
    base_url: String,
    client: reqwest::Client,
    auth_token: Option<String>,
}

impl ClawHubClient {
    pub fn new(base_url: String) -> Self;
    
    pub async fn search_skills(
        &self,
        query: &str,
    ) -> Result<Vec<SkillListing>>;
    
    pub async fn get_skill(
        &self,
        id: &str,
    ) -> Result<SkillDetail>;
    
    pub async fn download_skill(
        &self,
        id: &str,
        dest: &Path,
    ) -> Result<()>;
}

Types

// src/clawhub/types.rs
pub struct SkillListing {
    pub id: String,
    pub name: String,
    pub description: String,
    pub author: String,
    pub version: String,
    pub downloads: u64,
    pub rating: f32,
}

pub struct SkillDetail {
    pub listing: SkillListing,
    pub readme: String,
    pub dependencies: Vec<String>,
    pub tools: Vec<String>,
}

Usage

use alephcore::clawhub::ClawHubClient;

let client = ClawHubClient::new(
    "https://api.clawhub.ai".to_string()
);

// Search for skills
let results = client.search_skills("code review").await?;

// Download a skill
client.download_skill("code-review", 
    Path::new("~/.aleph/skills/")
).await?;

Configuration

[clawhub]
enabled = true
base_url = "https://api.clawhub.ai"
api_token = "${CLAWHUB_TOKEN}"

Code Location

src/clawhub/mod.rs — Module entry point
src/clawhub/client.rs — HTTP client
src/clawhub/types.rs — Request/response types