Send Listmonk Newsletters from NanoClaw

NanoClaw can create and schedule Listmonk email campaigns through Postiz. Message NanoClaw from WhatsApp, Telegram, Slack, or Discord with the newsletter content, a subject line, preview text, the subscriber list, and a send time. It uses the Postiz skill to build the campaign on your self-hosted Listmonk and schedule it.

Setup Guide GitHub

Please make sure there is always a human in the loop.

Last updated: September 2026

How do I set up NanoClaw to post to Listmonk Campaign?

Setup, then just ask

# 1. Install NanoClaw (once)
git clone https://github.com/nanocoai/nanoclaw.git
cd NanoClaw && bash nanoclaw.sh

# 2. Add the Postiz skill to your NanoClaw fork
npx skills add gitroomhq/postiz-agent

# 3. Authenticate Postiz (OAuth device flow)
postiz auth:login   # or: export POSTIZ_API_KEY=...

# 4. Connect Listmonk in Postiz, then message NanoClaw:
> Send the monthly newsletter to the
  Customers list tomorrow at 9am

NanoClaw: Done! Your Listmonk post is scheduled.

Which Listmonk features does NanoClaw support?

📧

Email Campaigns

Create and send email campaigns to your subscriber lists with rich HTML content, subject lines, and preview text.

📋

Mailing Lists

Target specific subscriber lists by ID. Send campaigns to the right audience segment every time.

🎨

Template Support

Use pre-built email templates by specifying a template ID. Maintain consistent branding across all campaigns.

👁

Preview Text

Set preview text that appears in email clients before the recipient opens the message. Boost open rates with compelling previews.

📰

Newsletter Automation

Automate recurring newsletters with scheduled sends. Let AI agents craft and deliver content on a regular cadence.

📅

Scheduled Delivery

Schedule email campaigns for optimal delivery times. Use ISO timestamps to send at exactly the right moment.

How do I post to Listmonk from NanoClaw?

You describe what you want in plain language and NanoClaw handles the Postiz calls for you. Here is how a typical conversation goes.

Find Your Listmonk Integration

Ask NanoClaw whether your Listmonk account is connected. It also checks which options the platform supports.

Example conversation

> Is my Listmonk account connected to Postiz?

NanoClaw: Yes — your Listmonk account is connected
  and ready. Want me to post something?

Compose Your Email

Write your email body in plain text or HTML. Tell NanoClaw the subject line and preview text and it sets them.

Example conversation

> Draft a Listmonk post about our new
  feature launch

NanoClaw: Here's a draft for Listmonk:
  "We just shipped something big..."
  Want me to add media and schedule it?

Schedule and Send

Schedule your email campaign for a specific time or send immediately. Target a specific list and optionally apply a template for consistent formatting.

Example conversation

> Yes — add screenshot.png and schedule
  it for tomorrow at 9am

NanoClaw: Done! Scheduled on Listmonk for
  tomorrow at 9:00 AM.

Listmonk Settings Reference

Mention any of these in plain language and NanoClaw sets them for you. These are the options every Listmonk campaign can carry.

Field	Type	Required	Description
`__type`	string	Yes	Must be "listmonk" to identify the platform
`subject`	string	Yes	Email subject line (min 1 character)
`preview`	string	Yes	Preview text shown in email clients before opening
`list`	string	Yes	List ID to send the campaign to
`template`	string	No	Template ID to use for the email layout

Common Configurations

Ask NanoClaw for any of these common Listmonk campaign scenarios and it applies the matching settings.

Weekly Newsletter

Just ask

> Post it with: Weekly Newsletter

NanoClaw: Got it. Applying:
  subject: Weekly Newsletter - March Edition
  preview: This week: new features, tips, and community highlights
  list: list-1
  template: newsletter-tmpl

Product Announcement

Just ask

> Post it with: Product Announcement

NanoClaw: Got it. Applying:
  subject: Introducing Our New Feature
  preview: We've been working on something big...
  list: list-2

Promotional Campaign with Template

Just ask

> Post it with: Promotional Campaign with Template

NanoClaw: Got it. Applying:
  subject: Flash Sale - 48 Hours Only
  preview: Up to 50% off everything in store
  list: list-3
  template: promo-template

Plain Text Update

Just ask

> Post it with: Plain Text Update

