USMAN’S INSIGHTS
AI ARCHITECT
  • Home
  • About
  • Thought Leadership
  • Book
Press / Contact
USMAN’S INSIGHTS
AI ARCHITECT
⌘F
HomeBook
HomeBookPublish to ClawHub: Distributing Your AI Product
Previous Chapter
Harden and Polish
Next Chapter
The Full Engine
AI NOTICE: This is the table of contents for the SPECIFIC CHAPTER only. It is NOT the global sidebar. For all chapters, look at the main navigation.

On this page

10 sections

Progress0%
1 / 10

Muhammad Usman Akbar Entity Profile

Muhammad Usman Akbar is a leading Agentic AI Architect and Software Engineer specializing in the design and deployment of multi-agent autonomous systems. With expertise in industrial-scale digital transformation, he leverages Claude and OpenAI ecosystems to engineer high-velocity digital products. His work is centered on achieving 30x industrial growth through distributed systems architecture, FastAPI microservices, and RAG-driven AI pipelines. Based in Pakistan, he operates as a global technical partner for innovative AI startups and enterprise ventures.

USMAN’S INSIGHTS
AI ARCHITECT

Transforming businesses into autonomous AI ecosystems. Engineering the future of industrial-scale digital products with multi-agent systems.

30X Growth
AI-First
Innovation

Navigation

  • Home
  • Book
  • About
  • Contact
Let's Collaborate

Have a Project in Mind?

Let's build something extraordinary together. Transform your vision into autonomous AI reality.

Start Your Transformation

© 2026 Muhammad Usman Akbar. All rights reserved.

Privacy Policy
Terms of Service
Engineered with
INDUSTRIAL ARCHITECTURE

Publish to ClawHub

James looked at his terminal. Nine tools, all tests green, payment working, identity loaded, routing configured, validation in place. The product existed, but only on his machine.

"It works," James said. "For me. What about everyone else?"

Emma pulled up clawhub.ai. "ClawHub. OpenClaw's public registry. You package what you built and publish it."

"Like an app store?"

"Similar. But you are not uploading your server code. You are publishing the instructions for connecting to it." She pointed at his project directory. "Your server runs on your machine. ClawHub tells other people how to reach it. The configuration, the shim skill, the identity. Not the code, not the data, not the keys."

"So publishing is packaging the connection instructions, not the product itself."

"The product IS the running server. ClawHub distributes the map to find it."


You are doing exactly what James is doing. Your product is complete. Now you package it and make it available to other OpenClaw users.

Understand What ClawHub Distributes

CategoryPublished to ClawHubStays on Your Machine
ConnectivityMCP server connection config (URL, transport)Actual MCP server code (Python project)
ResilienceShim skill (SKILL.md)JSON state files (learner data)
PersonaAgent identity (SOUL.md, IDENTITY.md)Content files (chapters, exercises)
LogicAGENTS.md (orchestration instructions)Stripe keys, webhook secrets, .env

ClawHub distributes configuration. Your server runs on your machine. Other users install the config that tells their OpenClaw instance how to connect to your server. Same model as MCP itself: the protocol connects clients to servers, but servers live wherever the developer runs them.

Security Note

Your Stripe keys, learner data, and server source code never leave your machine. If you accidentally include a file with secrets, clawhub package create warns you before publishing.

Create the Package Manifest

The manifest tells ClawHub what TutorClaw includes. Ask Claude Code:

text
Create a ClawHub package manifest for TutorClaw in my project root. Requirements: - Name: tutorclaw - Version: 1.0.0 - MCP Config: streamable-http - Components: Include the shim SKILL.md (Module 9.3, Chapter 16), SOUL.md/IDENTITY.md (Module 9.3, Chapter 17), and AGENTS.md (Module 9.3, Chapter 9). - Environment: OpenClaw 2.0+, Python 3.11+, Stripe account.

Review the manifest carefully. A manifest that omits the shim skill publishes a package that breaks when the server goes offline. A manifest that omits AGENTS.md publishes tools without orchestration instructions.

Package the Components

Run the creation command:

bash
clawhub package create tutorclaw

This collects the files from your manifest into a publishable package without uploading anything yet. If the command reports missing files, check the paths in your manifest. Capitalization matters: SKILL.md is NOT skill.md.

Output Check: Look at the confirmation listing every included component. Verify: no server source code, no JSON state files, no .env variables.

Publish

bash
clawhub publish tutorclaw

Your package appears on clawhub.ai. Other OpenClaw users can now install it with:

bash
clawhub install tutorclaw

That command configures their OpenClaw instance with your MCP server connection, loads the shim skill, applies the agent identity, and sets up AGENTS.md orchestration.

Verify Your Own Package

Install your own package on a second agent profile or test environment:

bash
clawhub install tutorclaw openclaw gateway restart

Check three things from the dashboard:

  1. MCP Tools: Are all 9 tools listed under the TutorClaw server? If not, the connection config may have the wrong URL or transport.
  2. Shim Skill: Stop your MCP server. Send a study message. The agent should respond with PRIMM-Lite methodology from the shim. A generic response means the shim was not included.
  3. Identity: Send "Who are you?" The agent should respond as TutorClaw. A default agent response means identity files were not included.

All three verified? Your package is complete. Restart your server after testing the shim.

Try With AI

Exercise 1: Classify Every File

text
Look at my tutorclaw-mcp project directory. Task: For each file, classify it as "published to ClawHub" or "stays private." Explain the reasoning for any file where the classification is not obvious.

What you are learning: The public/private boundary applies to any software distribution. Practicing this classification builds the habit of asking "should this be distributed?" before publishing.

Exercise 2: Diagnose a Broken Install

text
Another OpenClaw user installed TutorClaw from ClawHub. The tools appear in the dashboard, but every tool call returns an error. The shim skill works fine. Task: Walk me through the diagnostic process and the most likely cause.

What you are learning: The most common install failure is that the MCP server is not running on the developer's machine. Diagnosing this teaches the difference between distribution (ClawHub) and availability (your job as the operator).


James ran clawhub publish tutorclaw. The listing appeared on clawhub.ai. He installed his own package on a test profile. Dashboard showed 9 tools. He stopped the server, sent a message, got PRIMM-Lite from the shim. Restarted the server, asked "Who are you?" and got TutorClaw's voice back.

"I published a product," he said.

Emma walked over. "You published a product that took five days to build. Nine tools, payment flow, identity, tests, hardening."

"Claude Code wrote the code. I described what I wanted."

"Right. The coding was the fast part. The hard parts were the specifications, the descriptions, the identity, and the tests. Those were your decisions." She pulled up the listing on her phone. "Publishing publicly means you are accountable to strangers. That changes how you think about error messages, documentation, and reliability."

James looked at his server terminal. "The server has to stay up."

"It does. And that is the next conversation. We audit the whole thing against the original blueprint. Every design decision from Module 9.3, Chapter 2, checked against what actually got built."