AdaptlyPost
AdaptlyPost plugin for OpenClaw: schedule and publish social posts to 14 platforms and answer comments, messages and reviews
AdaptlyPost plugin for OpenClaw
Schedule and publish social posts to LinkedIn, X, Instagram, Facebook, TikTok, YouTube, Pinterest, Threads, Bluesky, Mastodon, Google Business Profile, Telegram, Tumblr and WordPress, from inside OpenClaw. Read and answer the comments, mentions, direct messages and Google reviews those accounts get.
Install
openclaw plugins install clawhub:@adaptlypost/openclaw-plugin
openclaw plugins enable adaptlypost
openclaw gateway restart
Create a dedicated, revocable token at adaptlypost.com under Settings, then API Tokens. Do not reuse a token that other tools or people also hold.
{
plugins: {
entries: {
adaptlypost: {
enabled: true,
config: {
apiToken: "adaptly_...",
mediaDirs: ["~/Pictures/social"]
}
}
}
}
}
The token decides the account group, so you never pass an account id. Connect only the accounts the agent actually needs, since the token reaches every account in the group.
The token also carries a role, chosen when you create it, and never does more
than you can. A Contributor token lets the agent draft and upload but not
schedule, publish or retry; give it an Editor token only when the agent itself
must publish. The plugin reads GET /me once per token before it asks you to
approve a scheduled or live post. When the token cannot do what the agent asked,
the prompt says so up front and approving saves the post as a draft instead, for
you to publish in the AdaptlyPost app. A retry with such a token is refused
before it reaches you. When AdaptlyPost itself answers 403 permission_denied,
the agent sees the server's message, the missing permission and the token's
role, and is told to stop rather than retry. When the member who created the
token has since been demoted below the token's role, both roles are named,
because the token holds only that member's permissions.
mediaDirs lists the folders the agent may upload local files from. Leave it
out and only URL uploads work. Don't point it at your home folder; the plugin
refuses that, and the filesystem root too.
Approvals
Four actions put something in public, so each one stops for your approval before it runs:
- uploading media, since a stored file gets a public URL right away
- scheduling a post, including a recurring one, where the prompt also says how it repeats (for example "Repeats weekly on Mon, Fri until 2026-12-31.")
- publishing a post now
- retrying failed platforms, which republishes immediately
Inbox writes that other people see, or that remove something, stop for approval
too: replying to a comment or a mention, sending a direct message, putting or
deleting a Google review reply, and hiding, unhiding or deleting a comment. The
prompt shows the exact text, the platform and account, who wrote the item and a
short quote of it. The plugin reads the comment or conversation first; mentions
and reviews are found among the 100 most recent. When that lookup fails the
prompt names the item by id, and an id that does not exist is refused before
the prompt. A token without inbox.reply (Contributor and Viewer), a comment
whose capabilities rule the action out, and a Facebook or Instagram
conversation whose 24-hour reply window has closed are refused before the
prompt as well. Liking or unliking a comment, marking items read or done, and
refreshing the inbox need no approval. Marking and refreshing change nothing
outside AdaptlyPost, and a like is small and undone with one call.
Unscheduling a post and pausing, resuming or deleting a recurring post also stop for approval. The prompt names the series, its schedule, its accounts and its text. A token whose role cannot change a scheduled series, or cannot unschedule a scheduled post (Contributor and Viewer), is refused before the prompt.
Team changes that remove someone or something, or let someone in, stop for approval as well: deleting a workspace, removing a member from the workspace, removing someone from the organization, sending an invitation and revoking one. The prompt says what goes: the workspace's name, its post count and that its posts, recurring posts, RSS feeds, inbox items, API keys and connect links go with it; the member's name, email and roles, and whether they leave one workspace or the whole organization; the invitation's email, roles and workspaces. An API key can only read its own workspace, so another workspace, or a person who is not in the key's workspace, is named by id and the prompt says so. A token without the Admin role, the default workspace, the key's own workspace while it still has connected accounts, the organization owner, a member id that is not in the workspace and an invitation that is no longer pending are refused before the prompt. Listing workspaces, members and invitations and creating a workspace need no approval.
The prompt shows everything that will go public: each file with its full path
or URL, each account by name, the timing, each platform's visibility and title,
and every caption including per-platform overrides. It also lists each first
comment, each thread reply with its image count, Instagram collaborators, tagged accounts, audio and story sharing,
Facebook story sharing and text backgrounds, the Google Business Profile topic, event, offer
and button, each platform's own media, per-platform thumbnails and image shapes, and X links that stay
clickable. OpenClaw caps a prompt at
512 characters. When a call doesn't fit, the plugin refuses it instead of
cutting anything, and tells the agent to save a draft or split the call. The
prompt offers "allow once" and "deny", never "always". The plugin ties each approval
to one tool call and a hash of its exact arguments, so a changed or replayed
call is refused. Saving a draft, or checking a post with
adaptlypost_validate_post, needs no approval.
When nobody can answer (a cron run, or a channel without approval support),
OpenClaw denies the call. Unattended agents can still save drafts. To get the
prompts in a chat channel, set approvals.plugin in your OpenClaw config; see
OpenClaw's plugin permission requests docs.
What the plugin refuses
- A scheduled or live post to an account whose status is
unauthorizedis refused before the prompt, because AdaptlyPost would refuse it with 400. The agent is told to have you reconnect the account or leave it out. - API calls go only to
https://post.adaptlypost.com/post/api/v1. The base URL is fixed in code and redirects are not followed, so the token cannot be sent anywhere else. - Local uploads must resolve, symlinks included, to a file inside
mediaDirs. Hidden files and folders are skipped, and a file must really be a JPEG, PNG, WebP, GIF, MP4 or QuickTime file, or a PDF, PPT, PPTX, DOC or DOCX document. The plugin checks its first bytes, not just the name. The size limit is 50 MB per image and 1 GB per video. - URL uploads must be
https://on port 443 without credentials. The plugin checks the addresses each connection actually uses, including after each of up to three redirects, against the loopback, private, link-local, CGNAT, multicast and reserved ranges, so DNS rebinding cannot slip past it. Downloads stop at 250 MB or two minutes.
Tools
| tool | what it does |
|---|---|
adaptlypost_accounts | List connected accounts and their connection ids, with status (active or unauthorized). Call this first. |
adaptlypost_check_account | Ask Facebook right now whether a page's token still works and return its fresh status. Use after the user reconnects a page. |
adaptlypost_remove_account | Disconnect an account from the workspace, unauthorized ones included. Admin keys only. Needs approval. |
adaptlypost_search_instagram_audio | Search Instagram music and original sounds, or list trending audio, for a Reel. |
adaptlypost_list_pinterest_boards | List the boards a Pinterest account can pin to, secret boards included. |
adaptlypost_list_wordpress_categories | List the categories of a WordPress site, to pass their ids as wordpressConfigs[].categoryIds. |
adaptlypost_resolve_linkedin_organization | Look up a LinkedIn company page by its URL or vanity name and return the mention to paste into a LinkedIn post. |
adaptlypost_upload_media | Upload files from mediaDirs or public URLs, returns public media URLs. Needs approval. |
adaptlypost_create_post | Draft, schedule, or publish one post across any set of accounts. mode is required; SCHEDULE and PUBLISH_NOW need approval. |
adaptlypost_validate_post | Check a post without creating it. Takes the same parameters as adaptlypost_create_post and returns each account's status, the issues to fix and what only the platform can decide. Needs no approval. |
adaptlypost_list_posts | List posts, including scheduled and draft. |
adaptlypost_post_results | Read the per-platform result for one post. |
adaptlypost_retry_failed | Retry only the platforms that failed. Needs approval. |
adaptlypost_unschedule_post | Take a scheduled post off the calendar and keep it as an undated draft. Needs approval. |
adaptlypost_list_recurring_posts | List recurring posts, filtered by ACTIVE, PAUSED or ENDED. |
adaptlypost_get_recurring_post | Read one recurring post, including why it paused. |
adaptlypost_pause_recurring_post | Stop a series and delete its upcoming scheduled post. Needs approval. |
adaptlypost_resume_recurring_post | Restart a paused series from the next date after now. Needs approval. |
adaptlypost_delete_recurring_post | Delete a series for good. Published posts stay. Needs approval. |
adaptlypost_analytics_overview | Views, likes, comments, shares, followers and engagement for a date window, against the previous window. |
adaptlypost_post_analytics | Per-post metrics, sortable by any metric; top posts and "how did this post do". |
Inbox tools:
| tool | what it does |
|---|---|
adaptlypost_inbox_summary | Unread counts per channel, and per account whether comments, mentions, messages and reviews are available or need a reconnect. Start here. |
adaptlypost_refresh_inbox | Queue an inbox sync now instead of waiting for the next 10-minute run. |
adaptlypost_list_inbox_comments | List comments on the workspace's posts, filtered by account, platform, status, date, text or post. |
adaptlypost_get_inbox_comment | Read one comment with its parent and replies. |
adaptlypost_reply_inbox_comment | Reply publicly to a comment. Needs approval. |
adaptlypost_hide_inbox_comment | Hide a comment on the platform. Needs approval. |
adaptlypost_unhide_inbox_comment | Make a hidden comment visible again. Needs approval. |
adaptlypost_like_inbox_comment | Like a comment on Facebook, Bluesky, Mastodon or LinkedIn. |
adaptlypost_unlike_inbox_comment | Take a like back. |
adaptlypost_delete_inbox_comment | Delete a comment on the platform. Needs approval. |
adaptlypost_update_inbox_comments_status | Mark comments unread, read or done in AdaptlyPost. |
adaptlypost_list_inbox_mentions | List posts that mention the accounts. |
adaptlypost_reply_inbox_mention | Reply publicly to a mention. Needs approval. |
adaptlypost_update_inbox_mentions_status | Mark mentions unread, read or done. |
adaptlypost_list_inbox_conversations | List direct-message conversations. |
adaptlypost_get_inbox_conversation | Read one conversation with its messages. |
adaptlypost_send_inbox_message | Send a direct message. Needs approval. |
adaptlypost_update_inbox_conversations_status | Mark conversations unread, read or done. |
adaptlypost_list_inbox_reviews | List Google Business Profile reviews, filtered by rating or whether they have a reply. |
adaptlypost_reply_inbox_review | Put or replace the business's reply to a review. Needs approval. |
adaptlypost_delete_inbox_review_reply | Delete the business's reply to a review. Needs approval. |
adaptlypost_update_inbox_reviews_status | Mark reviews unread, read or done. |
Team tools:
| tool | what it does |
|---|---|
adaptlypost_list_workspaces | The key's workspace with its organization, role and permissions. |
adaptlypost_create_workspace | Create a workspace in the organization, optionally with a cap on connected accounts. Admin keys only. |
adaptlypost_delete_workspace | Delete a workspace with everything it holds. Admin keys only. Needs approval. |
adaptlypost_list_members | List the workspace's members with their workspace and organization roles. |
adaptlypost_remove_member | Remove a member from the workspace and revoke their keys and connect links there. Admin keys only. Needs approval. |
adaptlypost_remove_organization_member | Remove someone from the organization and every workspace in it. Admin keys only. Needs approval. |
adaptlypost_list_invitations | List the invitations that include the workspace. Admin keys only. |
adaptlypost_send_invitation | Email an invitation to the organization with a role per workspace. Admin keys only. Needs approval. |
adaptlypost_revoke_invitation | Revoke a pending invitation. Admin keys only. Needs approval. |
Creating or deleting a workspace and removing someone from the organization also need the key's creator to be an organization owner or admin.
Fifty-two tools, fewer than the MCP server exposes. Post editing, deletion, draft publishing, bulk scheduling and the finer analytics cuts (timeseries, per-platform breakdown, sync control) stay out. Those live in the MCP server and the REST API.
Things worth knowing
Connection ids are per platform and go in the matching array, so a LinkedIn id
belongs in linkedinConnectionIds. Facebook is the exception: pages have no
username, so they carry a pageId and go in pageIds.
TikTok needs privacyLevel in tiktokConfigs and has no default; the post is
rejected outright without it. For Pinterest, pass the board the user named as
boardName in pinterestConfigs; AdaptlyPost finds it among that account's
boards and answers 400 when no board or several boards have that name. Or find
a board with adaptlypost_list_pinterest_boards and pass its id as
boardId. Send one or the other, not both. A board belongs to one Pinterest
account. With neither, the pin goes to a public board named "AdaptlyPost",
created on the account the first time it is needed, and the approval prompt
says so.
Google Business Profile locations go in googleBusinessConnectionIds. A post
there is text, or text with one JPEG or PNG image up to 5 MB, up to 1500
characters. Without a googleBusinessConfigs entry it goes out as a plain
update; set topicType to EVENT or OFFER for an event or offer, and
callToActionType for a button.
Telegram channels and groups go in telegramConnectionIds. A post there is
text up to 4096 characters, up to 10 JPEG, PNG or WebP images of 10 MB each, or
one MP4 or MOV video up to 50 MB. A caption over 1024 characters goes out as
its own message after the media, and a video takes an image or a frame as its
thumbnail through platformThumbnails. A Telegram chat is connected in the AdaptlyPost app, on
the Connectors page, not through the plugin.
Tumblr blogs go in tumblrConnectionIds, and tumblrConfigs adds tags, a
title and a source link. WordPress sites go in wordpressConnectionIds: the
text becomes the body of a published blog post, the first image is the
featured image, and wordpressConfigs sets the title, excerpt, categories and
tags. Find category ids with adaptlypost_list_wordpress_categories. Both are
connected in the AdaptlyPost app.
firstComments adds a comment from the same account within about a minute of
the post going out (about two minutes on YouTube) on LinkedIn, YouTube,
Facebook and Instagram, or a reply on X, Threads, Bluesky and Mastodon. A
failed comment never fails the post. An entry's optional delayMinutes (0 to
10080, 7 days) posts the comment within about a minute of that many minutes
after the platform publishes; omitted or 0 means no delay. Once
the post is published the delay cannot be changed, and deleting the post
cancels a comment that has not gone out yet. The approval prompt shows the
delay when one is set.
linkedinConfigs[].reshareOf reshares a LinkedIn post from the account, and
twitterConfigs[].quoteOf quotes one of the X account's own posts, each with
the post text as the commentary. The approval prompt names the post being
reshared or quoted.
To mention a LinkedIn company page, call
adaptlypost_resolve_linkedin_organization with the page URL
(https://www.linkedin.com/company/acme/) or its vanity name and paste the
mention it returns into the LinkedIn text as is. LinkedIn matches the exact
vanity name only, so ask the user for the page URL when you don't know it. When
the post also goes to other platforms, put the mention in platformTexts for
LINKEDIN, since other platforms show the syntax as raw text.
threadReplies turns the post into a thread on X, Threads, Bluesky or
Mastodon: the post opens it, and each text goes out from the same account as a
reply to the one before, up to 25 replies per platform. mediaUrls runs
parallel to texts and gives each reply up to 4 images from
adaptlypost_upload_media, [] for a reply without any. A reply with images
may have no text. Each reply is held to the platform's limit: 280 characters
on X (more on X Premium), 500 on Threads, 300 on Bluesky and 500 on Mastodon,
and never more than 25000. A platform takes a thread or a first comment, not both. Replies start about 10
seconds after the post goes out, and a failed thread never fails the post.
To add music to an Instagram Reel, find an audioId with
adaptlypost_search_instagram_audio and pass it in instagramConfigs[].audio.
It works for Instagram accounts connected through Facebook, which
adaptlypost_accounts marks with supportsInstagramAudio: true.
instagramConfigs[].userTags tags up to 20 public Instagram accounts in one
image or one video, feed or story. Each tag is a username with x and y
from 0 to 1, measured from the top-left corner. A feed image needs both on
every tag, a story takes them optionally, and a video ignores them. A carousel
or several stories with tags is refused.
recurrence on adaptlypost_create_post repeats a post daily, weekly,
monthly or yearly. It needs mode SCHEDULE, since the first post sets the time of day, and
it cannot include TikTok. X and LinkedIn reject repeated identical text, so put
spintax such as {Hi|Hello} in the caption. Editing a series or skipping one
date happens in the AdaptlyPost app.
platformMedia gives one platform its own media when the post media does not
fit it, such as a shorter cut of a video too long for TikTok, or 4 images for X
from a bigger carousel. Each entry names the platform and its mediaUrls from
adaptlypost_upload_media, with optional mediaAltTexts in the same order.
The entry must match contentType, and is checked against that platform's
limits only. Other platforms keep the post mediaUrls. An overridden platform
skips the post thumbnail, so give it its own through platformThumbnails. The
approval prompt lists each platform's own files.
Media has to reach storage before the post references it. adaptlypost_upload_media
does the presign and the PUT together, so a post that names an unstored file
fails with "Media file(s) not found in storage".
adaptlypost_validate_post takes the same parameters as
adaptlypost_create_post and creates nothing. It runs every check the create
call runs, plus the ones that usually fail only at publish time: TikTok creator
limits, the YouTube upload quota, expired Instagram and Threads tokens, Pinterest
boards and X credits. Each account comes back READY, WARNING or BLOCKED
with the issues to fix. A post the create call refuses for its content answers
400 post_validation_failed, and the plugin passes on every issue in the error.
Every platform publishes on its own. Read adaptlypost_post_results per
platform rather than treating a post as one pass or fail. A platform
restriction is that platform's decision about the account, and retrying will
not clear it. A dead token or rejected media will.
Analytics cover Facebook, Instagram, Threads, TikTok, Pinterest, Bluesky,
YouTube, X, LinkedIn and Google Business Profile. Google Business Profile
reports how often the location was seen, with no numbers per post. Mastodon,
Telegram, Tumblr and WordPress have no analytics, so they come back empty. Connecting an account
imports its posts from the last 180 days, and analytics are kept from then on
while it stays connected. A null metric means
the platform does not report it, which is not the same as zero. LinkedIn
personal profiles and Google Business Profile locations, listed in
accountActivityConnectionIds, count their account-wide activity per day
instead of the posts published in the window, and have no per-post rows.
The inbox collects comments (Facebook, Instagram, Threads, YouTube, Bluesky,
Mastodon, LinkedIn), mentions (Facebook, Instagram, Threads, Bluesky,
Mastodon), direct messages (Facebook, Instagram, Bluesky, Mastodon) and Google
Business Profile reviews. TikTok and X have no inbox. Each connection syncs
about every 10 minutes. Reading needs any role; answering, hiding, deleting,
liking and marking need an Editor or Admin token and an active plan. A channel
marked RECONNECT_REQUIRED, or a write refused with inbox_reconnect_required,
means the account has to be reconnected in AdaptlyPost; some Messenger,
Instagram message and Threads mention permissions are still in platform review.
Facebook and Instagram take a direct message only within 24 hours of the
person's last one.
The API allows 600 requests per minute per token. A 429 comes back with
Retry-After and the plugin surfaces it rather than hammering.
Notes for anyone building an OpenClaw plugin
openclaw.compat.pluginApi in package.json is a semver range matched against
the host version, and the host version is the OpenClaw release, 2026.8.1. The
"1.0.0" that appears in published examples can never match it, and the install
fails with requires plugin API 1.0.0, but this OpenClaw runtime exposes 2026.8.1. Use ">=2026.8.0".
Two more, both caught by typechecking against OpenClaw's own .d.ts rather than
the docs:
registerTooltakes a SINGLE object. Itsparametersfield is a TypeBox schema, not JSON Schema, and the real fields arename,label,description,parametersandexecute.definePluginEntryrequiresid,nameanddescriptionalongsideregister.
A manifest id that differs from the npm package name is fine. The installer
warns and uses the manifest id as the config key, which is why the config block
above says adaptlypost and not @adaptlypost/openclaw-plugin.
Develop
npm install
npm run build
openclaw plugins install --link . --force --accept-capabilities
openclaw plugins inspect adaptlypost --runtime --json
Needs Node >=22.22.3 <23 || >=24.15.0 <25 || >=25.9.0. npm install runs
OpenClaw's version guard on postinstall and stops outside that range.
MIT licensed. Source: adaptlypost/adaptlypost-openclaw