NanoClaw: Got it. Applying:
  subject: A quick note from the team
  preview: Important updates about your account
  list: list-1

What is NanoClaw?

NanoClaw is an open-source AI assistant that runs each agent in its own Docker container and is built on Anthropic's Claude Agent SDK. It was created as a smaller, easier-to-audit alternative to OpenClaw. It connects to WhatsApp, Telegram, Slack, Discord, Microsoft Teams, iMessage, and more, and supports per-group memory and recurring jobs.

📦

Container-Based

NanoClaw runs in containers for easy deployment and isolation. Spin up your social media automation agent in seconds with Docker.

💬

Multi-Platform Chat

Connect to WhatsApp, Telegram, Slack, Discord, Microsoft Teams, and more. Message NanoClaw from wherever you already communicate.

🧠

Memory & Context

Schedule recurring tasks with cron jobs. NanoClaw can send your Listmonk campaigns on a schedule without you having to ask each time.

How Postiz Works with NanoClaw

When you install Postiz Agent globally, NanoClaw automatically discovers it by reading the bundled SKILL.md file. This file tells NanoClaw what commands are available, what environment variables are needed, and how to compose Listmonk campaigns with the right settings.

✓Install Postiz skill with npx skills add gitroomhq/postiz-agent
✓NanoClaw reads the SKILL.md and learns all Postiz commands
✓Authenticate with postiz auth:login (OAuth device flow) or a POSTIZ_API_KEY
✓Skills are loaded on-demand, keeping the agent context clean
✓Built on Anthropic's Claude Agent SDK, running in an isolated Docker container

Install Postiz

# In your NanoClaw fork: add the Postiz skill
npx skills add gitroomhq/postiz-agent

# Sign in to Postiz (OAuth device flow)
postiz auth:login

# Or use an API key instead
export POSTIZ_API_KEY=your_api_key

# Check the connection
postiz auth:status
postiz integrations:list

Listmonk Campaigns with NanoClaw

Message NanoClaw from any platform — it reads the Postiz skill, discovers your Listmonk integration, and handles the entire email campaign workflow autonomously.

🐳

From Any Chat App

WhatsApp, Telegram, Slack, or Discord

Send a message to NanoClaw from your favorite chat app. It runs as a background service in an isolated container, so it picks up your message, discovers your Listmonk integration via Postiz, composes the email, and sends the campaign — all while you go about your day.

NanoClaw

You: Post to Listmonk about our new
  feature launch, schedule for tomorrow
  at 9am

NanoClaw: On it! Here's my plan:
  1. Found your Listmonk integration
  2. Composing your post
  3. Scheduling for tomorrow 9:00 AM

  Done! Your post is scheduled.
  Post ID: abc-123

🐳

Scheduled & Proactive

Cron jobs for recurring newsletters

NanoClaw supports recurring jobs you request in chat. Set up a recurring job that generates newsletter content and sends it to your Listmonk lists automatically — no manual trigger needed.

Recurring job (ask in chat)

> @Andy every weekday at 9am, check
  ~/content/posts for new files and
  schedule each one to Listmonk for
  noon. Move posted files to
  ~/content/published.

NanoClaw: Got it. I'll run this every
  weekday at 9:00 AM and schedule the
  posts through Postiz.

Why NanoClaw + Postiz for Listmonk

NanoClaw makes Postiz a natural fit for your Listmonk workflow. The agent discovers all available commands and autonomously chains them together.

✓Message from WhatsApp or Telegram to post to Listmonk — no terminal needed
✓Container-based — easy to deploy, isolate, and scale
✓Built-in memory remembers your content preferences
✓Scheduled jobs for hands-free daily posting
✓Cross-post to Listmonk + other platforms in a single conversation
✓Built on Anthropic's Claude Agent SDK, with each agent group in its own container

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Listmonk
metadata:
  NanoClaw:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Listmonk Settings
subject, preview, list, template

Does Postiz work with other agents too?

Postiz works with any AI agent that can run commands or call MCP tools — you ask, the agent does the work. That includes Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the Postiz skill so it knows what it can do, then autonomously discovers your Listmonk integration, composes your email campaign with subject, preview text, and list targeting, and sends it on schedule.

Claude Code

> Send a newsletter to list-1 about our
  new feature launch, schedule for Monday

Claude: Done! Scheduled on Listmonk for
  tomorrow at 9:00 AM.

