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

What	Where
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 docs	https://docs.openclaw.ai

Common tasks

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

Add cron job → openclaw cron add --name "..." --cron "..." --session main --system-event "..."

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

Diagnose issues → openclaw doctor or openclaw logs --follow