OpenClaw Config Skill 🐾
Manages your openclaw-config installation.
Users say things like:
- "Set up openclaw-config"
- "Update my openclaw config"
- "Force update openclaw" (overwrites their changes)
- "Check if openclaw has updates"
Setup
Do these steps in order:
Clone repo to ~/.openclaw-config
Copy templates to workspace root (don't overwrite existing): AGENTS.md, SOUL.md,
USER.md, TOOLS.md, HEARTBEAT.md, IDENTITY.md
Create memory folders: memory/people, memory/projects, memory/topics,
memory/decisions
Copy skills to skills/
Optional: Add workflows — Ask if they want any workflows:
- "Do you want the email steward workflow?" → Manages inbox automatically
If yes:
- Copy
AGENT.md from ~/.openclaw-config/workflows/email-steward/ to
workflows/email-steward/
- Create
workflows/email-steward/logs/ directory
- The workflow will interview them on first run to create
rules.md
Configure memory search — Required for semantic search to work. Ask: LM Studio
(local, free, recommended) or OpenAI?
- LM Studio: Server on port 1234, model
lmstudio-community/embedding-gemma-300m-qat, configure gateway
memorySearch.remote.baseUrl to http://127.0.0.1:1234/v1
- OpenAI: Get their API key, configure gateway memorySearch.remote.baseUrl to
https://api.openai.com/v1, model text-embedding-3-small
- Verify it works: Create test file in memory/, index it, search for it, confirm
it returns results, clean up
Personalization — Ask and replace in templates: {{USER_NAME}},
{{ASSISTANT_NAME}}, {{TIMEZONE}}, {{PRIORITY_1}}, {{PRIORITY_2}}
Optional skills — These are optional. Ask about each one individually, only
configure if they say yes:
- "Do you have a Limitless Pendant?" → If yes, get API key from app.limitless.ai →
Settings → Developer
- "Do you use Fireflies.ai for meeting transcripts?" → If yes, get API key from
app.fireflies.ai → Integrations → Fireflies API
- "Do you use Quo for business phone?" → If yes, get API key from my.quo.com →
Settings → API
- "Do you want Parallel.ai for web search? (better results than built-in)" → If yes,
get API key from platform.parallel.ai
Skip any they don't use. Don't assume they want all of them.
Health check setup — Ask: "Do you want automated health monitoring? It runs
hourly via cron (Claude Code + Sonnet) to check your gateway and services, fix minor
issues, and notify you of problems."
If yes:
- Ask: "Who should be notified if there's a problem?" →
mkdir -p ~/.openclaw then
write their answer to ~/.openclaw/health-check-admin (just the name, one line)
- Resolve the claude CLI path with
which claude — use the full path in the cron job
- Install the cron job (substitute CLAUDE_PATH with the resolved path):
0 0,7-23 * * * test -f "$HOME/.openclaw-config/devops/health-check.md" && flock -n "$HOME/.openclaw/health-check.lock" CLAUDE_PATH -p "Run health check" --model sonnet --append-system-prompt-file "$HOME/.openclaw-config/devops/health-check.md" --dangerously-skip-permissions --max-budget-usd 5.00 >> "$HOME/.openclaw/health-check.log" 2>&1
- Verify:
crontab -l | grep health-check
- Do a test run: execute the claude command once and verify it produces output
- Tell them: runs hourly 7 AM–midnight, logs at
~/.openclaw/health-check.log
Track version in .openclaw/installed-version
Summary — Tell them what's configured
Update
Compare .openclaw/installed-version with ~/.openclaw-config/VERSION.
If newer: pull, update skills (safe to overwrite), update templates only if user hasn't
modified them, update version file, report changes.
If user wants to force/overwrite: backup to .openclaw/backup/ first.
Workflows: Only update AGENT.md (the algorithm). Never touch rules.md,
agent_notes.md, or logs/ — those belong to the user.
Status
Show installed version and skill versions. Fetch remote VERSION, report if updates
available.
1---2name: openclaw3description: Install, configure, and update openclaw-config4---5
6# OpenClaw Config Skill 🐾
7
8Manages your openclaw-config installation.
9
10**Users say things like:**
11
12- "Set up openclaw-config"
13- "Update my openclaw config"
14- "Force update openclaw" (overwrites their changes)
15- "Check if openclaw has updates"
16
17---
18
19# Setup
20
21Do these steps in order:
22
231. **Clone repo** to `~/.openclaw-config`
24
252. **Copy templates** to workspace root (don't overwrite existing): AGENTS.md, SOUL.md,
26 USER.md, TOOLS.md, HEARTBEAT.md, IDENTITY.md
27
283. **Create memory folders:** `memory/people`, `memory/projects`, `memory/topics`,
29 `memory/decisions`
30
314. **Copy skills** to `skills/`
32
335. **Optional: Add workflows** — Ask if they want any workflows:
34 - "Do you want the email steward workflow?" → Manages inbox automatically
35
36 If yes:
37 - Copy `AGENT.md` from `~/.openclaw-config/workflows/email-steward/` to
38 `workflows/email-steward/`
39 - Create `workflows/email-steward/logs/` directory
40 - The workflow will interview them on first run to create `rules.md`
41
426. **Configure memory search** — Required for semantic search to work. Ask: LM Studio
43 (local, free, recommended) or OpenAI?
44 - **LM Studio:** Server on port 1234, model
45 `lmstudio-community/embedding-gemma-300m-qat`, configure gateway
46 memorySearch.remote.baseUrl to `http://127.0.0.1:1234/v1`
47 - **OpenAI:** Get their API key, configure gateway memorySearch.remote.baseUrl to
48 `https://api.openai.com/v1`, model `text-embedding-3-small`
49 - **Verify it works:** Create test file in memory/, index it, search for it, confirm
50 it returns results, clean up
51
527. **Personalization** — Ask and replace in templates: `{{USER_NAME}}`,
53 `{{ASSISTANT_NAME}}`, `{{TIMEZONE}}`, `{{PRIORITY_1}}`, `{{PRIORITY_2}}`
54
558. **Optional skills** — These are optional. Ask about each one individually, only
56 configure if they say yes:
57 - "Do you have a Limitless Pendant?" → If yes, get API key from app.limitless.ai →
58 Settings → Developer
59 - "Do you use Fireflies.ai for meeting transcripts?" → If yes, get API key from
60 app.fireflies.ai → Integrations → Fireflies API
61 - "Do you use Quo for business phone?" → If yes, get API key from my.quo.com →
62 Settings → API
63 - "Do you want Parallel.ai for web search? (better results than built-in)" → If yes,
64 get API key from platform.parallel.ai
65
66 Skip any they don't use. Don't assume they want all of them.
67
689. **Health check setup** — Ask: "Do you want automated health monitoring? It runs
69 hourly via cron (Claude Code + Sonnet) to check your gateway and services, fix minor
70 issues, and notify you of problems."
71
72 If yes:
73 - Ask: "Who should be notified if there's a problem?" → `mkdir -p ~/.openclaw` then
74 write their answer to `~/.openclaw/health-check-admin` (just the name, one line)
75 - Resolve the claude CLI path with `which claude` — use the full path in the cron job
76 - Install the cron job (substitute CLAUDE_PATH with the resolved path):
77 ```
78 0 0,7-23 * * * test -f "$HOME/.openclaw-config/devops/health-check.md" && flock -n "$HOME/.openclaw/health-check.lock" CLAUDE_PATH -p "Run health check" --model sonnet --append-system-prompt-file "$HOME/.openclaw-config/devops/health-check.md" --dangerously-skip-permissions --max-budget-usd 5.00 >> "$HOME/.openclaw/health-check.log" 2>&1
79 ```
80 - Verify: `crontab -l | grep health-check`
81 - Do a test run: execute the claude command once and verify it produces output
82 - Tell them: runs hourly 7 AM–midnight, logs at `~/.openclaw/health-check.log`
83
8410. **Track version** in `.openclaw/installed-version`
85
8611. **Summary** — Tell them what's configured
87
88---
89
90# Update
91
92Compare `.openclaw/installed-version` with `~/.openclaw-config/VERSION`.
93
94If newer: pull, update skills (safe to overwrite), update templates only if user hasn't
95modified them, update version file, report changes.
96
97If user wants to force/overwrite: backup to `.openclaw/backup/` first.
98
99**Workflows:** Only update AGENT.md (the algorithm). Never touch rules.md,
100agent_notes.md, or logs/ — those belong to the user.
101
102---
103
104# Status
105
106Show installed version and skill versions. Fetch remote VERSION, report if updates
107available.