⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v1.0.0

hivebrite-by-altf1be

alt-f1-openclaw@alt-f1-openclaw⭐ 0 stars· last commit 7mo ago· 0 open issues

Hivebrite Admin API CLI — users, companies, events, groups, donations, memberships, emailings, mentoring, news, projects, media center, forums, and more. OAuth2 auth (password grant or refresh token) or bearer token.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 0 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

openclaw-skill-hivebrite-by-altf1be

License: MIT Node.js Hivebrite OpenClaw Skill ClawHub Security GitHub last commit GitHub issues GitHub stars

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

  • 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:

DomainCommands
Meme
Settingscustomizable-attributes, fields-of-study, industries, job-functions, currencies
Networkinfo, sub-networks list/create/update/delete, citizenships
Userslist, read, create, update, delete, experiences, educations, notification-settings, postal-addresses, group-membership, find-by-field, notify, activate
Experienceslist, read, update, delete
Educationslist, read, update, delete
Emailingscategories list/create/read/update/delete, campaigns list/create/read/update/delete/send
Groupslist, read, create, update, delete, users list/create/delete
Companieslist, read, create, update, delete
Newscategories, list, read, create, update, delete, duplicate
Roleslist, read
Business Opportunitieslist, read, create, update, delete
Receiptslist, read, update
Pageslist, read, create, update, delete
Approvalslist, read, delete, reject, approve, link-to-user
Versionslist
Commentslist, read, create, update, delete
Postslist, read, create, update, delete
Eventslist, read, create, update, delete, cancel, duplicate, tickets, bookings, attendees, rsvps
Projectslist, read, create, update, delete, team-members
Membershipstypes, subscriptions, payment-options
Engagementrankings, user-rank
Payment Accountslist, read
Categorieslist, read, create, update, delete
Current Locationslist, read
Media Centerfiles, folders, root
Audit Logslist
Adminslist, read, create, update, delete
Mentoringmentees, mentors, programs, relationships, customizable-attributes
Orderscreate, update, delete
Email Analyticsdeliveries
Forumslist, read, create, update, delete
Notificationslist
Sub-networkslist
User Data Fieldslist
Donationsfunds, campaigns, donations, gifts

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 🇧🇪 🇲🇦

Contributing

Contributions welcome! Please open an issue or PR.

// HOW IT'S BUILT

// FILES

