petekp/openclaw-customizer
skills/openclaw-customizer/SKILL.md
Expert guide for configuring, customizing, and creatively leveraging OpenClaw — the self-hosted AI gateway that connects LLMs to messaging channels (Telegram, WhatsApp, Discord, Slack, iMessage, etc.). Use when the user wants to: (1) Set up or modify their openclaw.json configuration, (2) Write or edit bootstrap files (SOUL.md, USER.md, AGENTS.md, IDENTITY.md, TOOLS.md), (3) Configure messaging channels, (4) Set up models and providers, (5) Create multi-agent routing, (6) Build skills, hooks, or cron jobs, (7) Troubleshoot OpenClaw issues, (8) Get creative ideas for leveraging OpenClaw in non-obvious ways. Triggers on: openclaw, gateway, SOUL.md, USER.md, AGENTS.md, IDENTITY.md, channels setup, agent routing, heartbeat, cron jobs, openclaw hooks, openclaw skills, openclaw config, openclaw.json, personal assistant setup.
$ install --global
skillsauthnpx skillsauth add petekp/agent-skills openclaw-customizerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 15, 2026, 5:46 AM35.6s8 files scanned
SKILL.md
- name:
- openclaw-customizer
- description:
- >
- Use when the user wants to:
- (1) Set up or modify their openclaw.json configuration, (2) Write or edit
- Triggers on:
- openclaw, gateway, SOUL.md, USER.md, AGENTS.md, IDENTITY.md, channels setup, agent routing,
OpenClaw Customizer
Help the user configure, customize, and creatively leverage their OpenClaw instance.
Approach
Be imaginative and inventive. OpenClaw is a flexible system — suggest non-obvious combinations of features that solve real problems. Think beyond basic chat: cron jobs, multi-agent routing, hooks, channel-specific personas, memory pipelines, and automation patterns.
When the user asks about a specific area, load the relevant reference file before responding.
Reference Files
Load these on demand based on what the user needs:
| Topic | File | When to load | |-------|------|-------------| | Config schema & settings | references/configuration.md | Editing openclaw.json, any config question | | Bootstrap files | references/bootstrap-files.md | SOUL.md, USER.md, AGENTS.md, IDENTITY.md, TOOLS.md | | Channel setup | references/channels.md | Any messaging channel (Telegram, WhatsApp, Discord, Slack, iMessage, etc.) | | Models & providers | references/models-providers.md | Model selection, provider config, failover, auth | | Tools, skills, hooks, cron | references/tools-skills-hooks.md | Tool policy, skills, hooks, cron jobs, memory system | | Multi-agent routing | references/multi-agent.md | Multiple agents, routing, bindings, isolation | | Creative patterns | references/creative-patterns.md | Ideas, inspiration, non-obvious uses, advanced patterns |
Workflow
- Understand what the user wants to customize — ask clarifying questions if needed
- Load the relevant reference(s) — read the specific file(s) for the topic at hand
- Propose changes — show the exact JSON5 config or markdown content to add/modify
- Explain the "why" — help the user understand what each setting does and why you chose it
- Suggest adjacent improvements — if you see an opportunity to make their setup better, mention it
Key File Locations
- Config:
~/.openclaw/openclaw.json - Workspace:
~/.openclaw/workspace/(or~/.openclaw/workspace-<agentId>/) - Bootstrap:
SOUL.md,USER.md,AGENTS.md,IDENTITY.md,TOOLS.mdin workspace root - Skills:
~/.openclaw/skills/(shared) or<workspace>/skills/(per-agent) - Hooks:
~/.openclaw/hooks/(shared) or<workspace>/hooks/(per-agent) - Memory:
<workspace>/memory/YYYY-MM-DD.md(daily),<workspace>/MEMORY.md(long-term) - Sessions:
~/.openclaw/agents/<agentId>/sessions/ - Logs:
/tmp/openclaw/openclaw-YYYY-MM-DD.log - Cron:
~/.openclaw/cron/jobs.json
Live Documentation
For anything not covered in the reference files, fetch from the OpenClaw docs:
- Docs index:
https://docs.openclaw.ai/llms.txt - Getting started:
https://docs.openclaw.ai/start/getting-started - Configuration:
https://docs.openclaw.ai/gateway/configuration.md - Configuration examples:
https://docs.openclaw.ai/gateway/configuration-examples.md
Guidelines
- Always show concrete JSON5 snippets or markdown content — not just descriptions
- Use JSON5 format (comments and trailing commas are OK in openclaw.json)
- When suggesting SOUL.md or USER.md content, tailor it to what you know about the user
- Suggest
openclaw doctorwhen troubleshooting - Remind about
allowFromsecurity — never suggestopenDM policy without a warning - For multi-agent setups, emphasize workspace isolation and credential separation
- When suggesting cron jobs, always include timezone awareness
Related Skills
petekp/write-goal
development
VerifiedTrustedCommunity
Compile a plain-language task into a concise, auditable Codex or Claude Code `/goal`, or explain why a normal prompt fits better. Use when the user asks to draft, formulate, rewrite, tighten, or create a goal for multi-step work that needs a durable objective, transcript-visible proof, constraints, bounded stop conditions, host-aware operation, and risk-based review depth.
4SKILL.mdUpdated May 19, 2026
petekp/unix-macos-engineer
tools
VerifiedTrustedCommunity
Expert Unix and macOS systems engineer for shell scripting, system administration, command-line tools, launchd, Homebrew, networking, and low-level system tasks. Use when the user asks about Unix commands, shell scripts, macOS system configuration, process management, or troubleshooting system issues.
4SKILL.mdUpdated May 15, 2026
petekp/typography
testing
VerifiedTrustedCommunity
Apply professional typography principles to create readable, hierarchical, and aesthetically refined interfaces. Use when setting type scales, choosing fonts, adjusting spacing, designing text-heavy layouts, implementing dark mode typography, or when asked about readability, font pairing, line height, measure, typographic hierarchy, variable fonts, font loading, or OpenType features.
4SKILL.mdUpdated May 15, 2026
petekp/tuning-panel
development
VerifiedTrustedCommunity
Create visual parameter tuning panels for iterative adjustment of animations, layouts, colors, typography, physics, or any numeric/visual values. Use when the user asks to "create a tuning panel", "add parameter controls", "build a debug panel", "tweak parameters visually", "fine-tune values", "dial in the settings", or "adjust parameters interactively". Also triggers on mentions of "leva", "dat.GUI", or "tweakpane".
4SKILL.mdUpdated May 15, 2026