hivebrite-by-altf1be

openclaw-skill-hivebrite-by-altf1be

Full Hivebrite Admin API CLI covering users, companies, events, groups, donations, memberships, emailings, mentoring, news, projects, media center, forums, and more.

By Abdelkrim BOUJRAF / ALT-F1 SRL, Brussels 🇧🇪 🇲🇦

Table of Contents

• Features
• Quick Start
• Setup
• Commands
• Security
• API Coverage
• ClawHub
• License
• Author
• Contributing

Features

• Users — Full CRUD + experiences, educations, notification settings, postal addresses, group membership, bulk ops, find-by-field, notify, activate
• Companies — Full CRUD
• Events — Events CRUD + cancel/duplicate + tickets, bookings, attendees, RSVPs
• Groups — Groups CRUD, group users, topic categories
• Donations — Funds, campaigns, donations, gifts, customizable attributes
• Memberships — Types, subscriptions, payment options
• Emailings — Categories and campaigns CRUD + send
• Mentoring — Programs, mentee/mentor profiles, relationships, customizable attributes
• News — Categories + posts CRUD + duplicate
• Projects — Projects/ventures CRUD + team members
• Media Center — Files and folders CRUD + move + download URLs
• Forums — Discussion threads CRUD
• Admins — Full CRUD for admin accounts
• And more — Settings, network, roles, business opportunities, receipts, customizable pages, approvals, versions, comments, posts, engagement scoring, payment accounts, categories, current locations, audit logs, order management, email analytics, notifications, sub-networks, user data fields
• Auth — OAuth2 (password grant or refresh token) or static bearer token (works with cloud)
• Security — --confirm required for deletes, no secrets to stdout, rate-limit retry with backoff

Quick Start

# 1. Clone
git clone https://github.com/ALT-F1-OpenClaw/openclaw-skill-hivebrite-by-altf1be.git
cd openclaw-skill-hivebrite-by-altf1be

# 2. Install
npm install

# 3. Configure
cp .env.example .env
# Edit .env with your Hivebrite credentials

# 4. Use
node scripts/hivebrite.mjs me
node scripts/hivebrite.mjs users list
node scripts/hivebrite.mjs companies read --id 42
node scripts/hivebrite.mjs events list

Setup

1. Get OAuth2 credentials from your Hivebrite admin panel
2. Copy .env.example to .env and fill in:
   • HIVEBRITE_BASE_URL — your community URL (e.g. https://yourcommunity.hivebrite.com)
   • HIVEBRITE_ACCESS_TOKEN — your OAuth2 access token (or use client credentials)
3. Run npm install

Prerequisites

• Node.js >= 18
• Hivebrite admin account with API access
• OAuth2 credentials or bearer token (see Setup)

Commands

See SKILL.md for full command reference with examples.

150+ commands across 36 domains:

Usage with OpenClaw

Once installed as a skill, you can use natural language:

"List all users in Hivebrite"

"Show me event #42"

"Create a new company called Acme Corp"

"Delete user #123"

Security

• OAuth2 authentication (password grant or refresh token) with auto-refresh and disk caching
• Static bearer token mode for simple setups
• No secrets or tokens printed to stdout
• All delete operations require explicit --confirm flag
• Built-in rate limiting with exponential backoff retry (3 attempts)
• Respects Hivebrite's 300 req/min rate limit
• OAuth token cache: ~/.cache/openclaw/hivebrite-token.json
• Lazy config validation (only checked when a command runs)

API Coverage

See docs/API-COVERAGE.md for a full breakdown of supported vs unsupported API resources.

ClawHub

Published as: hivebrite-by-altf1be

clawhub install hivebrite-by-altf1be

License

MIT — see LICENSE

Author

Abdelkrim BOUJRAF — ALT-F1 SRL, Brussels 🇧🇪 🇲🇦

• GitHub: @abdelkrim
• X: @altf1be

Contributing

Contributions welcome! Please open an issue or PR.