14 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • SKILL.md22 KB45d018559663upstream ↗
    ---
    name: hivebrite-by-altf1be
    description: "Hivebrite Admin API CLI — users, companies, events, groups, donations, memberships, emailings, mentoring, news, projects, media center, forums, and more. OAuth2 auth (password grant or refresh token) or bearer token."
    homepage: https://github.com/ALT-F1-OpenClaw/openclaw-skill-hivebrite-by-altf1be
    metadata:
      {"openclaw": {"emoji": "🐝", "requires": {"env": ["HIVEBRITE_BASE_URL", "HIVEBRITE_ACCESS_TOKEN"]}, "optional": {"env": ["HIVEBRITE_CLIENT_ID", "HIVEBRITE_CLIENT_SECRET", "HIVEBRITE_ADMIN_EMAIL", "HIVEBRITE_ADMIN_PASSWORD", "HIVEBRITE_REFRESH_TOKEN", "HIVEBRITE_MAX_RESULTS"]}, "primaryEnv": "HIVEBRITE_ACCESS_TOKEN"}}
    ---
    
    # Hivebrite by @altf1be
    
    Full Hivebrite Admin API CLI covering users, companies, events, groups, donations, memberships, emailings, mentoring, news, projects, media center, forums, admins, approvals, roles, receipts, categories, comments, posts, audit logs, engagement scoring, payment accounts, network settings, and more.
    
    ## Setup
    
    1. Obtain API credentials from your Hivebrite admin panel (Settings > Integrations or API).
    2. Set environment variables (or create `.env` in `{baseDir}`):
    
    ```
    # Required — your Hivebrite instance URL
    HIVEBRITE_BASE_URL=https://yourcommunity.hivebrite.com
    
    # Auth Option 1: Bearer token (simplest)
    HIVEBRITE_ACCESS_TOKEN=your-access-token
    
    # Auth Option 2: OAuth2 password grant (set all four):
    # HIVEBRITE_CLIENT_ID=your-client-id
    # HIVEBRITE_CLIENT_SECRET=your-client-secret
    # [email protected]
    # HIVEBRITE_ADMIN_PASSWORD=your-password
    
    # Auth Option 3: OAuth2 refresh token grant (set all three):
    # HIVEBRITE_CLIENT_ID=your-client-id
    # HIVEBRITE_CLIENT_SECRET=your-client-secret
    # HIVEBRITE_REFRESH_TOKEN=your-refresh-token
    
    # Optional
    # HIVEBRITE_MAX_RESULTS=25
    ```
    
    3. Install dependencies: `cd {baseDir} && npm install`
    
    ## API Info
    
    - **Base URL:** `{HIVEBRITE_BASE_URL}/api/admin/v2/` (some endpoints use v1 or v3)
    - **Auth:** OAuth2 (`grant_type=password` or `grant_type=refresh_token`) or Bearer token
    - **Pagination:** RFC-5988 Link headers. Params: `page` (default 1), `per_page` (default 25, max 100)
    - **Rate limits:** 300 requests/minute. Max 15 errors (5xx) per minute before throttling.
    
    ## Commands
    
    ### Me
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs me
    ```
    
    ### Settings
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs settings customizable-attributes
    node {baseDir}/scripts/hivebrite.mjs settings fields-of-study
    node {baseDir}/scripts/hivebrite.mjs settings industries
    node {baseDir}/scripts/hivebrite.mjs settings job-functions
    node {baseDir}/scripts/hivebrite.mjs settings currencies
    ```
    
    ### Network
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs network info
    node {baseDir}/scripts/hivebrite.mjs network sub-networks
    node {baseDir}/scripts/hivebrite.mjs network citizenships
    ```
    
    ### Users
    
    ```bash
    # List / search users
    node {baseDir}/scripts/hivebrite.mjs users list
    node {baseDir}/scripts/hivebrite.mjs users list --query "john"
    
    # CRUD
    node {baseDir}/scripts/hivebrite.mjs users read --id 123
    node {baseDir}/scripts/hivebrite.mjs users create --email "[email protected]" --firstname Jane --lastname Doe
    node {baseDir}/scripts/hivebrite.mjs users update --id 123 --phone "+1234567890"
    node {baseDir}/scripts/hivebrite.mjs users delete --id 123 --confirm
    
    # Sub-resources
    node {baseDir}/scripts/hivebrite.mjs users experiences --user-id 123
    node {baseDir}/scripts/hivebrite.mjs users educations --user-id 123
    node {baseDir}/scripts/hivebrite.mjs users notification-settings --user-id 123
    node {baseDir}/scripts/hivebrite.mjs users postal-addresses --user-id 123
    node {baseDir}/scripts/hivebrite.mjs users group-membership --user-id 123
    
    # Special actions
    node {baseDir}/scripts/hivebrite.mjs users find-by-field --field email --value "[email protected]"
    node {baseDir}/scripts/hivebrite.mjs users notify --id 123 --subject "Hello" --message "Welcome!"
    node {baseDir}/scripts/hivebrite.mjs users activate --id 123
    ```
    
    ### Experiences (standalone)
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs experiences list
    node {baseDir}/scripts/hivebrite.mjs experiences read --id 456
    node {baseDir}/scripts/hivebrite.mjs experiences create --user-id 123 --title "Engineer" --organization "Acme"
    node {baseDir}/scripts/hivebrite.mjs experiences update --id 456 --title "Senior Engineer"
    node {baseDir}/scripts/hivebrite.mjs experiences delete --id 456 --confirm
    node {baseDir}/scripts/hivebrite.mjs experiences customizable-attributes
    ```
    
    ### Educations (standalone)
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs educations list
    node {baseDir}/scripts/hivebrite.mjs educations read --id 789
    node {baseDir}/scripts/hivebrite.mjs educations create --user-id 123 --degree "MSc" --school "MIT"
    node {baseDir}/scripts/hivebrite.mjs educations update --id 789 --field "Computer Science"
    node {baseDir}/scripts/hivebrite.mjs educations delete --id 789 --confirm
    node {baseDir}/scripts/hivebrite.mjs educations customizable-attributes
    ```
    
    ### Emailings
    
    ```bash
    # Categories
    node {baseDir}/scripts/hivebrite.mjs emailings categories list
    node {baseDir}/scripts/hivebrite.mjs emailings categories read --id 10
    node {baseDir}/scripts/hivebrite.mjs emailings categories create --name "Newsletter"
    node {baseDir}/scripts/hivebrite.mjs emailings categories update --id 10 --name "Monthly Newsletter"
    node {baseDir}/scripts/hivebrite.mjs emailings categories delete --id 10 --confirm
    
    # Campaigns
    node {baseDir}/scripts/hivebrite.mjs emailings campaigns list
    node {baseDir}/scripts/hivebrite.mjs emailings campaigns read --id 20
    node {baseDir}/scripts/hivebrite.mjs emailings campaigns create --subject "Spring Update" --name "Spring 2026"
    node {baseDir}/scripts/hivebrite.mjs emailings campaigns update --id 20 --subject "Updated Subject"
    node {baseDir}/scripts/hivebrite.mjs emailings campaigns delete --id 20 --confirm
    node {baseDir}/scripts/hivebrite.mjs emailings campaigns send --id 20
    ```
    
    ### Groups
    
    ```bash
    # Groups CRUD
    node {baseDir}/scripts/hivebrite.mjs groups list
    node {baseDir}/scripts/hivebrite.mjs groups read --id 30
    node {baseDir}/scripts/hivebrite.mjs groups create --name "Alumni Paris"
    node {baseDir}/scripts/hivebrite.mjs groups update --id 30 --description "Paris chapter"
    node {baseDir}/scripts/hivebrite.mjs groups delete --id 30 --confirm
    
    # Group users
    node {baseDir}/scripts/hivebrite.mjs groups users list --group-id 30
    node {baseDir}/scripts/hivebrite.mjs groups users add --group-id 30 --user-id 123
    node {baseDir}/scripts/hivebrite.mjs groups users remove --group-id 30 --user-id 123 --confirm
    
    # Topic categories
    node {baseDir}/scripts/hivebrite.mjs groups topic-categories --group-id 30
    ```
    
    ### Companies
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs companies list
    node {baseDir}/scripts/hivebrite.mjs companies list --query "Acme"
    node {baseDir}/scripts/hivebrite.mjs companies read --id 40
    node {baseDir}/scripts/hivebrite.mjs companies create --name "Acme Corp" --industry "Technology"
    node {baseDir}/scripts/hivebrite.mjs companies update --id 40 --website "https://acme.com"
    node {baseDir}/scripts/hivebrite.mjs companies delete --id 40 --confirm
    ```
    
    ### News
    
    ```bash
    # Categories
    node {baseDir}/scripts/hivebrite.mjs news categories list
    node {baseDir}/scripts/hivebrite.mjs news categories read --id 50
    node {baseDir}/scripts/hivebrite.mjs news categories create --name "Announcements"
    node {baseDir}/scripts/hivebrite.mjs news categories update --id 50 --name "Official News"
    node {baseDir}/scripts/hivebrite.mjs news categories delete --id 50 --confirm
    
    # Posts
    node {baseDir}/scripts/hivebrite.mjs news posts list
    node {baseDir}/scripts/hivebrite.mjs news posts read --id 60
    node {baseDir}/scripts/hivebrite.mjs news posts create --title "Welcome!" --body "<p>Hello world</p>"
    node {baseDir}/scripts/hivebrite.mjs news posts update --id 60 --title "Updated Title"
    node {baseDir}/scripts/hivebrite.mjs news posts delete --id 60 --confirm
    node {baseDir}/scripts/hivebrite.mjs news posts duplicate --id 60
    ```
    
    ### Roles
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs roles list
    node {baseDir}/scripts/hivebrite.mjs roles read --id 70
    ```
    
    ### Business Opportunities
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs business-opportunities list
    node {baseDir}/scripts/hivebrite.mjs business-opportunities read --id 80
    node {baseDir}/scripts/hivebrite.mjs business-opportunities create --title "Senior Dev" --type "job" --company "Acme"
    node {baseDir}/scripts/hivebrite.mjs business-opportunities update --id 80 --status "closed"
    node {baseDir}/scripts/hivebrite.mjs business-opportunities delete --id 80 --confirm
    ```
    
    ### Receipts
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs receipts list
    node {baseDir}/scripts/hivebrite.mjs receipts read --id 90
    node {baseDir}/scripts/hivebrite.mjs receipts update --id 90 --status "paid"
    ```
    
    ### Pages (customizable)
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs pages list
    node {baseDir}/scripts/hivebrite.mjs pages read --id 100
    node {baseDir}/scripts/hivebrite.mjs pages create --title "About Us"
    node {baseDir}/scripts/hivebrite.mjs pages update --id 100 --title "About Our Community"
    node {baseDir}/scripts/hivebrite.mjs pages delete --id 100 --confirm
    ```
    
    ### Approvals
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs approvals list
    node {baseDir}/scripts/hivebrite.mjs approvals read --id 110
    node {baseDir}/scripts/hivebrite.mjs approvals approve --id 110
    node {baseDir}/scripts/hivebrite.mjs approvals reject --id 110
    node {baseDir}/scripts/hivebrite.mjs approvals link-to-user --id 110 --user-id 123
    node {baseDir}/scripts/hivebrite.mjs approvals delete --id 110 --confirm
    ```
    
    ### Versions (deleted items)
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs versions list
    node {baseDir}/scripts/hivebrite.mjs versions list --item-type "User"
    ```
    
    ### Comments (v3 API)
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs comments list
    node {baseDir}/scripts/hivebrite.mjs comments list --commentable-type "News" --commentable-id 60
    node {baseDir}/scripts/hivebrite.mjs comments read --id 120
    node {baseDir}/scripts/hivebrite.mjs comments create --body "Great post!" --commentable-type "News" --commentable-id 60
    node {baseDir}/scripts/hivebrite.mjs comments update --id 120 --body "Updated comment"
    node {baseDir}/scripts/hivebrite.mjs comments delete --id 120 --confirm
    ```
    
    ### Posts (v3 API)
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs posts list
    node {baseDir}/scripts/hivebrite.mjs posts read --id 130
    node {baseDir}/scripts/hivebrite.mjs posts create --body "Hello community!" --group-id 30
    node {baseDir}/scripts/hivebrite.mjs posts update --id 130 --body "Updated post"
    node {baseDir}/scripts/hivebrite.mjs posts delete --id 130 --confirm
    ```
    
    ### Events
    
    ```bash
    # Events CRUD
    node {baseDir}/scripts/hivebrite.mjs events list
    node {baseDir}/scripts/hivebrite.mjs events read --id 140
    node {baseDir}/scripts/hivebrite.mjs events create --name "Annual Gala" --starts-at "2026-06-15T18:00:00Z" --location "Brussels"
    node {baseDir}/scripts/hivebrite.mjs events update --id 140 --capacity 200
    node {baseDir}/scripts/hivebrite.mjs events delete --id 140 --confirm
    node {baseDir}/scripts/hivebrite.mjs events cancel --id 140
    node {baseDir}/scripts/hivebrite.mjs events duplicate --id 140
    node {baseDir}/scripts/hivebrite.mjs events customizable-attributes
    
    # Tickets
    node {baseDir}/scripts/hivebrite.mjs events tickets list --event-id 140
    node {baseDir}/scripts/hivebrite.mjs events tickets read --event-id 140 --id 1
    node {baseDir}/scripts/hivebrite.mjs events tickets create --event-id 140 --name "VIP" --price 50 --currency EUR
    node {baseDir}/scripts/hivebrite.mjs events tickets update --event-id 140 --id 1 --price 75
    node {baseDir}/scripts/hivebrite.mjs events tickets delete --event-id 140 --id 1 --confirm
    
    # Bookings
    node {baseDir}/scripts/hivebrite.mjs events bookings list --event-id 140
    node {baseDir}/scripts/hivebrite.mjs events bookings read --event-id 140 --id 2
    node {baseDir}/scripts/hivebrite.mjs events bookings create --event-id 140 --user-id 123 --ticket-id 1
    node {baseDir}/scripts/hivebrite.mjs events bookings update --event-id 140 --id 2 --status "confirmed"
    node {baseDir}/scripts/hivebrite.mjs events bookings delete --event-id 140 --id 2 --confirm
    
    # Attendees
    node {baseDir}/scripts/hivebrite.mjs events attendees list --event-id 140
    node {baseDir}/scripts/hivebrite.mjs events attendees read --event-id 140 --id 3
    node {baseDir}/scripts/hivebrite.mjs events attendees create --event-id 140 --user-id 123
    node {baseDir}/scripts/hivebrite.mjs events attendees update --event-id 140 --id 3 --checked-in true
    node {baseDir}/scripts/hivebrite.mjs events attendees delete --event-id 140 --id 3 --confirm
    
    # RSVPs
    node {baseDir}/scripts/hivebrite.mjs events rsvps list --event-id 140
    node {baseDir}/scripts/hivebrite.mjs events rsvps read --event-id 140 --id 4
    node {baseDir}/scripts/hivebrite.mjs events rsvps create --event-id 140 --user-id 123 --status "attending"
    node {baseDir}/scripts/hivebrite.mjs events rsvps update --event-id 140 --id 4 --status "declined"
    node {baseDir}/scripts/hivebrite.mjs events rsvps delete --event-id 140 --id 4 --confirm
    ```
    
    ### Projects (Ventures)
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs projects list
    node {baseDir}/scripts/hivebrite.mjs projects read --id 150
    node {baseDir}/scripts/hivebrite.mjs projects create --name "Innovation Lab"
    node {baseDir}/scripts/hivebrite.mjs projects update --id 150 --status "active"
    node {baseDir}/scripts/hivebrite.mjs projects delete --id 150 --confirm
    
    # Team members
    node {baseDir}/scripts/hivebrite.mjs projects team-members list --project-id 150
    node {baseDir}/scripts/hivebrite.mjs projects team-members add --project-id 150 --user-id 123 --role "lead"
    node {baseDir}/scripts/hivebrite.mjs projects team-members update --project-id 150 --id 5 --role "member"
    node {baseDir}/scripts/hivebrite.mjs projects team-members remove --project-id 150 --id 5 --confirm
    ```
    
    ### Memberships
    
    ```bash
    # Types
    node {baseDir}/scripts/hivebrite.mjs memberships types list
    node {baseDir}/scripts/hivebrite.mjs memberships types read --id 160
    node {baseDir}/scripts/hivebrite.mjs memberships types create --name "Premium" --price 99 --currency EUR
    node {baseDir}/scripts/hivebrite.mjs memberships types update --id 160 --price 149
    node {baseDir}/scripts/hivebrite.mjs memberships types delete --id 160 --confirm
    
    # Subscriptions
    node {baseDir}/scripts/hivebrite.mjs memberships subscriptions list
    node {baseDir}/scripts/hivebrite.mjs memberships subscriptions list --user-id 123
    node {baseDir}/scripts/hivebrite.mjs memberships subscriptions read --id 170
    node {baseDir}/scripts/hivebrite.mjs memberships subscriptions create --user-id 123 --type-id 160
    node {baseDir}/scripts/hivebrite.mjs memberships subscriptions update --id 170 --status "active"
    node {baseDir}/scripts/hivebrite.mjs memberships subscriptions delete --id 170 --confirm
    
    # Payment options
    node {baseDir}/scripts/hivebrite.mjs memberships payment-options --type-id 160
    ```
    
    ### Engagement Scoring
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs engagement rankings
    node {baseDir}/scripts/hivebrite.mjs engagement user-rank --user-id 123
    ```
    
    ### Payment Accounts
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs payment-accounts list
    node {baseDir}/scripts/hivebrite.mjs payment-accounts read --id 180
    ```
    
    ### Categories
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs categories list
    node {baseDir}/scripts/hivebrite.mjs categories read --id 190
    node {baseDir}/scripts/hivebrite.mjs categories create --name "Technology"
    node {baseDir}/scripts/hivebrite.mjs categories update --id 190 --name "Tech & Innovation"
    node {baseDir}/scripts/hivebrite.mjs categories delete --id 190 --confirm
    ```
    
    ### Current Locations
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs current-locations list
    node {baseDir}/scripts/hivebrite.mjs current-locations read --id 200
    ```
    
    ### Media Center
    
    ```bash
    # Files
    node {baseDir}/scripts/hivebrite.mjs media files list
    node {baseDir}/scripts/hivebrite.mjs media files list --folder-id 10
    node {baseDir}/scripts/hivebrite.mjs media files read --id 210
    node {baseDir}/scripts/hivebrite.mjs media files create --name "logo.png" --url "https://example.com/logo.png"
    node {baseDir}/scripts/hivebrite.mjs media files update --id 210 --name "new-logo.png"
    node {baseDir}/scripts/hivebrite.mjs media files delete --id 210 --confirm
    node {baseDir}/scripts/hivebrite.mjs media files move --id 210 --folder-id 20
    node {baseDir}/scripts/hivebrite.mjs media files download-url --id 210
    
    # Folders
    node {baseDir}/scripts/hivebrite.mjs media folders list
    node {baseDir}/scripts/hivebrite.mjs media folders read --id 220
    node {baseDir}/scripts/hivebrite.mjs media folders create --name "Photos" --parent-id 10
    node {baseDir}/scripts/hivebrite.mjs media folders update --id 220 --name "Event Photos"
    node {baseDir}/scripts/hivebrite.mjs media folders delete --id 220 --confirm
    node {baseDir}/scripts/hivebrite.mjs media folders move --id 220 --parent-id 30
    
    # Root folder
    node {baseDir}/scripts/hivebrite.mjs media root-folder
    ```
    
    ### Audit Logs
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs audit-logs list
    ```
    
    ### Admins
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs admins list
    node {baseDir}/scripts/hivebrite.mjs admins read --id 230
    node {baseDir}/scripts/hivebrite.mjs admins create --email "[email protected]" --firstname John --role "admin"
    node {baseDir}/scripts/hivebrite.mjs admins update --id 230 --role "super_admin"
    node {baseDir}/scripts/hivebrite.mjs admins delete --id 230 --confirm
    ```
    
    ### Mentoring
    
    ```bash
    # Mentee profiles
    node {baseDir}/scripts/hivebrite.mjs mentoring mentees list
    node {baseDir}/scripts/hivebrite.mjs mentoring mentees read --id 240
    node {baseDir}/scripts/hivebrite.mjs mentoring mentees create --user-id 123 --program-id 10
    node {baseDir}/scripts/hivebrite.mjs mentoring mentees update --id 240 --status "active"
    node {baseDir}/scripts/hivebrite.mjs mentoring mentees delete --id 240 --confirm
    
    # Mentor profiles
    node {baseDir}/scripts/hivebrite.mjs mentoring mentors list
    node {baseDir}/scripts/hivebrite.mjs mentoring mentors read --id 250
    node {baseDir}/scripts/hivebrite.mjs mentoring mentors create --user-id 456 --program-id 10
    node {baseDir}/scripts/hivebrite.mjs mentoring mentors update --id 250 --status "active"
    node {baseDir}/scripts/hivebrite.mjs mentoring mentors delete --id 250 --confirm
    
    # Programs
    node {baseDir}/scripts/hivebrite.mjs mentoring programs list
    node {baseDir}/scripts/hivebrite.mjs mentoring programs read --id 10
    node {baseDir}/scripts/hivebrite.mjs mentoring programs create --name "Leadership 2026"
    node {baseDir}/scripts/hivebrite.mjs mentoring programs update --id 10 --status "active"
    node {baseDir}/scripts/hivebrite.mjs mentoring programs delete --id 10 --confirm
    
    # Relationships
    node {baseDir}/scripts/hivebrite.mjs mentoring relationships list
    node {baseDir}/scripts/hivebrite.mjs mentoring relationships read --id 260
    node {baseDir}/scripts/hivebrite.mjs mentoring relationships create --mentor-profile-id 250 --mentee-profile-id 240 --program-id 10
    node {baseDir}/scripts/hivebrite.mjs mentoring relationships update --id 260 --status "completed"
    node {baseDir}/scripts/hivebrite.mjs mentoring relationships delete --id 260 --confirm
    
    # Customizable attributes
    node {baseDir}/scripts/hivebrite.mjs mentoring customizable-attributes
    ```
    
    ### Order Management (manual transactions)
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs orders create --user-id 123 --amount 50 --currency EUR --description "Manual payment"
    node {baseDir}/scripts/hivebrite.mjs orders update --id 270 --amount 75
    node {baseDir}/scripts/hivebrite.mjs orders delete --id 270 --confirm
    ```
    
    ### Email Analytics
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs email-analytics deliveries
    node {baseDir}/scripts/hivebrite.mjs email-analytics deliveries --campaign-id 20
    ```
    
    ### Forums
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs forums list
    node {baseDir}/scripts/hivebrite.mjs forums read --id 280
    node {baseDir}/scripts/hivebrite.mjs forums create --title "General Discussion" --body "Welcome to the forum!"
    node {baseDir}/scripts/hivebrite.mjs forums update --id 280 --title "Updated Title"
    node {baseDir}/scripts/hivebrite.mjs forums delete --id 280 --confirm
    ```
    
    ### Notifications
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs notifications list
    ```
    
    ### Sub-Networks (clusters)
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs sub-networks clusters
    ```
    
    ### User Data Fields
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs user-data-fields list
    ```
    
    ### Donations
    
    ```bash
    # Funds
    node {baseDir}/scripts/hivebrite.mjs donations funds list
    node {baseDir}/scripts/hivebrite.mjs donations funds read --id 290
    node {baseDir}/scripts/hivebrite.mjs donations funds create --name "Scholarship Fund" --goal 10000 --currency EUR
    node {baseDir}/scripts/hivebrite.mjs donations funds update --id 290 --goal 15000
    node {baseDir}/scripts/hivebrite.mjs donations funds delete --id 290 --confirm
    
    # Campaigns
    node {baseDir}/scripts/hivebrite.mjs donations campaigns list
    node {baseDir}/scripts/hivebrite.mjs donations campaigns read --id 300
    node {baseDir}/scripts/hivebrite.mjs donations campaigns create --name "Year-End Drive" --fund-id 290
    node {baseDir}/scripts/hivebrite.mjs donations campaigns update --id 300 --name "Updated Campaign"
    node {baseDir}/scripts/hivebrite.mjs donations campaigns delete --id 300 --confirm
    
    # Donations
    node {baseDir}/scripts/hivebrite.mjs donations items list
    node {baseDir}/scripts/hivebrite.mjs donations items list --fund-id 290
    node {baseDir}/scripts/hivebrite.mjs donations items read --id 310
    node {baseDir}/scripts/hivebrite.mjs donations items create --user-id 123 --amount 100 --currency EUR --fund-id 290
    node {baseDir}/scripts/hivebrite.mjs donations items update --id 310 --status "completed"
    node {baseDir}/scripts/hivebrite.mjs donations items delete --id 310 --confirm
    
    # Gift
    node {baseDir}/scripts/hivebrite.mjs donations gift --id 320
    
    # Customizable attributes
    node {baseDir}/scripts/hivebrite.mjs donations customizable-attributes
    ```
    
    ### Pagination (all list commands)
    
    All list commands support pagination:
    
    ```bash
    node {baseDir}/scripts/hivebrite.mjs users list --limit 50 --page 2
    node {baseDir}/scripts/hivebrite.mjs events list --limit 100 --page 3
    ```
    
    ## Security
    
    - Auth method: Bearer token or OAuth 2.0 with auto-refresh (password/refresh_token grant)
    - No secrets or tokens printed to stdout
    - All delete operations require explicit `--confirm` flag
    - Built-in rate limiting with exponential backoff retry (3 attempts)
    - OAuth tokens cached in `~/.cache/openclaw/hivebrite-token.json`
    - Lazy config validation (only checked when a command runs)
    
    ## Dependencies
    
    - `commander` — CLI framework
    - `dotenv` — environment variable loading
    - Node.js built-in `fetch` (requires Node >= 18)
    
    ## Author
    
    Abdelkrim BOUJRAF — [ALT-F1 SRL](https://www.alt-f1.be), Brussels 🇧🇪 🇲🇦
    X: [@altf1be](https://x.com/altf1be)
    
  • README.md7.5 KB1e4ddd0e16e7upstream ↗
    # openclaw-skill-hivebrite-by-altf1be
    
    [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
    [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-green.svg)](https://nodejs.org/)
    [![Hivebrite](https://img.shields.io/badge/Hivebrite-API-purple.svg)](https://hivebrite.com/documentation/api/admin)
    [![OpenClaw Skill](https://img.shields.io/badge/OpenClaw-Skill-orange.svg)](https://clawhub.ai)
    [![ClawHub](https://img.shields.io/badge/ClawHub-hivebrite--by--altf1be-orange)](https://clawhub.ai/skills/hivebrite-by-altf1be)
    [![Security](https://img.shields.io/badge/Security_Scan-Benign-green)](https://clawhub.ai/skills/hivebrite-by-altf1be)
    [![GitHub last commit](https://img.shields.io/github/last-commit/ALT-F1-OpenClaw/openclaw-skill-hivebrite-by-altf1be)](https://github.com/ALT-F1-OpenClaw/openclaw-skill-hivebrite-by-altf1be/commits/main)
    [![GitHub issues](https://img.shields.io/github/issues/ALT-F1-OpenClaw/openclaw-skill-hivebrite-by-altf1be)](https://github.com/ALT-F1-OpenClaw/openclaw-skill-hivebrite-by-altf1be/issues)
    [![GitHub stars](https://img.shields.io/github/stars/ALT-F1-OpenClaw/openclaw-skill-hivebrite-by-altf1be)](https://github.com/ALT-F1-OpenClaw/openclaw-skill-hivebrite-by-altf1be/stargazers)
    
    Full Hivebrite Admin API CLI covering users, companies, events, groups, donations, memberships, emailings, mentoring, news, projects, media center, forums, and more.
    
    By [Abdelkrim BOUJRAF](https://www.alt-f1.be) / ALT-F1 SRL, Brussels 🇧🇪 🇲🇦
    
    ## Table of Contents
    
    - [Features](#features)
    - [Quick Start](#quick-start)
    - [Setup](#setup)
    - [Commands](#commands)
    - [Security](#security)
    - [API Coverage](#api-coverage)
    - [ClawHub](#clawhub)
    - [License](#license)
    - [Author](#author)
    - [Contributing](#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
    
    ```bash
    # 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](#setup))
    
    ## Commands
    
    See [SKILL.md](./SKILL.md) for full command reference with examples.
    
    ### 150+ commands across 36 domains:
    
    | Domain | Commands |
    |--------|----------|
    | Me | `me` |
    | Settings | `customizable-attributes`, `fields-of-study`, `industries`, `job-functions`, `currencies` |
    | Network | `info`, `sub-networks list/create/update/delete`, `citizenships` |
    | Users | `list`, `read`, `create`, `update`, `delete`, `experiences`, `educations`, `notification-settings`, `postal-addresses`, `group-membership`, `find-by-field`, `notify`, `activate` |
    | Experiences | `list`, `read`, `update`, `delete` |
    | Educations | `list`, `read`, `update`, `delete` |
    | Emailings | `categories list/create/read/update/delete`, `campaigns list/create/read/update/delete/send` |
    | Groups | `list`, `read`, `create`, `update`, `delete`, `users list/create/delete` |
    | Companies | `list`, `read`, `create`, `update`, `delete` |
    | News | `categories`, `list`, `read`, `create`, `update`, `delete`, `duplicate` |
    | Roles | `list`, `read` |
    | Business Opportunities | `list`, `read`, `create`, `update`, `delete` |
    | Receipts | `list`, `read`, `update` |
    | Pages | `list`, `read`, `create`, `update`, `delete` |
    | Approvals | `list`, `read`, `delete`, `reject`, `approve`, `link-to-user` |
    | Versions | `list` |
    | Comments | `list`, `read`, `create`, `update`, `delete` |
    | Posts | `list`, `read`, `create`, `update`, `delete` |
    | Events | `list`, `read`, `create`, `update`, `delete`, `cancel`, `duplicate`, `tickets`, `bookings`, `attendees`, `rsvps` |
    | Projects | `list`, `read`, `create`, `update`, `delete`, `team-members` |
    | Memberships | `types`, `subscriptions`, `payment-options` |
    | Engagement | `rankings`, `user-rank` |
    | Payment Accounts | `list`, `read` |
    | Categories | `list`, `read`, `create`, `update`, `delete` |
    | Current Locations | `list`, `read` |
    | Media Center | `files`, `folders`, `root` |
    | Audit Logs | `list` |
    | Admins | `list`, `read`, `create`, `update`, `delete` |
    | Mentoring | `mentees`, `mentors`, `programs`, `relationships`, `customizable-attributes` |
    | Orders | `create`, `update`, `delete` |
    | Email Analytics | `deliveries` |
    | Forums | `list`, `read`, `create`, `update`, `delete` |
    | Notifications | `list` |
    | Sub-networks | `list` |
    | User Data Fields | `list` |
    | Donations | `funds`, `campaigns`, `donations`, `gifts` |
    
    ### 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](./docs/API-COVERAGE.md) for a full breakdown of supported vs unsupported API resources.
    
    ## ClawHub
    
    Published as: `hivebrite-by-altf1be`
    
    ```bash
    clawhub install hivebrite-by-altf1be
    ```
    
    ## License
    
    MIT — see [LICENSE](./LICENSE)
    
    ## Author
    
    Abdelkrim BOUJRAF — [ALT-F1 SRL](https://www.alt-f1.be), Brussels 🇧🇪 🇲🇦
    - GitHub: [@abdelkrim](https://github.com/abdelkrim)
    - X: [@altf1be](https://x.com/altf1be)
    
    ## Contributing
    
    Contributions welcome! Please open an issue or PR.
    
  • scripts/hivebrite.mjs178 KB2438f6511611upstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

  • .env.example1.1 KBe918d14013c1upstream ↗
    # Hivebrite Configuration
    # Copy to .env and fill in your values
    
    # ─── Required ────────────────────────────────────────────────────────────────
    
    # Your Hivebrite community URL
    HIVEBRITE_BASE_URL=https://yourcommunity.hivebrite.com
    
    # OAuth2 access token (for bearer token mode)
    HIVEBRITE_ACCESS_TOKEN=
    
    # ─── OAuth2 Password Grant (alternative to bearer token) ─────────────────────
    
    # HIVEBRITE_CLIENT_ID=
    # HIVEBRITE_CLIENT_SECRET=
    # HIVEBRITE_ADMIN_EMAIL=
    # HIVEBRITE_ADMIN_PASSWORD=
    
    # ─── OAuth2 Refresh Token (alternative to password grant) ────────────────────
    
    # HIVEBRITE_CLIENT_ID=
    # HIVEBRITE_CLIENT_SECRET=
    # HIVEBRITE_REFRESH_TOKEN=
    
    # ─── Optional ────────────────────────────────────────────────────────────────
    
    # Max results per page (default: 25, max: 100)
    # HIVEBRITE_MAX_RESULTS=25
    
  • .github/ISSUE_TEMPLATE/bug_report.md519 B555b04982465upstream ↗
    ---
    name: Bug Report
    about: Report a bug in this skill
    title: "[BUG] "
    labels: bug
    assignees: ''
    ---
    
    ## Description
    
    A clear description of the bug.
    
    ## Steps to Reproduce
    
    ```bash
    # Commands that trigger the bug
    node scripts/hivebrite.mjs <command> <options>
    ```
    
    ## Expected Behavior
    
    What should happen.
    
    ## Actual Behavior
    
    What actually happens (include full error output).
    
    ## Environment
    
    - Node.js version: 
    - OS: 
    - Skill version: 
    - OpenClaw version: 
    
    ## Additional Context
    
    Any other relevant information.
    
  • .gitignore2.3 KB3502ef7fa263upstream ↗
    # Created by https://www.toptal.com/developers/gitignore/api/node
    # Edit at https://www.toptal.com/developers/gitignore?templates=node
    
    ### Node ###
    # Logs
    logs
    *.log
    npm-debug.log*
    yarn-debug.log*
    yarn-error.log*
    lerna-debug.log*
    .pnpm-debug.log*
    
    # Diagnostic reports (https://nodejs.org/api/report.html)
    report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
    
    # Runtime data
    pids
    *.pid
    *.seed
    *.pid.lock
    
    # Directory for instrumented libs generated by jscoverage/JSCover
    lib-cov
    
    # Coverage directory used by tools like istanbul
    coverage
    *.lcov
    
    # nyc test coverage
    .nyc_output
    
    # Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
    .grunt
    
    # Bower dependency directory (https://bower.io/)
    bower_components
    
    # node-waf configuration
    .lock-wscript
    
    # Compiled binary addons (https://nodejs.org/api/addons.html)
    build/Release
    
    # Dependency directories
    node_modules/
    jspm_packages/
    
    # Snowpack dependency directory (https://snowpack.dev/)
    web_modules/
    
    # TypeScript cache
    *.tsbuildinfo
    
    # Optional npm cache directory
    .npm
    
    # Optional eslint cache
    .eslintcache
    
    # Optional stylelint cache
    .stylelintcache
    
    # Microbundle cache
    .rpt2_cache/
    .rts2_cache_cjs/
    .rts2_cache_es/
    .rts2_cache_umd/
    
    # Optional REPL history
    .node_repl_history
    
    # Output of 'npm pack'
    *.tgz
    
    # Yarn Integrity file
    .yarn-integrity
    
    # dotenv environment variable files
    .env
    .env.development.local
    .env.test.local
    .env.production.local
    .env.local
    
    # parcel-bundler cache (https://parceljs.org/)
    .cache
    .parcel-cache
    
    # Next.js build output
    .next
    out
    
    # Nuxt.js build / generate output
    .nuxt
    dist
    
    # Gatsby files
    .cache/
    # Comment in the public line in if your project uses Gatsby and not Next.js
    # https://nextjs.org/blog/next-9-1#public-directory-support
    # public
    
    # vuepress build output
    .vuepress/dist
    
    # vuepress v2.x temp and cache directory
    .temp
    
    # Docusaurus cache and generated files
    .docusaurus
    
    # Serverless directories
    .serverless/
    
    # FuseBox cache
    .fusebox/
    
    # DynamoDB Local files
    .dynamodb/
    
    # TernJS port file
    .tern-port
    
    # Stores VSCode versions used for testing VSCode extensions
    .vscode-test
    
    # yarn v2
    .yarn/cache
    .yarn/unplugged
    .yarn/build-state.yml
    .yarn/install-state.gz
    .pnp.*
    
    ### Node Patch ###
    # Serverless Webpack directories
    .webpack/
    
    # Optional stylelint cache
    
    # SvelteKit build / generate output
    .svelte-kit
    
    # End of https://www.toptal.com/developers/gitignore/api/node
    
  • _meta.json108 B6715a3915a73upstream ↗
    {
      "ownerId": "kn70nv968xhy7wb6ma9th8vzth81rasq",
      "slug": "hivebrite-by-altf1be",
      "version": "1.0.0"
    }
    
  • docs/API-COVERAGE.md5.3 KB78fb724d47ffupstream ↗
    # Hivebrite Admin API — Coverage & Limitations
    
    This document lists all API resources, what this skill covers, and what's excluded with reasons.
    
    ## ✅ Covered
    
    | Resource | Commands | Notes |
    |----------|----------|-------|
    | Me | `me` | Current admin info |
    | Settings | `customizable-attributes`, `fields-of-study`, `industries`, `job-functions`, `currencies` | Read-only reference data |
    | Network | `info`, `sub-networks list/create/update/delete`, `citizenships` | Full CRUD for sub-networks |
    | Users | `list`, `read`, `create`, `update`, `delete`, `experiences`, `educations`, `notification-settings`, `postal-addresses`, `group-membership`, `find-by-field`, `notify`, `activate` | Full CRUD + nested resources |
    | Experiences | `list`, `read`, `update`, `delete` | Standalone experience management |
    | Educations | `list`, `read`, `update`, `delete` | Standalone education management |
    | Emailings | `categories CRUD`, `campaigns CRUD`, `send` | Full emailing workflow |
    | Groups | `list`, `read`, `create`, `update`, `delete`, `users list/create/delete` | Full CRUD + group membership |
    | Companies | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | News | `categories`, `list`, `read`, `create`, `update`, `delete`, `duplicate` | Full CRUD + duplicate |
    | Roles | `list`, `read` | Read-only |
    | Business Opportunities | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Receipts | `list`, `read`, `update` | No create/delete (API limitation) |
    | Pages Customizable | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Approvals | `list`, `read`, `delete`, `reject`, `approve`, `link-to-user` | Full workflow |
    | Versions | `list` | List deleted items |
    | Comments | `list`, `read`, `create`, `update`, `delete` | v3 API, full CRUD |
    | Posts | `list`, `read`, `create`, `update`, `delete` | v3 API, full CRUD |
    | Network Events | `list`, `read`, `create`, `update`, `delete`, `cancel`, `duplicate` | Full CRUD + cancel/duplicate |
    | Event Tickets | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Event Bookings | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Event Attendees | `list`, `read`, `update`, `delete` | CRUD (no standalone create) |
    | Event RSVPs | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Projects/Ventures | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Team Members | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Memberships Types | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Memberships Subscriptions | `list`, `read`, `create`, `cancel`, `renew`, `delete` | Full lifecycle |
    | Payment Options | `list`, `create`, `update` | CRUD |
    | Engagement Scoring | `rankings`, `user-rank` | Read-only |
    | Payment Accounts | `list`, `read` | Read-only |
    | Categories | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Current Locations | `list`, `read` | Read-only |
    | Media Center Files | `list`, `read`, `create`, `update`, `delete`, `move`, `download-url` | Full CRUD + move + download |
    | Media Center Folders | `list`, `read`, `create`, `update`, `delete`, `move` | Full CRUD + move |
    | Media Center Root | `root` | Get root folder |
    | Audit Logs | `list` | Read-only |
    | Admins | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Mentoring Programs | `list`, `read`, `create`, `update`, `duplicate` | CRUD + duplicate |
    | Mentee Profiles | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Mentor Profiles | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Mentoring Relationships | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Mentoring Custom Attributes | `list`, `create`, `update`, `delete` | Full CRUD |
    | Order Management | `create`, `update`, `delete` | Manual transactions |
    | Email Analytics | `deliveries` | v2 endpoint, read-only |
    | Forums | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Notifications | `list` | Read-only |
    | Sub-networks | `list` | Clusters, read-only |
    | User Data Fields | `list` | Read-only |
    | Donations Funds | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Donations Campaigns | `list`, `read`, `create`, `update`, `delete`, `duplicate` | Full CRUD + duplicate |
    | Donations Orders | `list`, `read`, `create`, `update`, `delete` | Full CRUD |
    | Donation Gifts | `list`, `read` | Read-only |
    
    ## ❌ Not Covered — With Reasons
    
    ### Deprecated Topic Endpoints (`/api/admin/v2/topics/*`)
    - **Reason:** Marked as DEPRECATED in the official API docs. Use Groups endpoints instead.
    
    ### Bulk User Operations (create/update)
    - **Reason:** Available as `users bulk-create` and `users bulk-update` in the CLI but marked as basic implementations. Complex bulk workflows with error handling per-row are better handled via scripts.
    
    ### Customizable Attribute Link/Unlink per domain
    - **Reason:** Available via the customizable-attributes subcommands where applicable. Not all link/unlink variations are exposed as standalone commands due to complexity.
    
    ## 🔮 Candidates for Future Versions
    
    | Resource | Priority | Why |
    |----------|----------|-----|
    | Webhooks | High | Event-driven integrations |
    | SSO Configuration | Medium | Enterprise SSO setup automation |
    | Analytics/Reports | Medium | Deeper reporting beyond email analytics |
    | Batch Operations | Low | Bulk operations with detailed error handling |
    
    ---
    
    *Based on Hivebrite Admin API v3.0.0 specification*
    *Last updated: 2026-04-01*
    
  • docs/CHECKLIST.md2.0 KBce30645bc0c9upstream ↗
    # Pre-Publish Quality Checklist
    
    Run through before every version bump or ClawHub publish.
    
    ## Code
    
    - [ ] `node scripts/hivebrite.mjs --help` works without env vars
    - [ ] `node scripts/hivebrite.mjs --version` shows correct version
    - [ ] All CRUD commands tested against real API
    - [ ] `--confirm` required for all delete commands
    - [ ] No secrets/tokens in stdout (test with `2>&1 | grep -i token`)
    - [ ] Rate-limit retry (429) implemented with exponential backoff
    - [ ] Lazy config — `--help` works without `.env`
    - [ ] Error messages include status code: `ERROR (404): Not found`
    
    ## Files
    
    - [ ] `SKILL.md` frontmatter valid (name, description, homepage, metadata)
    - [ ] `SKILL.md` metadata includes `requires.env` and `optional.env`
    - [ ] `README.md` has all standard sections (see CONVENTIONS.md)
    - [ ] `README.md` badges: License, Node.js, Service, OpenClaw, ClawHub, Security
    - [ ] `README.md` author line includes 🇧🇪 🇲🇦
    - [ ] `.env.example` has Required + Optional sections with comments
    - [ ] `.gitignore` includes: `node_modules/`, `.env`, `*.log`
    - [ ] `LICENSE` is MIT
    - [ ] `package.json` has `"type": "module"`, `"engines"`, `"bin"`
    - [ ] `docs/API-COVERAGE.md` lists covered vs excluded resources
    - [ ] `README.md` includes "Usage with OpenClaw" natural language examples
    
    ## Git
    
    - [ ] Version bumped in `package.json`
    - [ ] Clean `git status` (no uncommitted changes)
    - [ ] Commit message follows convention: `feat:`, `fix:`, `docs:`
    - [ ] Git tag matches version: `v1.0.0`
    - [ ] Pushed to GitHub: `git push origin main --tags`
    - [ ] GitHub topics set: `openclaw`, `hivebrite`, `openclaw-skill`
    
    ## ClawHub
    
    - [ ] `clawhub whoami` returns your account
    - [ ] Slug follows pattern: `hivebrite-by-altf1be`
    - [ ] No `license:` field in SKILL.md frontmatter
    - [ ] Publish tested: `clawhub publish . --slug hivebrite-by-altf1be --version X.Y.Z`
    
    ## Security Review
    
    - [ ] No hardcoded credentials anywhere
    - [ ] `.env.example` uses placeholder values only
    - [ ] No real URLs/emails in example files
    
    ---
    
    *Based on lessons learned from ALT-F1 OpenClaw skills*
    
  • docs/CONVENTIONS.md577 B65121acf0990upstream ↗
    # ALT-F1 OpenClaw Skill Conventions
    
    Best practices extracted from production skills:
    [Jira](https://github.com/ALT-F1-OpenClaw/openclaw-skill-atlassian-jira-by-altf1be) ·
    [OpenProject](https://github.com/ALT-F1-OpenClaw/openclaw-skill-openproject) ·
    [HubSpot](https://github.com/ALT-F1-OpenClaw/openclaw-skill-hubspot-by-altf1be) ·
    [Hivebrite](https://github.com/ALT-F1-OpenClaw/openclaw-skill-hivebrite-by-altf1be)
    
    See the [openclaw-skill-template](https://github.com/ALT-F1-OpenClaw/openclaw-skill-template) for the canonical reference.
    
    ---
    
    *Last updated: 2026-04-01*
    
  • docs/PUBLISHING.md1.5 KBc61f2667dd1bupstream ↗
    # Publishing to ClawHub
    
    ## Prerequisites
    
    1. ClawHub account + CLI: `npm install -g clawhub`
    2. Login: `clawhub login`
    3. Verify: `clawhub whoami`
    
    ## Slug Convention
    
    Format: `hivebrite-by-altf1be`
    
    ## Publish Command
    
    ```bash
    clawhub publish . \
      --slug hivebrite-by-altf1be \
      --name "Hivebrite by altf1be" \
      --version 1.0.0 \
      --changelog "Initial release: full Hivebrite Admin API CLI with 36 domains"
    ```
    
    ## Version Updates
    
    ```bash
    # 1. Bump version
    npm version minor --no-git-tag-version
    
    # 2. Commit + tag
    git add -A
    git commit -m "feat: description of changes"
    git tag v1.1.0
    git push origin main --tags
    
    # 3. Publish update
    clawhub publish . \
      --slug hivebrite-by-altf1be \
      --version 1.1.0 \
      --changelog "Added: feature X, Y. Fixed: bug Z"
    ```
    
    ## Important Rules
    
    - **License:** ClawHub enforces MIT-0 for all published skills. Do NOT add `license:` to SKILL.md frontmatter.
    - **SKILL.md** is required — it's what ClawHub reads for metadata.
    - **`scripts/` dir** must contain the executable CLI file.
    
    ## After Publishing
    
    - Verify on ClawHub: `https://clawhub.ai/skills/hivebrite-by-altf1be`
    - Install test: `clawhub install hivebrite-by-altf1be`
    - Search test: `clawhub search hivebrite`
    
    ## Files Included in Publish
    
    ClawHub packages these files:
    - `SKILL.md` (required)
    - `scripts/` directory
    - `package.json`
    - `README.md`
    - `.env.example`
    
    Files excluded (via `.gitignore`):
    - `node_modules/`
    - `.env`
    - `*.log`
    
    ---
    
    *See also: [CHECKLIST.md](./CHECKLIST.md) for pre-publish quality gates*
    
  • LICENSE1.1 KB24fbe3c39f15upstream ↗
    MIT License
    
    Copyright (c) 2026 Abdelkrim from Brussels
    
    Permission is hereby granted, free of charge, to any person obtaining a copy
    of this software and associated documentation files (the "Software"), to deal
    in the Software without restriction, including without limitation the rights
    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
    copies of the Software, and to permit persons to whom the Software is
    furnished to do so, subject to the following conditions:
    
    The above copyright notice and this permission notice shall be included in all
    copies or substantial portions of the Software.
    
    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
    SOFTWARE.
    
  • package-lock.json1.2 KB86fe2546415cupstream ↗
    {
      "name": "openclaw-skill-hivebrite-by-altf1be",
      "version": "1.0.0",
      "lockfileVersion": 3,
      "requires": true,
      "packages": {
        "": {
          "name": "openclaw-skill-hivebrite-by-altf1be",
          "version": "1.0.0",
          "license": "MIT",
          "dependencies": {
            "commander": "^12.0.0",
            "dotenv": "^16.0.0"
          },
          "bin": {
            "hivebrite": "scripts/hivebrite.mjs"
          },
          "engines": {
            "node": ">=18.0.0"
          }
        },
        "node_modules/commander": {
          "version": "12.1.0",
          "resolved": "https://registry.npmjs.org/commander/-/commander-12.1.0.tgz",
          "integrity": "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==",
          "license": "MIT",
          "engines": {
            "node": ">=18"
          }
        },
        "node_modules/dotenv": {
          "version": "16.6.1",
          "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz",
          "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==",
          "license": "BSD-2-Clause",
          "engines": {
            "node": ">=12"
          },
          "funding": {
            "url": "https://dotenvx.com"
          }
        }
      }
    }
    
  • package.json1.1 KBb4609d73afeeupstream ↗
    {
      "name": "openclaw-skill-hivebrite-by-altf1be",
      "version": "1.0.0",
      "description": "OpenClaw skill for Hivebrite — full admin API CLI covering users, companies, events, groups, donations, memberships, emailings, mentoring, news, projects, media center, forums, and more",
      "type": "module",
      "bin": {
        "hivebrite": "./scripts/hivebrite.mjs"
      },
      "scripts": {
        "start": "node scripts/hivebrite.mjs",
        "help": "node scripts/hivebrite.mjs --help"
      },
      "keywords": [
        "openclaw",
        "openclaw-skill",
        "hivebrite",
        "community",
        "members",
        "events",
        "groups",
        "donations",
        "mentoring",
        "alumni"
      ],
      "author": "Abdelkrim BOUJRAF <[email protected]> (https://www.alt-f1.be)",
      "license": "MIT",
      "homepage": "https://github.com/ALT-F1-OpenClaw/openclaw-skill-hivebrite-by-altf1be",
      "repository": {
        "type": "git",
        "url": "https://github.com/ALT-F1-OpenClaw/openclaw-skill-hivebrite-by-altf1be.git"
      },
      "dependencies": {
        "commander": "^12.0.0",
        "dotenv": "^16.0.0"
      },
      "engines": {
        "node": ">=18.0.0"
      }
    }
    

Plain-text copy, no login: /skill-bundles/alt-f1-openclaw-openclaw-skill-hivebrite-by-altf1be.md

// REPO STATS

0 stars
0 open issues
Last commit: 7mo ago