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

Buffer Social Media

by @ahmadabugosh

Create, schedule, queue, and manage social media posts and drafts across Buffer-connected profiles using terminal commands.

Versionv1.0.0
Downloads804
Stars⭐ 1
TERMINAL
clawhub install buffer-social

πŸ“– About This Skill

Buffer Skill for OpenClaw

Use this skill to create and manage Buffer content from OpenClaw or terminal commands.

Quick Start

1. Install dependencies:

   cd skills/buffer
   npm install
   
2. Configure API key:
   cp .env.example .env
   # set BUFFER_API_KEY
   
3. Run a command:
   node ./buffer.js profiles
   

Authentication Setup

Set in .env:

BUFFER_API_KEY=your_buffer_api_key
BUFFER_API_URL=https://api.buffer.com/graphql

Get key: https://publish.buffer.com/settings/api

Command Reference

buffer profiles

List all connected profiles.

buffer post

Create content.

Options:

  • --profile : single target profile
  • --profiles : comma-separated profile IDs
  • --all: all connected profiles
  • --time : ISO 8601 scheduled time
  • --queue: add to queue
  • --image : attach local image path (validated; upload flow limited by current API docs)
  • --draft: save as idea/draft instead of post
  • buffer queue

    View scheduled/queued posts.

    Options:

  • --profile : filter by profile
  • --limit : max results
  • buffer ideas

    List saved ideas.

    Options:

  • --limit : max results
  • Common Use Cases

    # Post to one profile
    node ./buffer.js post "Just shipped πŸš€" --profile 

    Schedule for tomorrow

    node ./buffer.js post "Tomorrow update" --profile --time "2026-03-03T14:00:00Z"

    Multi-channel post

    node ./buffer.js post "New blog live" --profiles id1,id2

    Save draft

    node ./buffer.js post "Draft concept" --profile --draft

    Troubleshooting

  • Auth errors (401/403): check BUFFER_API_KEY, regenerate key if needed.
  • Rate limits (429): wait ~60s and retry.
  • Invalid date: use ISO format like 2026-03-03T14:00:00Z.
  • Image path error: verify file exists and path is correct.
  • OpenClaw Integration Examples

  • β€œPost to Buffer: Just shipped a new feature! πŸš€ to profile ”
  • β€œQueue this in Buffer for all profiles: Weekly recap is live”
  • β€œSave this as Buffer draft for profile : Campaign angle #3”
  • πŸ’‘ Examples

    1. Install dependencies:

       cd skills/buffer
       npm install
       
    2. Configure API key:
       cp .env.example .env
       # set BUFFER_API_KEY
       
    3. Run a command:
       node ./buffer.js profiles
       

    πŸ“‹ Tips & Best Practices

  • Auth errors (401/403): check BUFFER_API_KEY, regenerate key if needed.
  • Rate limits (429): wait ~60s and retry.
  • Invalid date: use ISO format like 2026-03-03T14:00:00Z.
  • Image path error: verify file exists and path is correct.