Public Profile Sync

public-profile-sync is an OpenClaw skill for collecting user-authorized public profile data, normalizing it, redacting direct identifiers, and persisting a verified local artifact set for downstream sync.

What It Does

• Collects public account and activity data from supported platforms
• Resolves the active local account from the OpenClaw environment when possible
• Prefers platform API or JSON sources when they are available
• Falls back to browser-based collection when API access is blocked or unavailable
• Writes four verified JSON artifacts for audit, upload preparation, execution status, and incremental sync

Current Platform Support

• Reddit: implemented
• Amazon: reserved adapter slot, not implemented yet

Output Files

Each successful sync writes these four files:

• raw_snapshot.json Local audit artifact. Stays as close as practical to source-platform structures.
• upload_payload.json Redacted, relationally friendly payload for local/staging upload or downstream ingestion.
• upload_result.json Execution receipt with source path, dataset coverage, artifact status, and diagnostics.
• sync_cursor.json Cursor anchor for future incremental sync runs.

Data Model Philosophy

This skill intentionally separates:

• source-shaped local data
• upload-shaped redacted data

For Reddit specifically:

• raw_snapshot.json tries to align with Reddit JSON-style thing / Listing structures
• upload_payload.json is not a Reddit API mirror; it is a privacy-preserving normalized projection

See:

• references/platforms/reddit.md
• references/platforms/reddit-field-mapping.md
• references/privacy-redaction.md
• references/data-model.md

Triggering

The skill supports:

• natural-language intent, such as “collect my public account info”
• structured backend task messages

Recommended structured task shape:

[ProfileSyncTask]
version: 1
platform: reddit
mode: full
authorization: granted
identity_resolution: local-session-first
allow_browser_fallback: true
output_dir: data/public-profile-sync/reddit/<platform-account-key>
upload_target: local-only
upload_url:
cursor_file:
request_id: profile-sync-20260320-001
account_ref: acct_local_primary

Current Reddit Behavior

• Official Reddit API documentation exists at https://www.reddit.com/dev/api/
• Stable Data API access should use OAuth when available
• On this environment, legacy public .json user endpoints were not reliable
• Browser fallback is therefore an important path for Reddit v1

Repository Layout

• SKILL.md Skill definition for OpenClaw
• agents/openai.yaml UI metadata
• assets/ Task envelope, file manifest, and JSON schema contracts
• references/ Platform adapters, redaction rules, field mapping, and relational model notes

Notes

• This repository keeps only the skill source and reference files
• Runtime output files are written under the OpenClaw workspace data area, not in this repository
• The skill is designed to avoid machine-specific executables in the main control path