hpphub

HPP Hub CLI — connect AI tools to HPP Hub with a single command.

hpphub launch openclaw      # OpenClaw (AI assistant)
hpphub launch claude        # Claude Code (coding agent)

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/hpp-io/hpphub-cli/main/install.sh | sudo bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/hpp-io/hpphub-cli/main/install.ps1 | iex

If you see an Execution Policy error, run Set-ExecutionPolicy -Scope CurrentUser RemoteSigned first. After installation, restart the terminal for PATH to take effect.

Windows (WSL2) — Recommended:

curl -fsSL https://raw.githubusercontent.com/hpp-io/hpphub-cli/main/install.sh | sudo bash

Build from source (Go 1.24+):

git clone https://github.com/hpp-io/hpphub-cli.git && cd hpphub-cli
go build -o hpphub ./cmd/hpphub/

Quick Start

OpenClaw — AI assistant on your messaging apps

hpphub launch openclaw

Claude Code — AI coding agent in your terminal

hpphub launch claude

To use claude directly without hpphub every time:

hpphub launch claude --persist    # saves HPP settings to your shell profile
# restart terminal, then just run:
claude

hpphub launch claude --unpersist  # removes HPP settings from shell profile

Both commands handle everything automatically — install, login, configure, and start. Already logged in? It skips straight to setup.

See How It Works for the full flow.

Commands

Command	Description
hpphub launch openclaw	Install + login + configure + start OpenClaw with HPP
hpphub launch openclaw --model <m>	Same as above, with a specific model (skip selection prompt)
hpphub launch openclaw --config	Update OpenClaw settings only (useful for changing model without restarting)
hpphub launch claude	Install + login + launch Claude Code with HPP
hpphub launch claude --persist	Save HPP settings to shell profile (run claude directly after)
hpphub launch claude --unpersist	Remove HPP settings from shell profile
hpphub login	Log in to HPP Hub (syncs OpenClaw credentials if configured)
hpphub login --force	Re-login with a different account
hpphub logout	Log out
hpphub whoami	Show current login status (email, hub, router, API key)
hpphub models	List available models with pricing
hpphub setup telegram	Connect a Telegram bot to OpenClaw
hpphub uninstall	Remove hpphub and its configuration

How It Works

OpenClaw — AI assistant on your messaging apps

$ hpphub launch openclaw

Checking OpenClaw installation...
  ✓ OpenClaw detected                     # auto-installs if missing

Not logged in. Starting login flow...
  Your code: ABCD-1234                     # enter this code in the browser
  Browser opened. Enter the code and authorize.

  ✓ Logged in as you@example.com
  ✓ Hub:    https://hub.hpp.io
  ✓ Router: https://router.hpp.io/llm/v1
  ✓ API key: ...abcd
  ✓ OpenClaw HPP credentials synced        # when ~/.openclaw/openclaw.json exists

  Available models:
   1. anthropic/claude-sonnet-4-6          ($3.00/$15.00 per M tokens)
   2. openai/gpt-5-mini                    ($0.25/$2.00 per M tokens)
  Select model (number): 2                 # pick a model

  ✓ HPP provider configured in OpenClaw

  Set up Telegram bot? (Y/n): Y            # optional — connect Telegram
  Paste your Telegram bot token: ...
  ✓ Bot token saved

  ✓ OpenClaw gateway running               # ready to use

Now send a message to your bot on Telegram, WhatsApp, or Slack — it responds using your chosen HPP model.

Re-running hpphub launch openclaw when already configured skips setup and starts the gateway directly:

$ hpphub launch openclaw

  ✓ OpenClaw detected
  ✓ Logged in as you@example.com
  ✓ Hub:    https://hub.hpp.io
  ✓ Router: https://router.hpp.io/llm/v1
  ✓ API key: ...abcd
  ✓ OpenClaw HPP credentials synced        # apiKey/baseUrl + vision backfill
  ✓ HPP already configured (model: hpp/openai/gpt-5-mini)
  ✓ Gateway already running

To change model, use --model:

hpphub launch openclaw --model anthropic/claude-sonnet-4-6

Claude Code — AI coding agent in your terminal

First time (not logged in yet):

$ hpphub launch claude

Checking Claude Code installation...
  ✓ Claude Code detected                  # auto-installs if missing

Not logged in. Starting login flow...
  Your code: WXYZ-5678                     # same Device Code Flow as OpenClaw
  Browser opened. Enter the code and authorize.
  ✓ Logged in as you@example.com
  ✓ Hub:    https://hub.hpp.io
  ✓ Router: https://router.hpp.io/llm/v1
  ✓ API key: ...abcd
  ✓ Model: claude-sonnet-4-6

  Starting Claude Code with HPP...

$ claude >                                 # Claude Code prompt, powered by HPP

Already logged in (via any previous hpphub command):

$ hpphub launch claude

Checking Claude Code installation...
  ✓ Claude Code detected
  ✓ Logged in as you@example.com           # login skipped
  ✓ Model: claude-sonnet-4-6

  Starting Claude Code with HPP...

$ claude >

OpenClaw — Telegram Setup

Telegram setup is offered during hpphub launch openclaw. You can also run it separately:

$ hpphub setup telegram

  To create a Telegram bot:

  1. Open Telegram and talk to @BotFather
  2. Send /newbot and follow the steps
  3. Copy the bot token

  Paste your Telegram bot token: 123456789:ABCdefGHI...
  ✓ Bot token saved

  Your Telegram user ID (or press Enter to skip): 123456789
  ✓ Access restricted to your account

  ✓ Gateway restarted
  ✓ Telegram bot connected!

Other channels (WhatsApp, Discord, Slack, etc.):

openclaw configure --section channels

OpenClaw — Image / vision in WebChat

OpenClaw requires custom provider models to declare image support (input: ["text", "image"]). Without it, WebChat accepts image attachments but the gateway sends text-only requests to the model.

hpphub launch openclaw (and hpphub login when OpenClaw is already configured) automatically:

• Sets "input": ["text", "image"] on vision-capable models (e.g. gpt-4o, claude-sonnet-4-6)
• Skips text-only models (ollama/*, gpt-image-*, o3-mini)
• Syncs models.providers.hpp / hpp-anthropic apiKey and baseUrl from the current hpphub login

Use a vision model for image chat (e.g. hpphub launch openclaw --model openai/gpt-4o), then restart the gateway if it is already running:

openclaw gateway restart

Switching accounts: run hpphub logout, then hpphub login (or hpphub login --force). OpenClaw credentials are updated automatically — you do not need to re-run launch openclaw unless you want to change the default model.

Configuration

CLI config — ~/.hpphub/config.json:

{
  "api_key": "hpph_...",
  "base_url": "https://router.hpp.io/llm/v1",
  "email": "user@example.com"
}

OpenClaw config — ~/.openclaw/openclaw.json (auto-generated by hpphub launch openclaw; API keys and vision input metadata are kept in sync on hpphub login and hpphub launch openclaw)

Windows Notes

• Gateway: Runs in foreground on Windows native. Keep the terminal open for Telegram/WhatsApp. WSL2 supports background mode.
• Execution Policy: May need Set-ExecutionPolicy -Scope CurrentUser RemoteSigned before install.
• Terminal restart: Required after install for PATH to take effect.

License

MIT