Skip to content

Manage Saved stickers

Use the owner-only wechat_stickers tool to manage the configured account’s Saved stickers. It works with the active session’s file transport, so the execution workspace can live on a different machine from the Gateway and daemon.

  1. List the account’s Saved stickers.

    {"action":"list"}

    The result includes ordered items and a revision. Keep that revision for placement or removal; stale revisions fail instead of replacing phone edits.

  2. Inspect one sticker visually.

    {"action":"preview","stickerId":"STICKER_ID"}

    Preview returns image content to model vision. Animated GIF previews contain sampled frames; a still preview does not establish animation playback. get returns metadata and media references without delivering visual input.

  3. Download an original into the execution workspace.

    {"action":"download","stickerId":"STICKER_ID","output":"stickers/chosen.gif","idempotencyKey":"chosen-original-1"}

    A missing original returns a download job with staged:false. After that job completes, repeat the request. A successful staged result includes the actual workspace-relative path, MIME type, byte length and checksum. The extension must match the real original, including .wxgf when applicable.

  4. Prepare a file made by remote execution.

    {"action":"prepare","file":"stickers/clip.mp4","startMs":1000,"durationMs":2000,"maxEdge":360,"fps":12,"idempotencyKey":"clip-prepare-1"}

    Use preview with the returned preparationId, then save it:

    {"action":"add","preparationId":"PREPARATION_ID","idempotencyKey":"clip-save-1"}

    Preparation alone neither saves nor sends.

  5. Save a sticker someone sent you by its message ID.

    {"action":"add","messageId":"MESSAGE_ID","idempotencyKey":"received-save-1"}

    The plugin finds that message’s original sticker. It fails when the message has no received sticker, or more than one original.

ActionRequired selection
movestickerId, current revision, afterId (null for first), stable idempotencyKey
removestickerId, current revision, stable idempotencyKey
Prepared preview/downloadpreparationId, and output for download

The host reads SSH-sandbox files through its filesystem bridge and paired-node files through its workspace adapter. The plugin uploads bytes from that reader; it does not open a matching Gateway path or establish its own SSH connection. Downloads use the same host transport in the other direction. Daemon credentials stay on the Gateway. Unsupported host capabilities fail before reporting staging success; ordinary unbound local paths are not assumed to be the active workspace.

Send an existing Saved reference through OpenClaw’s standard message tool:

{"action":"sticker","channel":"agent-wechat","target":"CONTACT_ID","stickerId":["STICKER_ID"]}

This owner-only action returns the daemon job. The host supplies its stable submission key; keep that key when checking an uncertain result. A queued job is not a delivered-message receipt. No original download/re-upload is needed.