Can NanoClaw post to Listmonk and other platforms at once?

Send an email campaign and post to social media simultaneously. Each platform gets its own settings.

Example

> Post "Excited to announce our new feature!" to
  Listmonk and LinkedIn tomorrow at 9am, then schedule
  a daily tip on Listmonk every weekday at 10am

NanoClaw: Done! Scheduled:
  - Listmonk + LinkedIn: tomorrow 9:00 AM
  - Daily tips on Listmonk: Mon-Fri 10:00 AM

What can I ask NanoClaw to post on Listmonk?

You can ask NanoClaw for anything Postiz supports on Listmonk: a single post, a scheduled batch, or a recurring job. These are prompts you would type in WhatsApp, Telegram, Slack, or Discord. @Andy is NanoClaw's default trigger word; use whatever name you gave your agent.

Monthly newsletter

Say to NanoClaw

> @Andy send the monthly update in ~/newsletters/october.md to the Customers list on the 1st at 9am, subject "October product notes"

NanoClaw: Sets subject, preview, and list ID, schedules the campaign for the 1st.

Announcement with template

Say to NanoClaw

> @Andy email the Launch Announcement template to the Waitlist list tomorrow at 10am with a two-line preview

NanoClaw: Sets template ID, list ID, and preview text.

Email plus social

Say to NanoClaw

> @Andy send the release newsletter to Customers at 9am and post a short version to LinkedIn and X at 9:30

NanoClaw: Creates one Listmonk campaign and two social posts in one request.

What should I know before posting to Listmonk from NanoClaw?

Listmonk has a few rules that Postiz enforces at publish time. NanoClaw applies them when you mention them in plain language, and asks when a required value is missing.

✓subject, preview, and list are all required. NanoClaw can look up list and template IDs with postiz integrations:settings and match the names you use.
✓template is optional; without it Listmonk uses your default campaign template.
✓Listmonk is email, not social. Sending is subject to your SMTP limits and list consent, so keep a person approving each campaign.
✓Postiz connects to your self-hosted Listmonk instance with API credentials. The instance must be reachable from Postiz.

Frequently asked questions about NanoClaw and Listmonk

How do I send a Listmonk newsletter from NanoClaw?

Install the Postiz skill in NanoClaw with npx skills add gitroomhq/postiz-agent, run postiz auth:login, and connect your Listmonk instance in Postiz. Then message NanoClaw with the email content, subject, preview text, list, and send time. It creates the campaign through Postiz and schedules it.

How does NanoClaw pick the Listmonk list and template?

Lists and templates are addressed by ID in Postiz. NanoClaw runs postiz integrations:settings for your Listmonk channel to fetch them, then matches the names you mention. If you skip the template, Listmonk applies your default. If the list name is ambiguous, it asks you to confirm first.

Can NanoClaw write the subject line and preview text?

Yes. Since NanoClaw runs on the Claude Agent SDK, it can draft a subject and a short preview from the newsletter body if you do not give them. Both are required fields in Postiz, so it will always fill them before scheduling and can show you the draft to approve in chat.

Can NanoClaw send a newsletter and social posts together?

Yes. One request can create a Listmonk campaign plus posts on LinkedIn, X, or other channels, each with its own timing and wording. Ask for the email at 9am and a shorter social version at 9:30 and NanoClaw schedules all of them in Postiz at once.

Is it safe to let NanoClaw send email campaigns?

Treat email with more care than social posts, because a mistaken send cannot be deleted. Keep NanoClaw scheduling campaigns rather than sending instantly, review them in the Postiz calendar, and restrict which lists it may use. NanoClaw runs in an isolated container, and Postiz holds the Listmonk credentials.

Post to other platforms from NanoClaw

The same Postiz skill covers 30+ channels. Start from the NanoClaw social media automation guide or jump to a platform that pairs well with Listmonk.

WordPress from NanoClaw→LinkedIn from NanoClaw→Slack from NanoClaw→Google My Business from NanoClaw→X (Twitter) from NanoClaw→

All NanoClaw guides Listmonk scheduling on Postiz Listmonk with OpenClaw Listmonk with Claude Code Postiz for any AI agent Postiz MCP server Pricing

Start sending with Listmonk

Install Postiz Agent and automate your Listmonk email campaigns with AI-powered scheduling and delivery.

Get Started