← Back to Skills Marketplace
sociclaw

Sociclaw

by sociclaw · GitHub ↗ · v0.1.9
cross-platform ✓ Security Clean
663
Downloads
0
Stars
1
Active Installs
6
Versions
Install in OpenClaw
/install sociclaw
Description
An autonomous social media manager agent that researches, plans, and posts content.
Usage Guidance
This skill appears to do what it says: planning, content generation, optional image generation, and optional Trello/Notion sync. Before installing, consider: (1) Text‑only features require no env vars, but enabling images/credits or research requires configuring an image API base URL, an API key or a provisioning gateway URL and (optionally) Trello/Notion keys — only set those on hosts you trust. (2) The skill writes local files under .sociclaw and .tmp; if you run it on a shared or production machine, review those files and file locations. (3) The provisioning gateway URL (SOCICLAW_PROVISION_URL) will receive your provider and provider_user_id to create image API keys — only use a gateway you trust. (4) Remote logo/image fetching is disabled by default and local image inputs are restricted to allowlisted directories; these protections reduce accidental data exposure but can be changed by env flags. (5) If you will enable managed topups/provisioning, review the gateway/topup endpoints and policies outside the skill (they are external services). If you want extra assurance, run the skill in an isolated environment (virtualenv or dedicated VM) and inspect the code paths you expect to use (image provisioning, topup, Trello/Notion sync) before enabling those integrations.
Capability Analysis
Type: OpenClaw Skill Name: sociclaw Version: 0.1.9 The OpenClaw SociClaw skill is classified as benign. The code and documentation demonstrate a strong focus on security and transparency. Key indicators include explicit hardening measures such as restricted local file access for image inputs (`SOCICLAW_ALLOWED_IMAGE_INPUT_DIRS`), strict allowlisting and IP address checks for remote image URLs (`SOCICLAW_ALLOWED_IMAGE_URL_HOSTS`, `_is_allowed_remote_image_url` in `image_provider_client.py`), and a deliberate decision to prevent automatic `git pull` or `pip install` during self-update (`cmd_self_update` in `cli.py`). The `SKILL.md` provides clear agent instructions and guardrails against prompt injection, explicitly detailing local file writes and network calls, all of which align with the stated purpose of social media management. No evidence of intentional data exfiltration to unauthorized endpoints, malicious execution, persistence mechanisms, or obfuscation was found.
Capability Assessment
Purpose & Capability
Name/description (autonomous social‑media manager) aligns with the code and SKILL.md. The code implements content generation, scheduling, image generation, Trello/Notion sync, provisioning/topups and persistent local state — all coherent with the stated purpose. Declared binaries (python3) and dependencies (requests, tweepy, py‑trello, notion‑client) are expected for this functionality.
Instruction Scope
SKILL.md explicitly limits network calls and file access to feature‑enabled flows and documents the local files the skill writes (.sociclaw/, .tmp/). The runtime rules restrict image inputs to allowlisted local dirs by default and disable remote logo fetching by default. The instructions do ask the agent to write local state (configs, memory DB, generated images) and to call provisioning/image/Trello/Notion endpoints when enabled — expected, but these are side effects users should accept consciously.
Install Mechanism
No install spec / external downloads are used. The skill is delivered as Python source and relies on standard Python dependencies in requirements.txt. No remote archives or URL downloads are executed by the install process shown.
Credentials
SKILL.md/README declare no required env vars for text‑only operation. Optional environment variables (SOCICLAW_IMAGE_API_BASE_URL, SOCICLAW_IMAGE_API_KEY, SOCICLAW_PROVISION_URL, TRELLO_/NOTION_ keys, XAI_API_KEY, etc.) are used only for their respective integrations. The number of optional env vars is moderate and proportional to the optional features; none appear unrelated to the skill's purpose. Users should avoid pasting secrets in chat and only configure envs on trusted hosts.
Persistence & Privilege
The skill does persist local state (.sociclaw, .tmp) as described in SKILL.md. It does not request always:true or other special platform privileges. Persisted files and local DBs are limited to the skill's own directories and are consistent with the functionality (plans, brand profile, memory, generated images).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install sociclaw
  3. After installation, invoke the skill by name or use /sociclaw
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.9
Version 0.1.9 - Bumped skill version to 0.1.9 in skill metadata. - No functional or file content changes detected.
v0.1.8
Version 0.1.8 - Removed deprecated updater script (`sociclaw/scripts/updater.py`). - Clarified in documentation that `/sociclaw update` now only provides manual instructions and does not execute code.
v0.1.7
SociClaw 0.1.7 refines setup requirements and improves transparency around permissions and data handling. - Environment variables are now optional for text-only planning and generation; config requirements relaxed. - Added a new runtime permissions & data handling section to SKILL.md, clearly listing files written and when network calls occur. - Setup wizard inputs clarified; only essential information is required unless user opts in to integrations. - Improved image input security and transparency in documentation (local/remote restrictions and overrides). - Internal: Added updater script; removed unused payment handler. - Documentation updates clarify onboarding, integrations, and runtime privacy defaults.
v0.1.6
- Removed obsolete client provisioning and updater scripts. - Updated SKILL.md requirements: now explicitly declares required binaries and environment variables. - Enabled command dispatch and standardized emoji for responses. - Improved onboarding and secrets handling documentation. - Minor metadata and version update.
v0.1.5
- Initial test suite added: 26 new test files covering key CLI commands, core logic, and integration flows. - Coverage includes brand profile, environment checks, command dispatch, image generation, release audit, provisioning, and state management. - No changes to user-facing features or operational flows. - Internal version and metadata updated.
v0.1.0
Initial public release of SociClaw autonomous social media manager. - Introduces Soci, a senior operator-focused AI agent for managing social media accounts autonomously. - Supports research, planning, and posting with persistent memory and integration to Trello, Notion, and custom image generation API. - Onboards users step-by-step, prioritizing practical, concise dialogue and custom brand voice. - Built-in strategy optimizes for engagement and retention—favoring replies, threads, visual diversity, and quality over quantity. - Includes robust fail-handling, personality, and onboarding contracts to ensure clarity and brand coherence throughout the experience.
Metadata
Slug sociclaw
Version 0.1.9
License
All-time Installs 1
Active Installs 1
Total Versions 6
Frequently Asked Questions

What is Sociclaw?

An autonomous social media manager agent that researches, plans, and posts content. It is an AI Agent Skill for Claude Code / OpenClaw, with 663 downloads so far.

How do I install Sociclaw?

Run "/install sociclaw" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Sociclaw free?

Yes, Sociclaw is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Sociclaw support?

Sociclaw is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Sociclaw?

It is built and maintained by sociclaw (@sociclaw); the current version is v0.1.9.

💬 Comments