A secure integration enabling automated management and safety-first previewing of Buttondown newsletter drafts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install buttondown
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install buttondown using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Buttondown Integration?
The Buttondown integration for Openclaw Skills empowers developers and AI assistants to write, update, and inspect newsletter drafts using the Buttondown API. This tool acts as a secure, local CLI layer that handles everything from parsing content files to configuring newsletter headers.
With strict safety defaults, this skill prevents accidental publication or unauthorized test emails. By utilizing Openclaw Skills, you can offload the manual orchestration of mailing lists, newsletters, and test drafts to intelligent agents while maintaining absolute control over the ultimate sending action.
Buttondown Integration Use Cases
- Creating newsletter drafts directly from local Markdown or HTML files without manual copy-pasting.
- Testing draft formats and rendering layouts by securely sending test previews to specified team members.
- Querying, tracking, and auditing existing email metadata and draft listings from a unified console.
- Safely automating marketing workflows within isolated CI/CD pipelines or AI terminal tools.
How Buttondown Integration Works
- Write the newsletter content locally as Markdown or HTML, ensuring any frontmatter metadata is omitted.
- Trigger the python script using
create-draft, passing the relevant metadata flags such as subject, editor mode, and body file. - Verify the operation's safety as the skill defaults to
status: draftand outputs the draft email identifier. - Optionally render the draft output to verify content styling and context boundaries.
- Request explicit authorization from the operator before executing any destructive commands or calling
send-draft.
Buttondown Integration Setup
Setup and Configuration
Ensure you configure your authentication environment variables before initiating the skill script. Store keys in a secure secret store rather than shell history.
# Define the mandatory Buttondown API access token
export BUTTONDOWN_API_KEY="your-api-key-here"
# Optional: Set the context for multi-newsletter environments
export BUTTONDOWN_CONTEXT="your-newsletter-username"
# Optional: Specify an alternative API endpoint base URL
export BUTTONDOWN_API_BASE="https://api.buttondown.com/v1"
Running CLI Actions
Execute command routines directly within the skill workspace:
# Generate a new draft newsletter
python3 scripts/buttondown.py create-draft --subject "Release Updates" --body-file issue.md
# Perform a dry-run check of draft creation
python3 scripts/buttondown.py create-draft --subject "Release Updates" --body-file issue.md --dry-run
# Preview a draft via test email
python3 scripts/buttondown.py send-draft <email_id> --recipient [email protected]
Buttondown Integration Data Schema & Taxonomy
Data Specifications & Structure
The Buttondown skill structures input parameters and processes local assets using the following structural components:
| Variable / Argument | Source | Description | Required |
|---|---|---|---|
BUTTONDOWN_API_KEY |
Environment | The private API key used to authenticate request payloads. | Yes |
BUTTONDOWN_CONTEXT |
Environment / CLI | Newsletter context identifier for multi-tenant accounts. | No |
--body-file |
CLI Flag | Local filesystem path referencing the markdown or raw HTML body file. | Yes (on writes) |
--editor-mode |
CLI Flag | Specifies plaintext for Markdown or fancy for full HTML editor setups. |
No |
--dry-run |
CLI Flag | Intercepts processing to inspect outbound API payloads without executing. | No |
Code Organization
scripts/buttondown.py: Core CLI integration wrapper logic written in Python.references/api.md: Comprehensive reference describing remote endpoints, errors, and JSON responses.
Buttondown Integration Advanced Features
- Dry-Run Validation: Developers can use
--dry-runflags to test draft properties, payloads, and parameters without initiating live remote updates. - Multi-Tenant Isolation: Support for dynamic context switching using the optional
BUTTONDOWN_CONTEXTheader values. - Formatting Overrides: Explicit editor mode forcing (
plaintextversusfancyeditor modes) by appending official editor settings comments directly onto payload uploads. - Hardened Safety Boundaries: Safe by design with hard draft limitations, blocking all destructive or sending operations without conversational approval.
SKILL.md
Loading
Related Openclaw Skills
Codex Adapter Toolkit
A lightweight multi-provider API adapter for Codex that enables seamless switching, failover, and local hosting across multiple LLM providers.
Quality Writer Pro
Quality Writer Pro is a comprehensive content creation and quality assurance workflow designed to help AI agents write highly engaging, structured, and fluff-free blogs, novels, technical docs, and marketing copy.
Seats.aero Monitor
An automated flight award monitor that queries the Seats.aero API, tracks state across multiple watchers, and alerts on newly available inventory.
DB Explorer
A terminal-optimized query and schema discovery assistant supporting multiple SQL and NoSQL databases.
PopaDex Finance Copilot
A read-only personal finance copilot that provides comprehensive net worth insights, retirement planning, tax comparisons, and portfolio performance analysis.
Content Publisher Pro
An automated multi-platform content publishing tool designed to compile, differentiate, and deploy Markdown articles to GitHub Pages and Dev.to with built-in SEO optimization.
Featured*
