substack
Publish, edit, and manage Substack posts for the Alternative Partners publication (alternativepartners.substack.com) via the internal REST API. Use this skill when asked to post to Substack, update or edit an existing Substack post, save a draft, check a post's ID, or do any Substack publishing operation — even if the user just says "push this to Substack", "update the post", or "edit that Substack".
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/breynol01/substackWhat This Skill Does
The Substack skill for OpenClaw enables seamless, programmatic management of the Alternative Partners publication (alternativepartners.substack.com). By leveraging direct REST API interactions rather than brittle browser-automation tools like Playwright, this skill ensures high reliability when publishing, updating, or drafting content. It maintains state through session-based authentication using the connect.sid cookie, allowing the agent to perform administrative tasks directly within the Substack backend. The skill includes a robust internal conversion utility that translates plain text inputs into the ProseMirror JSON format required by Substack, handling paragraph separation automatically.
Installation
To integrate this skill, use the following command in your terminal:
clawhub install openclaw/skills/skills/breynol01/substack
After installation, you must configure authentication. Obtain your connect.sid cookie by logging into your Substack account in Chrome, opening Developer Tools, and copying the value of the substack.sid cookie. Set this value in your environment variables or secrets manager as SUBSTACK_SID. The publisher module located at publishers/substack.py handles session management automatically.
Use Cases
This skill is ideal for content teams and automated newsletter workflows. Use it to:
- Rapidly draft and publish research updates directly from your writing pipeline.
- Perform bulk edits on existing posts by targeting specific post IDs.
- Automate the synchronization of content from other databases to Substack.
- Update published posts in-place using the draft API endpoint, ensuring the most accurate content is always available to subscribers.
Example Prompts
- "Publish a new Substack post with the title 'Market Outlook 2026' and the following body: [Insert Content Here]"
- "Find the post about 'Q1 Strategy' and update the second paragraph to reflect the latest numbers."
- "Save my current notes as a draft on Substack, but don't publish it yet."
Tips & Limitations
- ProseMirror: Currently, the skill supports plain text paragraphs only. Complex formatting like bold, headers, links, or image embeds requires ProseMirror node implementation which is not yet included in the default text converter.
- Endpoint Logic: Always use the
/api/v1/drafts/{id}endpoint for both new drafts and updates to already-published posts. Attempting to use a dedicated post-update endpoint will result in a 404 error. - Authentication: If publishing fails with a 401 error, your
connect.sidhas likely expired. Log out of Substack, log back in, and update your environment secret with the fresh cookie value.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-breynol01-substack": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, external-api