- name
- use-openclaw
- description
- Explain how to use OpenClaw in a local environment. Use when the user asks how to find OpenClaw config or workspace files, how to add or inspect skills, how to understand the purpose of AGENTS.md or workspace notes, how to troubleshoot OpenClaw setup issues, or how to complete a common OpenClaw task step by step.
Use OpenClaw
Overview
Help the user complete common OpenClaw tasks with minimal ceremony. Start from the local installation, inspect real files before giving advice, and explain the shortest working path.
Quick Start
Use this workflow unless the user asks for something narrower:
- Identify the user's real goal: configuration, skills, workspace files, logs, or troubleshooting.
- Inspect the relevant local files under
~/.openclaw/before answering from memory. - Prefer concrete paths and commands over abstract explanations.
- If a change is requested, edit the smallest possible file and then validate the result.
Core Locations
Check these locations first on a normal local installation:
~/.openclaw/openclaw.json: main configuration file~/.openclaw/workspace/: shared workspace guidance and notes~/.openclaw/workspace/AGENTS.md: project or workspace behavior rules~/.openclaw/workspace/TOOLS.md: environment-specific tool notes~/.openclaw/workspace/USER.md: user preferences and human context~/.openclaw/skills/and~/.openclaw/workspace/skills/: installed or in-progress skills~/.openclaw/logs/: logs for troubleshooting~/.openclaw/extensions/: installed extensions and their docs
On Windows, expand ~ to the user's home directory, for example C:/Users/<name>/.openclaw/.
Common Tasks
Explain the OpenClaw layout
When the user asks where OpenClaw files live or what each file is for:
- Read the actual files first.
- Summarize each file in one sentence.
- Mention only the files relevant to the user's question.
Guide a user through a task
When the user asks how to do something in OpenClaw:
- Map the request to one of these buckets:
- inspect configuration - create or edit a skill - update workspace instructions - troubleshoot a broken setup
- Show the exact file or command to check first.
- Give the shortest safe sequence of steps.
- If a command fails, inspect the error and adjust instead of repeating generic advice.
Create or edit a skill
When the user wants a new skill:
- Decide whether it belongs in
~/.openclaw/skills/or the current workspace. - Create a folder named after the skill.
- Add
SKILL.mdwith clearnameanddescription. - Add
agents/openai.yamlif UI metadata is needed. - Keep the skill concise and put detailed material in
references/only when necessary.
Troubleshoot OpenClaw
When the user says OpenClaw is not working:
- Check the exact failing command or screen.
- Inspect
~/.openclaw/openclaw.jsonand the most relevant file under~/.openclaw/logs/. - If the issue involves a skill or extension, inspect its
SKILL.md, README, or config before proposing a fix. - Prefer local evidence over assumptions.
Suggested Commands
Use fast inspection commands first:
rg --files "~/.openclaw"rg -n "keyword" "~/.openclaw"Get-ChildItem -Force "~/.openclaw"Get-Content -Raw "~/.openclaw/openclaw.json"Get-Content -Raw "~/.openclaw/workspace/AGENTS.md"
Adjust path separators for the current shell when needed.
Response Rules
- Prefer concrete local paths over generic product descriptions.
- Read before editing.
- Keep explanations short and operational.
- If the user only wants to understand OpenClaw, do not change files unnecessarily.
- If the user wants a fix, make the smallest verifiable change and report what changed.