Buffer Social

# Buffer Skill for OpenClaw

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

## Quick Start

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

## Authentication Setup

Set in `.env`:

```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 <text>`

Create content.

Options:

- `--profile <id>`: single target profile
- `--profiles <ids>`: comma-separated profile IDs
- `--all`: all connected profiles
- `--time <datetime>`: ISO 8601 scheduled time
- `--queue`: add to queue
- `--image <path>`: 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 <id>`: filter by profile
- `--limit <n>`: max results

### `buffer ideas`

List saved ideas.

Options:

- `--limit <n>`: max results

## Common Use Cases

```bash
# Post to one profile
node ./buffer.js post "Just shipped 🚀" --profile <id>

# Schedule for tomorrow
node ./buffer.js post "Tomorrow update" --profile <id> --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 <id> --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 `<id>`”
- “Queue this in...

# 📮 Buffer Skill for OpenClaw

**Schedule and manage your social media posts directly from your AI assistant!**

## 🤔 Why This Skill?

Social media is powerful, but managing posts across multiple platforms is time-consuming. This skill gives OpenClaw (and you!) direct access to Buffer's scheduling system, so you can:

- 🤖 **Let your AI assistant handle social posting** — "Post this to Twitter tomorrow at 2pm"
- 📅 **Schedule content in advance** — Build your content calendar without leaving the conversation
- 💾 **Save drafts and ideas** — Capture inspiration when it strikes, polish later
- 🎯 **Multi-platform posting** — One command, multiple social networks
- ⚡ **Immediate or queued** — Post now or let Buffer's smart scheduling handle timing

Whether you're a solopreneur managing your own socials or building automation workflows, this skill makes Buffer feel like part of your command line.

## ✨ How It Works

This skill is a **production-ready Node.js CLI** that talks directly to Buffer's GraphQL API. OpenClaw loads it as an agent skill, giving you natural language control:

1. **You talk to OpenClaw** — "Schedule a LinkedIn post for tomorrow morning about our new feature"
2. **OpenClaw uses this skill** — Formats your request, picks the right Buffer profile, sets the time
3. **Buffer handles delivery** — Your post goes out exactly when scheduled

Behind the scenes:
- 🔐 Authenticates with your Buffer API key (get one at [Buffer Settings](https://publish.buffer.com/settings/api))
- 📡 Uses Buffer's GraphQL API for reliable, up-to-date functionality
- ✅ Includes comprehensive tests and error handling
- 🎨 Follows code quality standards (Prettier formatting, 90%+ test coverage)

## 🚀 Quick Start

### Installation

```bash
cd skills/buffer
npm install
cp .env.example .env
# Add your BUFFER_API_KEY to .env
```

Get your API key: [Buffer Developer Settings](https://publish.buffer.com/settings/api)

### Basic Commands

```bash
# 📋 List your connected social prof...