🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Ogp Expose

by @dp-pcs

Expose OGP via a public HTTPS endpoint, usually a stable Cloudflare hostname or named tunnel. Use when the user wants to verify or fix gateway reachability,...

Versionv0.6.0
Installs1
⚑ When to Use
TriggerAction
- User wants to make their OGP daemon publicly accessible
- User needs a public URL for federation
- User wants to set up or verify a stable Cloudflare route
- User is testing OGP federation remotely
- User suspects `gatewayUrl` or tunnel config is stale or mismatched
πŸ’‘ Examples

Expose with Cloudflared (Temporary / Ad Hoc)

ogp --for openclaw expose

This will: 1. Start a cloudflared tunnel on the daemon port 2. Display a public URL (e.g., https://abc-def-123.trycloudflare.com) 3. Keep the tunnel running until you stop it (Ctrl+C)

Update your config:

# Edit the correct framework config

Set "gatewayUrl" to the URL shown by cloudflared only if this temporary URL is the intended canonical endpoint

Expose with ngrok (Fallback Only)

ogp --for openclaw expose --method ngrok

This will: 1. Start an ngrok tunnel on the daemon port 2. Display a public URL (e.g., https://abc123.ngrok-free.app) 3. Open ngrok web interface at http://127.0.0.1:4040

Update your config:

# Edit ~/.ogp/config.json

Set "gatewayUrl" to the ngrok URL

βš™οΈ Configuration

The OGP daemon must be installed. If you see errors like 'ogp: command not found', install it first:

npm install -g @dp-pcs/ogp
ogp-install-skills
ogp setup
ogp config show

Full documentation: https://github.com/dp-pcs/ogp

OGP Expose - Public Tunnel Setup

This skill helps expose the OGP daemon to the internet and, more importantly, confirm that the public discovery endpoint matches the intended framework identity.

πŸ“‹ Tips & Best Practices

Tunnel won't start

  • Cloudflared not found: Install cloudflared
  • ngrok not found: Install ngrok and configure auth token
  • Port already in use: Verify the framework's daemon port and stop stale listeners
  • Public URL resolves but serves the wrong framework

  • Check ogp config show
  • Check the relevant framework config's gatewayUrl
  • Verify local discovery card on the framework port
  • Verify Cloudflare ingress routes the hostname to the expected local port
  • If you recently switched from a temporary tunnel, remove stale fields like old temporary gateway.publicUrl overrides and keep only the canonical gatewayUrl
  • Can't access public URL

  • Check firewall settings
  • Verify daemon is running (ogp --for status)
  • Test locally first: curl http://localhost:/.well-known/ogp
  • Tunnel disconnects frequently

  • Check internet connection
  • Use permanent tunnel instead of temporary
  • Consider running tunnel as a system service
  • View on ClawHub
    TERMINAL
    clawhub install ogp-expose

    πŸ§ͺ Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    πŸ” Can't find the right skill?

    Search 60,000+ AI agent skills β€” free, no login needed.

    Search Skills β†’