mcpField
O
openclaw-customizer

openclaw-customizer

github.com/petekpAgent workflows4835 installsUpdated 2d ago
Repository

About openclaw-customizer

A reference-guided skill for configuring and customizing OpenClaw. It helps users develop concrete configuration changes for channels, models, tools, automation, and multi-agent setups, with relevant reference files loaded on demand.

Key features

  1. 01Consult topic-specific reference files
  2. 02Draft JSON5 or Markdown changes
  3. 03Cover channels, models, tools, and hooks
  4. 04Guide cron and memory configuration
  5. 05Address multi-agent routing and isolation

Use cases

  1. 01Configure an OpenClaw messaging channel
  2. 02Adjust model or provider settings
  3. 03Plan hooks, skills, or cron jobs
  4. 04Design isolated multi-agent routing

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/petekp/claude-code-setup --skill openclaw-customizer

After installing, type/openclaw-customizerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
bootstrap-files.md
channels.md
configuration.md
creative-patterns.md
models-providers.md
multi-agent.md
tools-skills-hooks.md

Details

From the project README

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:

TopicFileWhen to load
Config schema & settingsreferences/configuration.mdEditing openclaw.json, any config question
Bootstrap filesreferences/bootstrap-files.mdSOUL.md, USER.md, AGENTS.md, IDENTITY.md, TOOLS.md
Channel setupreferences/channels.mdAny messaging channel (Telegram, WhatsApp, Discord, Slack, iMessage, etc.)
Models & providersreferences/models-providers.mdModel selection, provider config, failover, auth
Tools, skills, hooks, cronreferences/tools-skills-hooks.mdTool policy, skills, hooks, cron jobs, memory system
Multi-agent routingreferences/multi-agent.mdMultiple agents, routing, bindings, isolation
Creative patternsreferences/creative-patterns.mdIdeas, inspiration, non-obvious uses, advanced patterns

Workflow

  1. Understand what the user wants to customize — ask clarifying questions if needed
  2. Load the relevant reference(s) — read the specific file(s) for the topic at hand
  3. Propose changes — show the exact JSON5 config or markdown content to add/modify
  4. Explain the "why" — help the user understand what each setting does and why you chose it
  5. 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.md in 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 doctor when troubleshooting
  • Remind about allowFrom security — never suggest open DM policy without a warning
  • For multi-agent setups, emphasize workspace isolation and credential separation
  • When suggesting cron jobs, always include timezone awareness

Comments

Markdown supported