← Browse

@wsxqaza12/openclaw-map

B

OpenClaw environment map for coding agents (Claude Code, Cursor, Windsurf, etc.). Use when a coding agent needs to navigate or modify an OpenClaw installation — where config, logs, cron jobs, sessions, skills, workspaces, and docs live. Triggers on questions like "where are cron jobs stored?", "where are session logs?", "how does the workspace work?", "where is the OpenClaw config?", or any task that requires understanding the OpenClaw file system structure.

skillclaude

Install

agr install @wsxqaza12/openclaw-map --target claude

Writes 3 files into .claude/skills/, pinned to git-deb7edb4.

  • .claude/skills/openclaw-map/.gitignore
  • .claude/skills/openclaw-map/README.md
  • .claude/skills/openclaw-map/SKILL.md

Document


name: openclaw-map description: OpenClaw environment map for coding agents (Claude Code, Cursor, Windsurf, etc.). Use when a coding agent needs to navigate or modify an OpenClaw installation — where config, logs, cron jobs, sessions, skills, workspaces, and docs live. Triggers on questions like "where are cron jobs stored?", "where are session logs?", "how does the workspace work?", "where is the OpenClaw config?", or any task that requires understanding the OpenClaw file system structure.

OpenClaw Map

Full reference: references/environment.md

Read it before navigating the file system. It covers:

  • How to locate the OpenClaw docs on any OS (npm root -g method)
  • ~/.openclaw/ directory layout
  • Agent workspace location and bootstrap files
  • Session transcript paths
  • Cron job format and CLI
  • Skills loading priority
  • Gateway daemon management
  • ACP bridge for IDE integrations
  • All log file locations
  • CLI quick reference

Key facts

WhatWhere
Config~/.openclaw/openclaw.json
Gateway log/tmp/openclaw/openclaw-YYYY-MM-DD.log
Cron jobs~/.openclaw/cron/jobs.json
Sessions~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl
Default workspace~/.openclaw/workspace
User skills~/.openclaw/skills/
Bundled docs$(npm root -g)/openclaw/docs/
Online docshttps://docs.openclaw.ai

Common tasks

Modify config → edit ~/.openclaw/openclaw.json (hot-reloads automatically; only gateway.* changes need restart)

Add cron jobopenclaw cron add --name "..." --cron "..." --session main --system-event "..."

Install a skill → drop skill folder (containing SKILL.md) into ~/.openclaw/skills/

Diagnose issuesopenclaw doctor or openclaw logs --follow

Trustgrade B

  • passBody integrity

    Whether the stored document is plausibly the kind of file the artifact declares, rather than something fetched by mistake.

  • passType matchnot applicable to this artifact type

    Whether the artifact is really the kind of thing its metadata claims it is.

  • passFreshness

    How long since the source repository was last pushed to.

  • passPrompt injection

    Scans the artifact's own text for instructions aimed at your agent rather than at you.

  • warnLicenseno SPDX license detected

    Whether the source repository declares an SPDX license permissive enough to redistribute.

How the grade is calculated

Each check contributes 0 points when it passes, 1 when it warns, and 2 when it fails. The total maps to a letter:

  • Aevery check passed
  • Bone warning
  • Ctwo warnings
  • Dprompt injection or body integrity failed, or three warnings
  • Fone of those failed, and something else is wrong

These are automated hygiene checks, not a security audit, and not a dependency or vulnerability scan. A grade of A means nothing was flagged — not that the artifact is safe.

Versions

  • git-deb7edb4d0e52026-07-31