[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75M2GDZ2659ZGXE2WBYATT9":3,"skill-same:01M75M2GDZ2659ZGXE2WBYATT9":53},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":6,"ownerHtmlUrl":35,"ownerBlogUrl":36,"ownerDescription":37,"updatedAt":38,"install":39,"resources":52},"01M75M2GDZ2659ZGXE2WBYATT9","social-media-ops",null,"Set up a complete multi-brand social media management team on OpenClaw. Scaffolds 5 specialized agents (Leader, Creator, Worker, Researcher, Engineer) + on-demand Reviewer in a star topology with persistent A2A sessions, 3-layer memory system, shared knowledge base, approval workflows, and brand isolation. Use when setting up a new social media operations team, adding the multi-agent framework to an existing OpenClaw instance, or when the user mentions social media management, multi-brand operations, or content team setup.","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fkuan0808\u002Fsocial-media-ops\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: social-media-ops\ndescription: Set up a complete multi-brand social media management team on OpenClaw. Scaffolds 5 specialized agents (Leader, Creator, Worker, Researcher, Engineer) + on-demand Reviewer in a star topology with persistent A2A sessions, 3-layer memory system, shared knowledge base, approval workflows, and brand isolation. Use when setting up a new social media operations team, adding the multi-agent framework to an existing OpenClaw instance, or when the user mentions social media management, multi-brand operations, or content team setup.\nmetadata:\n  {\n    \"openclaw\": {\n      \"emoji\": \"📱\",\n      \"requires\": {\n        \"bins\": [\"node\"]\n      }\n    }\n  }\n---\n\n# Social Media Ops\n\n## Overview\n\nThis skill sets up a complete AI-powered social media operations team on OpenClaw. It creates:\n\n- **5 specialized agents** in a star topology (Leader + 4 specialists) + on-demand Reviewer\n- **Persistent A2A sessions** for context-preserving multi-agent workflows\n- **3-layer memory system** (MEMORY.md + daily notes + shared knowledge base)\n- **Shared knowledge base** with brand profiles, operations guides, and domain knowledge\n- **Approval workflow** ensuring nothing publishes without owner approval\n- **Brand isolation** with per-brand channels, content guidelines, and asset directories\n- **Cron automation** for daily memory consolidation and weekly KB review\n\n## Optional Dependencies\n\n- **Image generation tool for Creator agent**: The Creator agent requires an image generation tool installed in its `workspace-creator\u002Fskills\u002F` directory to produce images. Recommended: `nano-banana-pro` (Gemini-based, free tier). Without it, Creator produces text visual briefs only and cannot generate images.\n\n## Prerequisites\n\nBefore installing, ensure:\n\n1. OpenClaw v2026.2.26+ is installed and `openclaw onboard` has been completed\n2. At least one auth profile exists (e.g., Anthropic API key)\n3. The `~\u002F.openclaw\u002F` directory exists\n\n## Quick Start\n\n```\n1. Install the skill (if not already in workspace\u002Fskills\u002F)\n2. Trigger setup: \"Set up my social media operations team\"\n3. Follow the interactive onboarding (6 steps, ~10 minutes)\n4. Start creating content!\n```\n\n## Onboarding Flow\n\nWhen first triggered, this skill runs an interactive setup process.\n\n### Step 1: Prerequisites Check\n\nVerify the environment is ready:\n\n- [ ] OpenClaw installed and `openclaw onboard` completed\n- [ ] `~\u002F.openclaw\u002F` directory exists\n- [ ] At least one auth profile configured\n\nIf any prerequisite is missing, guide the user to resolve it before continuing.\n\n### Step 2: Team Setup\n\n**All 5 agents are installed automatically.** Do not ask the user to choose a team size.\n\nThe full team:\n\n| Agent | Role |\n|-------|------|\n| Leader | Orchestration, routing, quality gates |\n| Creator | Content + visual (copywriting, image gen, platform formatting) |\n| Worker | Execution for Leader (files, CLI, config, maintenance) |\n| Researcher | Market research, competitor analysis |\n| Engineer | Technical integrations, automation |\n\n**On-demand:**\n\n| Agent | Role |\n|-------|------|\n| Reviewer | Independent quality review (spawned when needed) |\n\n**Model** — All agents inherit the model configured during `openclaw onboard` (at `agents.defaults.model`). No per-agent model setup is needed.\n\n> **Advanced note:** If you later want to run a leaner team, re-run `scaffold.sh --agents leader,creator,engineer` to scaffold a subset.\n\n### Step 3: Run Scaffold\n\nExecute the setup scripts to create all directories and files first:\n\n```bash\n# 1. Create directories, copy templates, set up symlinks\nbash scripts\u002Fscaffold.sh \\\n  --skill-dir \"$(pwd)\"\n\n# 2. Merge agent configuration into openclaw.json\nnode scripts\u002Fpatch-config.js \\\n  --config ~\u002F.openclaw\u002Fopenclaw.json\n```\n\nThe scaffold creates:\n- Agent workspace directories with SOUL.md, AGENTS.md, MEMORY.md\n- Shared knowledge base with all template files\n- Symlinks from each workspace to shared\u002F\n- Sub-skills (instance-setup, brand-manager) in Leader's skills\u002F\n- Cron job definitions\n\nThe config patcher merges into openclaw.json:\n- Agent definitions with model assignments and tool restrictions\n- A2A session configuration\n- QMD memory paths (**only if QMD is installed** — otherwise skipped with a suggestion)\n- Internal hooks\n\n### Step 4: Telegram Setup\n\nThis step uses a **guided flow** — do not ask the user for raw chat IDs or thread IDs.\n\n#### Phase A: Confirm Bot Token\n\n1. Check `openclaw.json` for `channels.telegram.botToken`\n2. If present → skip to Phase B\n3. If missing → guide the user:\n   - \"Open Telegram, search for **@BotFather**\"\n   - \"Send `\u002Fnewbot` and follow the prompts to create a bot\"\n   - \"Copy the bot token and paste it here\"\n   - Write the token into `openclaw.json` at `channels.telegram.botToken`\n\n#### Phase B: Choose Channel Mode\n\nPresent the options in this order (Group+Topics first):\n\n1. **Group+Topics (recommended)** — Best for most setups\n   - Brands are topic threads inside a Telegram supergroup\n   - Works for both solo operators and multi-person teams\n   - Requires a supergroup with Topics enabled\n\n2. **DM+Topics** — Private alternative, no group needed\n   - Each brand gets its own topic thread inside the bot's DM\n   - Requires enabling Thread Mode on the bot (guided below)\n\n3. **DM-simple** — Minimal, no brand isolation\n   - Single DM conversation with the bot\n   - Context-based brand routing (no topics)\n\n4. **Group-simple** — Group without brand isolation\n   - Single group conversation\n   - Context-based brand routing (no topics)\n\n#### Phase C: Mode-Specific Setup\n\n**If DM+Topics:**\n\n1. Guide the user to enable Thread Mode on their bot:\n   - \"Open Telegram, find **@BotFather**\"\n   - \"Tap the **Open** button (bottom-left) to open the BotFather MiniApp\"\n   - \"Select your bot in the MiniApp\"\n   - \"Go to **Bot Settings**\"\n   - \"Find **Thread Mode** and enable it\"\n   - \"Come back and tell me when it's done\"\n2. Once confirmed, use the bot token to get the user's chat ID:\n   - \"Send any message to your bot in Telegram\"\n   - Agent reads the incoming message context to extract the user's chat ID from `{{From}}`\n   - Agent writes the chat ID into the channel config\n3. Create the **Operations** topic automatically:\n   ```bash\n   node scripts\u002Ftelegram-topics.js \\\n     --config ~\u002F.openclaw\u002Fopenclaw.json \\\n     --chat \u003CUSER_CHAT_ID> \\\n     --name \"Operations\"\n   ```\n4. Write the resulting thread ID into `shared\u002Foperations\u002Fchannel-map.md`\n5. Update `cron\u002Fjobs.json` — replace `{{OPERATIONS_CHANNEL}}` with the actual Operations channel address (format: `chatId:threadId`, e.g., `123456789:7`)\n\n**If Group+Topics:**\n\n1. Check if the user already has a supergroup:\n   - If not: guide them to create one (Create Group → toggle \"Topics\" on)\n2. Guide the user to add the bot to the group:\n   - \"Add your bot to the supergroup\"\n   - \"Make the bot an **admin** with the **Manage Topics** permission\"\n   - \"Send a message in the group\"\n3. Agent reads the incoming message context to extract:\n   - Group chat ID from `{{To}}`\n   - Agent writes the chat ID into the channel config\n4. Create the **Operations** topic automatically:\n   ```bash\n   node scripts\u002Ftelegram-topics.js \\\n     --config ~\u002F.openclaw\u002Fopenclaw.json \\\n     --chat \u003CGROUP_CHAT_ID> \\\n     --name \"Operations\"\n   ```\n5. Write the resulting thread ID into `shared\u002Foperations\u002Fchannel-map.md`\n6. Update `cron\u002Fjobs.json` — replace `{{OPERATIONS_CHANNEL}}` with the actual Operations channel address (format: `chatId:threadId`, e.g., `-100XXXXXXXXXX:7`)\n\n**If DM-simple:**\n\n1. \"Send any message to your bot in Telegram\"\n2. Agent reads the chat ID from the incoming message context\n3. Write chat ID into channel config — done\n\n**If Group-simple:**\n\n1. Guide: \"Add the bot to your group and send a message\"\n2. Agent reads the group chat ID from the incoming message context\n3. Write chat ID into channel config — done\n\n### Step 5: Instance Setup + First Brand\n\nAfter scaffolding and Telegram configuration, run the sub-skills:\n\n1. **Instance Setup** (`instance-setup` skill)\n   - Owner name and timezone\n   - Communication language (owner-facing)\n   - Default content language\n   - Bot identity (name, emoji, personality)\n   - Updates: `shared\u002FINSTANCE.md`, `workspace\u002FIDENTITY.md`\n\n2. **First Brand** (`brand-manager add`)\n   - Brand ID, display name, domain\n   - Target market and content language\n   - **Topic creation** (for Topics modes):\n     - Agent calls `scripts\u002Ftelegram-topics.js` to create a topic named after the brand\n     - The script returns the thread ID\n     - Agent writes the thread ID into `shared\u002Foperations\u002Fchannel-map.md` and the brand config\n   - For simple modes: no topic needed, skip thread ID\n   - Creates: brand profile, content guidelines, domain knowledge file, asset directories\n\n### Step 6: Verification + Gateway Restart\n\n1. **Restart gateway:**\n   ```\n   openclaw gateway restart\n   ```\n\n2. **Run diagnostics:**\n   ```\n   openclaw doctor\n   ```\n   This validates: agent config, DM allowlist inheritance, session health, model availability, and workspace integrity.\n\n3. **Additional checks:**\n   - [ ] Leader responds to messages\n   - [ ] `sessions_send` to at least one agent succeeds\n\n**Optional: Enable QMD semantic memory**\n\nIf `patch-config.js` reported \"qmd binary not found\" during Step 3, agents will use file-based memory (which works fine). To enable enhanced semantic search:\n- Say **\"Set up QMD\"** to run the `qmd-setup` sub-skill, which guides you through installation and configuration.\n\n**Suggested first tasks after setup:**\n1. Fill in your brand profile: `shared\u002Fbrands\u002F{brand_id}\u002Fprofile.md`\n2. Test content creation: \"Write a Facebook post for {brand}\"\n3. Add more brands: \"Add a new brand\"\n4. Set up posting schedule: fill in `shared\u002Foperations\u002Fposting-schedule.md`\n\n## Post-Installation\n\n### Async Dispatch Model (v2.0.0+)\n\nLeader uses **fully async dispatch** (`sessions_send` with `timeoutSeconds: 0`) for all agent communication. This means:\n\n- Leader is **never blocked** waiting for an agent — always available to the owner.\n- Agents **callback** to Leader via `sessions_send` when done (event-driven, not polling). Leader processes callbacks per the \"Agent Callback Protocol\" flow in AGENTS.md.\n- Each task is tracked in a separate file: `tasks\u002FT-{YYYYMMDD}-{HHMM}.md`. Completed tasks are archived to `tasks\u002Farchive\u002F`.\n- **Stale task detection** is handled by a cron job (`stale-task-check`, every 10 minutes) that scans `tasks\u002F` for steps stuck in `[⏳]` state. Runs as Leader.\n- **HEARTBEAT.md** ships empty by default — periodic checks are handled by cron jobs instead of heartbeat polls.\n\n### Secrets Management (Optional)\n\nFor centralized API key management instead of scattered env vars:\n```\nopenclaw secrets audit      # Check for plaintext secrets in config\nopenclaw secrets configure  # Set up secret entries\nopenclaw secrets apply      # Activate secrets\nopenclaw secrets reload     # Hot-reload without gateway restart\n```\n\n### Adding More Brands\n\nUse the `brand-manager` sub-skill:\n- \"Add a new brand\" — interactive brand creation (auto-creates topic for Topics modes)\n- \"List brands\" — show all active brands\n- \"Archive {brand}\" — deactivate a brand\n\n### Customizing Agents\n\nEach agent's behavior is defined in two files:\n- **SOUL.md** — Persona, philosophy, boundaries, safety rules\n- **AGENTS.md** — Operating procedures, data handling, brand scope, tools\n\nModify these files to tune agent behavior for your specific needs.\n\n### Memory System\n\nThe 3-layer memory system works automatically:\n- **MEMORY.md** — Long-term curated memory (auto-updated by cron)\n- **memory\u002FYYYY-MM-DD.md** — Daily activity logs\n- **shared\u002F** — Permanent knowledge base (grows over time)\n\n**Optional enhancement:** Install QMD for semantic search across the knowledge base. Use the `qmd-setup` sub-skill or install manually (`bun install -g @tobilu\u002Fqmd`).\n\nSee `references\u002Fmemory-system.md` for detailed documentation.\n\n### Communication Signals\n\nAgents use standardized signals to communicate status. See `references\u002Fsignals-protocol.md` for the complete signal dictionary.\n\n## Reference Documentation\n\n| Document | Purpose | When to Read |\n|----------|---------|-------------|\n| `references\u002Farchitecture.md` | Star topology, session model, parallelism | Understanding system design |\n| `references\u002Fagent-roles.md` | Detailed agent capabilities and restrictions | Customizing team composition |\n| `references\u002Fsignals-protocol.md` | Complete signal dictionary | Debugging agent communication |\n| `references\u002Fmemory-system.md` | 3-layer memory + knowledge capture | Understanding memory behavior |\n| `references\u002Fapproval-workflow.md` | Approval pipeline + owner shortcuts | Content publishing workflow |\n| `references\u002Ftroubleshooting.md` | Known issues (IPv6, etc.) + solutions | When something breaks |\n\n## Directory Structure\n\nAfter installation, the following structure is created:\n\n```\n~\u002F.openclaw\u002F\n├── openclaw.json                    # Updated with agent configs\n├── workspace\u002F                       # Leader\n│   ├── SOUL.md, AGENTS.md, HEARTBEAT.md, IDENTITY.md\n│   ├── memory\u002F, skills\u002F, assets\u002F\n│   └── shared\u002F                      # Real directory (shared KB lives here)\n│       ├── INSTANCE.md              # Instance configuration\n│       ├── brand-registry.md        # Brand registry\n│       ├── system-guide.md, brand-guide.md, compliance-guide.md\n│       ├── team-roster.md\n│       ├── brands\u002F{id}\u002Fprofile.md   # Per-brand profiles\n│       ├── domain\u002F{id}-industry.md  # Industry knowledge\n│       ├── operations\u002F              # Ops guides\n│       └── errors\u002Fsolutions.md      # Error KB\n├── workspace-creator\u002F               # Creator\n│   ├── SOUL.md, AGENTS.md, MEMORY.md\n│   ├── memory\u002F, skills\u002F\n│   └── shared -> ..\u002Fworkspace\u002Fshared\u002F\n├── workspace-worker\u002F                # Worker\n│   └── (same structure)\n├── workspace-researcher\u002F            # Researcher\n│   └── (same structure)\n├── workspace-engineer\u002F              # Engineer\n│   └── (same structure)\n├── workspace-reviewer\u002F              # Reviewer (minimal, read-only)\n│   ├── SOUL.md, AGENTS.md\n│   └── shared -> ..\u002Fworkspace\u002Fshared\u002F\n└── cron\u002Fjobs.json                   # Scheduled tasks\n```\n\n## Scripts\n\n| Script | Purpose | When to Run |\n|--------|---------|-------------|\n| `scripts\u002Fscaffold.sh` | Create directories, copy templates, set up symlinks | During initial setup |\n| `scripts\u002Fpatch-config.js` | Merge agent config into openclaw.json | During initial setup |\n| `scripts\u002Ftelegram-topics.js` | Create forum topics in Telegram DM or supergroup | During setup and when adding brands |\n\n## Sub-Skills\n\n| Skill | Purpose |\n|-------|---------|\n| `instance-setup` | Configure owner info, language, bot identity |\n| `brand-manager` | Add, edit, archive brands |\n| `qmd-setup` | Install and configure QMD semantic search memory (optional) |\n","# Social Media Ops\n\n## Overview\n\nThis skill sets up a complete AI-powered social media operations team on OpenClaw. It creates:\n\n- **5 specialized agents** in a star topology (Leader + 4 specialists) + on-demand Reviewer\n- **Persistent A2A sessions** for context-preserving multi-agent workflows\n- **3-layer memory system** (MEMORY.md + daily notes + shared knowledge base)\n- **Shared knowledge base** with brand profiles, operations guides, and domain knowledge\n- **Approval workflow** ensuring nothing publishes without owner approval\n- **Brand isolation** with per-brand channels, content guidelines, and asset directories\n- **Cron automation** for daily memory consolidation and weekly KB review\n\n## Optional Dependencies\n\n- **Image generation tool for Creator agent**: The Creator agent requires an image generation tool installed in its `workspace-creator\u002Fskills\u002F` directory to produce images. Recommended: `nano-banana-pro` (Gemini-based, free tier). Without it, Creator produces text visual briefs only and cannot generate images.\n\n## Prerequisites\n\nBefore installing, ensure:\n\n1. OpenClaw v2026.2.26+ is installed and `openclaw onboard` has been completed\n2. At least one auth profile exists (e.g., Anthropic API key)\n3. The `~\u002F.openclaw\u002F` directory exists\n\n## Quick Start\n\n```\n1. Install the skill (if not already in workspace\u002Fskills\u002F)\n2. Trigger setup: \"Set up my social media operations team\"\n3. Follow the interactive onboarding (6 steps, ~10 minutes)\n4. Start creating content!\n```\n\n## Onboarding Flow\n\nWhen first triggered, this skill runs an interactive setup process.\n\n### Step 1: Prerequisites Check\n\nVerify the environment is ready:\n\n- [ ] OpenClaw installed and `openclaw onboard` completed\n- [ ] `~\u002F.openclaw\u002F` directory exists\n- [ ] At least one auth profile configured\n\nIf any prerequisite is missing, guide the user to resolve it before continuing.\n\n### Step 2: Team Setup\n\n**All 5 agents are installed automatically.** Do not ask the user to choose a team size.\n\nThe full team:\n\n| Agent | Role |\n|-------|------|\n| Leader | Orchestration, routing, quality gates |\n| Creator | Content + visual (copywriting, image gen, platform formatting) |\n| Worker | Execution for Leader (files, CLI, config, maintenance) |\n| Researcher | Market research, competitor analysis |\n| Engineer | Technical integrations, automation |\n\n**On-demand:**\n\n| Agent | Role |\n|-------|------|\n| Reviewer | Independent quality review (spawned when needed) |\n\n**Model** — All agents inherit the model configured during `openclaw onboard` (at `agents.defaults.model`). No per-agent model setup is needed.\n\n> **Advanced note:** If you later want to run a leaner team, re-run `scaffold.sh --agents leader,creator,engineer` to scaffold a subset.\n\n### Step 3: Run Scaffold\n\nExecute the setup scripts to create all directories and files first:\n\n```bash\n# 1. Create directories, copy templates, set up symlinks\nbash scripts\u002Fscaffold.sh \\\n  --skill-dir \"$(pwd)\"\n\n# 2. Merge agent configuration into openclaw.json\nnode scripts\u002Fpatch-config.js \\\n  --config ~\u002F.openclaw\u002Fopenclaw.json\n```\n\nThe scaffold creates:\n- Agent workspace directories with SOUL.md, AGENTS.md, MEMORY.md\n- Shared knowledge base with all template files\n- Symlinks from each workspace to shared\u002F\n- Sub-skills (instance-setup, brand-manager) in Leader's skills\u002F\n- Cron job definitions\n\nThe config patcher merges into openclaw.json:\n- Agent definitions with model assignments and tool restrictions\n- A2A session configuration\n- QMD memory paths (**only if QMD is installed** — otherwise skipped with a suggestion)\n- Internal hooks\n\n### Step 4: Telegram Setup\n\nThis step uses a **guided flow** — do not ask the user for raw chat IDs or thread IDs.\n\n#### Phase A: Confirm Bot Token\n\n1. Check `openclaw.json` for `channels.telegram.botToken`\n2. If present → skip to Phase B\n3. If missing → guide the user:\n   - \"Open Telegram, search for **@BotFather**\"\n   - \"Send `\u002Fnewbot` and follow the prompts to create a bot\"\n   - \"Copy the bot token and paste it here\"\n   - Write the token into `openclaw.json` at `channels.telegram.botToken`\n\n#### Phase B: Choose Channel Mode\n\nPresent the options in this order (Group+Topics first):\n\n1. **Group+Topics (recommended)** — Best for most setups\n   - Brands are topic threads inside a Telegram supergroup\n   - Works for both solo operators and multi-person teams\n   - Requires a supergroup with Topics enabled\n\n2. **DM+Topics** — Private alternative, no group needed\n   - Each brand gets its own topic thread inside the bot's DM\n   - Requires enabling Thread Mode on the bot (guided below)\n\n3. **DM-simple** — Minimal, no brand isolation\n   - Single DM conversation with the bot\n   - Context-based brand routing (no topics)\n\n4. **Group-simple** — Group without brand isolation\n   - Single group conversation\n   - Context-based brand routing (no topics)\n\n#### Phase C: Mode-Specific Setup\n\n**If DM+Topics:**\n\n1. Guide the user to enable Thread Mode on their bot:\n   - \"Open Telegram, find **@BotFather**\"\n   - \"Tap the **Open** button (bottom-left) to open the BotFather MiniApp\"\n   - \"Select your bot in the MiniApp\"\n   - \"Go to **Bot Settings**\"\n   - \"Find **Thread Mode** and enable it\"\n   - \"Come back and tell me when it's done\"\n2. Once confirmed, use the bot token to get the user's chat ID:\n   - \"Send any message to your bot in Telegram\"\n   - Agent reads the incoming message context to extract the user's chat ID from `{{From}}`\n   - Agent writes the chat ID into the channel config\n3. Create the **Operations** topic automatically:\n   ```bash\n   node scripts\u002Ftelegram-topics.js \\\n     --config ~\u002F.openclaw\u002Fopenclaw.json \\\n     --chat \u003CUSER_CHAT_ID> \\\n     --name \"Operations\"\n   ```\n4. Write the resulting thread ID into `shared\u002Foperations\u002Fchannel-map.md`\n5. Update `cron\u002Fjobs.json` — replace `{{OPERATIONS_CHANNEL}}` with the actual Operations channel address (format: `chatId:threadId`, e.g., `123456789:7`)\n\n**If Group+Topics:**\n\n1. Check if the user already has a supergroup:\n   - If not: guide them to create one (Create Group → toggle \"Topics\" on)\n2. Guide the user to add the bot to the group:\n   - \"Add your bot to the supergroup\"\n   - \"Make the bot an **admin** with the **Manage Topics** permission\"\n   - \"Send a message in the group\"\n3. Agent reads the incoming message context to extract:\n   - Group chat ID from `{{To}}`\n   - Agent writes the chat ID into the channel config\n4. Create the **Operations** topic automatically:\n   ```bash\n   node scripts\u002Ftelegram-topics.js \\\n     --config ~\u002F.openclaw\u002Fopenclaw.json \\\n     --chat \u003CGROUP_CHAT_ID> \\\n     --name \"Operations\"\n   ```\n5. Write the resulting thread ID into `shared\u002Foperations\u002Fchannel-map.md`\n6. Update `cron\u002Fjobs.json` — replace `{{OPERATIONS_CHANNEL}}` with the actual Operations channel address (format: `chatId:threadId`, e.g., `-100XXXXXXXXXX:7`)\n\n**If DM-simple:**\n\n1. \"Send any message to your bot in Telegram\"\n2. Agent reads the chat ID from the incoming message context\n3. Write chat ID into channel config — done\n\n**If Group-simple:**\n\n1. Guide: \"Add the bot to your group and send a message\"\n2. Agent reads the group chat ID from the incoming message context\n3. Write chat ID into channel config — done\n\n### Step 5: Instance Setup + First Brand\n\nAfter scaffolding and Telegram configuration, run the sub-skills:\n\n1. **Instance Setup** (`instance-setup` skill)\n   - Owner name and timezone\n   - Communication language (owner-facing)\n   - Default content language\n   - Bot identity (name, emoji, personality)\n   - Updates: `shared\u002FINSTANCE.md`, `workspace\u002FIDENTITY.md`\n\n2. **First Brand** (`brand-manager add`)\n   - Brand ID, display name, domain\n   - Target market and content language\n   - **Topic creation** (for Topics modes):\n     - Agent calls `scripts\u002Ftelegram-topics.js` to create a topic named after the brand\n     - The script returns the thread ID\n     - Agent writes the thread ID into `shared\u002Foperations\u002Fchannel-map.md` and the brand config\n   - For simple modes: no topic needed, skip thread ID\n   - Creates: brand profile, content guidelines, domain knowledge file, asset directories\n\n### Step 6: Verification + Gateway Restart\n\n1. **Restart gateway:**\n   ```\n   openclaw gateway restart\n   ```\n\n2. **Run diagnostics:**\n   ```\n   openclaw doctor\n   ```\n   This validates: agent config, DM allowlist inheritance, session health, model availability, and workspace integrity.\n\n3. **Additional checks:**\n   - [ ] Leader responds to messages\n   - [ ] `sessions_send` to at least one agent succeeds\n\n**Optional: Enable QMD semantic memory**\n\nIf `patch-config.js` reported \"qmd binary not found\" during Step 3, agents will use file-based memory (which works fine). To enable enhanced semantic search:\n- Say **\"Set up QMD\"** to run the `qmd-setup` sub-skill, which guides you through installation and configuration.\n\n**Suggested first tasks after setup:**\n1. Fill in your brand profile: `shared\u002Fbrands\u002F{brand_id}\u002Fprofile.md`\n2. Test content creation: \"Write a Facebook post for {brand}\"\n3. Add more brands: \"Add a new brand\"\n4. Set up posting schedule: fill in `shared\u002Foperations\u002Fposting-schedule.md`\n\n## Post-Installation\n\n### Async Dispatch Model (v2.0.0+)\n\nLeader uses **fully async dispatch** (`sessions_send` with `timeoutSeconds: 0`) for all agent communication. This means:\n\n- Leader is **never blocked** waiting for an agent — always available to the owner.\n- Agents **callback** to Leader via `sessions_send` when done (event-driven, not polling). Leader processes callbacks per the \"Agent Callback Protocol\" flow in AGENTS.md.\n- Each task is tracked in a separate file: `tasks\u002FT-{YYYYMMDD}-{HHMM}.md`. Completed tasks are archived to `tasks\u002Farchive\u002F`.\n- **Stale task detection** is handled by a cron job (`stale-task-check`, every 10 minutes) that scans `tasks\u002F` for steps stuck in `[⏳]` state. Runs as Leader.\n- **HEARTBEAT.md** ships empty by default — periodic checks are handled by cron jobs instead of heartbeat polls.\n\n### Secrets Management (Optional)\n\nFor centralized API key management instead of scattered env vars:\n```\nopenclaw secrets audit      # Check for plaintext secrets in config\nopenclaw secrets configure  # Set up secret entries\nopenclaw secrets apply      # Activate secrets\nopenclaw secrets reload     # Hot-reload without gateway restart\n```\n\n### Adding More Brands\n\nUse the `brand-manager` sub-skill:\n- \"Add a new brand\" — interactive brand creation (auto-creates topic for Topics modes)\n- \"List brands\" — show all active brands\n- \"Archive {brand}\" — deactivate a brand\n\n### Customizing Agents\n\nEach agent's behavior is defined in two files:\n- **SOUL.md** — Persona, philosophy, boundaries, safety rules\n- **AGENTS.md** — Operating procedures, data handling, brand scope, tools\n\nModify these files to tune agent behavior for your specific needs.\n\n### Memory System\n\nThe 3-layer memory system works automatically:\n- **MEMORY.md** — Long-term curated memory (auto-updated by cron)\n- **memory\u002FYYYY-MM-DD.md** — Daily activity logs\n- **shared\u002F** — Permanent knowledge base (grows over time)\n\n**Optional enhancement:** Install QMD for semantic search across the knowledge base. Use the `qmd-setup` sub-skill or install manually (`bun install -g @tobilu\u002Fqmd`).\n\nSee `references\u002Fmemory-system.md` for detailed documentation.\n\n### Communication Signals\n\nAgents use standardized signals to communicate status. See `references\u002Fsignals-protocol.md` for the complete signal dictionary.\n\n## Reference Documentation\n\n| Document | Purpose | When to Read |\n|----------|---------|-------------|\n| `references\u002Farchitecture.md` | Star topology, session model, parallelism | Understanding system design |\n| `references\u002Fagent-roles.md` | Detailed agent capabilities and restrictions | Customizing team composition |\n| `references\u002Fsignals-protocol.md` | Complete signal dictionary | Debugging agent communication |\n| `references\u002Fmemory-system.md` | 3-layer memory + knowledge capture | Understanding memory behavior |\n| `references\u002Fapproval-workflow.md` | Approval pipeline + owner shortcuts | Content publishing workflow |\n| `references\u002Ftroubleshooting.md` | Known issues (IPv6, etc.) + solutions | When something breaks |\n\n## Directory Structure\n\nAfter installation, the following structure is created:\n\n```\n~\u002F.openclaw\u002F\n├── openclaw.json                    # Updated with agent configs\n├── workspace\u002F                       # Leader\n│   ├── SOUL.md, AGENTS.md, HEARTBEAT.md, IDENTITY.md\n│   ├── memory\u002F, skills\u002F, assets\u002F\n│   └── shared\u002F                      # Real directory (shared KB lives here)\n│       ├── INSTANCE.md              # Instance configuration\n│       ├── brand-registry.md        # Brand registry\n│       ├── system-guide.md, brand-guide.md, compliance-guide.md\n│       ├── team-roster.md\n│       ├── brands\u002F{id}\u002Fprofile.md   # Per-brand profiles\n│       ├── domain\u002F{id}-industry.md  # Industry knowledge\n│       ├── operations\u002F              # Ops guides\n│       └── errors\u002Fsolutions.md      # Error KB\n├── workspace-creator\u002F               # Creator\n│   ├── SOUL.md, AGENTS.md, MEMORY.md\n│   ├── memory\u002F, skills\u002F\n│   └── shared -> ..\u002Fworkspace\u002Fshared\u002F\n├── workspace-worker\u002F                # Worker\n│   └── (same structure)\n├── workspace-researcher\u002F            # Researcher\n│   └── (same structure)\n├── workspace-engineer\u002F              # Engineer\n│   └── (same structure)\n├── workspace-reviewer\u002F              # Reviewer (minimal, read-only)\n│   ├── SOUL.md, AGENTS.md\n│   └── shared -> ..\u002Fworkspace\u002Fshared\u002F\n└── cron\u002Fjobs.json                   # Scheduled tasks\n```\n\n## Scripts\n\n| Script | Purpose | When to Run |\n|--------|---------|-------------|\n| `scripts\u002Fscaffold.sh` | Create directories, copy templates, set up symlinks | During initial setup |\n| `scripts\u002Fpatch-config.js` | Merge agent config into openclaw.json | During initial setup |\n| `scripts\u002Ftelegram-topics.js` | Create forum topics in Telegram DM or supergroup | During setup and when adding brands |\n\n## Sub-Skills\n\n| Skill | Purpose |\n|-------|---------|\n| `instance-setup` | Configure owner info, language, bot identity |\n| `brand-manager` | Add, edit, archive brands |\n| `qmd-setup` | Install and configure QMD semantic search memory (optional) |\n",{"name":5,"metadata":24,"description":7},{"openclaw":25},{"emoji":26,"requires":27},"📱",{"bins":28},[29],"node","main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Fkuan0808\u002Fsocial-media-ops",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":40,"prompt":50,"zipAvailable":51},[41,44,47],{"tool":42,"command":43},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill social-media-ops",{"tool":45,"command":46},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill social-media-ops",{"tool":48,"command":49},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill social-media-ops","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fkuan0808\u002Fsocial-media-ops\u002FSKILL.md",true,[],[54,62,69,76,83,90],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":61},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":61},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":61},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":61},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":61},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":61},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]