✓ Verified 💻 Development ✓ Enhanced Data

Wahlu

Social media automation for AI agents.

Rating: 4.4 (128 reviews)
Downloads: 2,246 downloads
Version: 1.0.0

Overview

Social media automation for AI agents.

Complete Documentation

View Source →

Wahlu — Social Media Manager for AI Agents

Wahlu lets your agent create, schedule, and publish social media posts across Instagram, TikTok, LinkedIn, Facebook, and YouTube — all from the command line.

Website: wahlu.com
CLI on npm: @wahlu/cli
API docs: wahlu.com/docs
OpenClaw integration page: wahlu.com/openclaw

Setup

bash

# Set your API key (get one at wahlu.com under Settings > API Keys)
export WAHLU_API_KEY=wahlu_live_...

No global install needed — use npx @wahlu/cli to run any command.

Core Workflow

List brands — npx @wahlu/cli brand list
Switch to a brand — npx @wahlu/cli brand switch
List integrations — npx @wahlu/cli integration list (get integration IDs for scheduling)
Create a post — npx @wahlu/cli post create --name "Title" --instagram '{"description":"Caption","post_type":"grid_post"}'
Schedule it — npx @wahlu/cli schedule create --at 2026-03-15T14:00:00Z --integrations
Upload media — npx @wahlu/cli media upload ./photo.jpg (returns a media ID)
Check publications — npx @wahlu/cli publication list

Use npx @wahlu/cli --help and npx @wahlu/cli --help to discover all commands and options. Always use --json when you need to parse output.

What You Can Do

Capability	Commands
Post to 5 platforms	post create with --instagram, --tiktok, --facebook, --youtube, --linkedin
Schedule posts	schedule create with --at (ISO 8601) and --integrations
Upload images & video	media upload — supports PNG, JPG, GIF, WebP, MP4, MOV, WebM
Manage posting queues	queue list, queue add
Save content ideas	idea create "Name" --description "Details"
Organise with labels	label create "Campaign" --color "#ff5500"
View publish history	publication list — see status, platform, failure reasons
List connected accounts	integration list — find integration IDs for scheduling

Platform-Specific Settings

Each platform has its own settings passed as JSON:

Instagram — --instagram '{"description":"...","post_type":"grid_post|reel|story","media_ids":["mid-123"]}'
TikTok — --tiktok '{"description":"...","post_type":"video|image|carousel","media_ids":["mid-123"]}'
Facebook — --facebook '{"description":"...","post_type":"fb_post|fb_story|fb_reel|fb_text","media_ids":["mid-123"]}'
YouTube — --youtube '{"title":"...","description":"...","post_type":"yt_short|yt_video","media_ids":["mid-123"]}'
LinkedIn — --linkedin '{"description":"...","post_type":"li_text|li_image|li_video","media_ids":["mid-123"]}'

Quick Examples

bash

# Upload an image and create a cross-platform post
npx @wahlu/cli media upload ./photo.jpg
# → media ID: mid-abc123

npx @wahlu/cli post create --name "New product launch" \
  --instagram '{"description":"Just launched!","post_type":"grid_post","media_ids":["mid-abc123"]}' \
  --tiktok '{"description":"Just launched!","post_type":"image","media_ids":["mid-abc123"]}' \
  --linkedin '{"description":"Just launched!","post_type":"li_image","media_ids":["mid-abc123"]}'

# Schedule for tomorrow at 9am
npx @wahlu/cli schedule create <content-item-id> \
  --at 2026-03-15T09:00:00Z \
  --integrations int-123 int-456 int-789

Rules

Always confirm with the user before publishing or scheduling
Use npx @wahlu/cli integration list to find integration IDs — never guess them
Use ISO 8601 format for all dates
Use --json flag when you need to parse command output programmatically

Installation

Terminal bash


openclaw install wahlu

Copied!

💻Code Examples

export WAHLU_API_KEY=wahlu_live_...

export-wahluapikeywahlulive.txt

No global install needed — use `npx @wahlu/cli` to run any command.

---

## Core Workflow

1. **List brands** — `npx @wahlu/cli brand list`
2. **Switch to a brand** — `npx @wahlu/cli brand switch <brand-id>`
3. **List integrations** — `npx @wahlu/cli integration list` (get integration IDs for scheduling)
4. **Create a post** — `npx @wahlu/cli post create --name "Title" --instagram '{"description":"Caption","post_type":"grid_post"}'`
5. **Schedule it** — `npx @wahlu/cli schedule create <content-item-id> --at 2026-03-15T14:00:00Z --integrations <id>`
6. **Upload media** — `npx @wahlu/cli media upload ./photo.jpg` (returns a media ID)
7. **Check publications** — `npx @wahlu/cli publication list`

Use `npx @wahlu/cli --help` and `npx @wahlu/cli <command> --help` to discover all commands and options. Always use `--json` when you need to parse output.

---

## What You Can Do

| Capability | Commands |
|---|---|
| **Post to 5 platforms** | `post create` with `--instagram`, `--tiktok`, `--facebook`, `--youtube`, `--linkedin` |
| **Schedule posts** | `schedule create` with `--at` (ISO 8601) and `--integrations` |
| **Upload images & video** | `media upload <file>` — supports PNG, JPG, GIF, WebP, MP4, MOV, WebM |
| **Manage posting queues** | `queue list`, `queue add <queue-id> <content-item-id>` |
| **Save content ideas** | `idea create "Name" --description "Details"` |
| **Organise with labels** | `label create "Campaign" --color "#ff5500"` |
| **View publish history** | `publication list` — see status, platform, failure reasons |
| **List connected accounts** | `integration list` — find integration IDs for scheduling |

---

## Platform-Specific Settings

Each platform has its own settings passed as JSON:

- **Instagram** — `--instagram '{"description":"...","post_type":"grid_post|reel|story","media_ids":["mid-123"]}'`
- **TikTok** — `--tiktok '{"description":"...","post_type":"video|image|carousel","media_ids":["mid-123"]}'`
- **Facebook** — `--facebook '{"description":"...","post_type":"fb_post|fb_story|fb_reel|fb_text","media_ids":["mid-123"]}'`
- **YouTube** — `--youtube '{"title":"...","description":"...","post_type":"yt_short|yt_video","media_ids":["mid-123"]}'`
- **LinkedIn** — `--linkedin '{"description":"...","post_type":"li_text|li_image|li_video","media_ids":["mid-123"]}'`

---

## Quick Examples

example.sh

# Upload an image and create a cross-platform post
npx @wahlu/cli media upload ./photo.jpg
# → media ID: mid-abc123

npx @wahlu/cli post create --name "New product launch" \
  --instagram '{"description":"Just launched!","post_type":"grid_post","media_ids":["mid-abc123"]}' \
  --tiktok '{"description":"Just launched!","post_type":"image","media_ids":["mid-abc123"]}' \
  --linkedin '{"description":"Just launched!","post_type":"li_image","media_ids":["mid-abc123"]}'

# Schedule for tomorrow at 9am
npx @wahlu/cli schedule create <content-item-id> \
  --at 2026-03-15T09:00:00Z \
  --integrations int-123 int-456 int-789