Openclaw Monorepo — DevOps skill for Claude Code

openclaw-platform

Monorepo-style **OpenClaw** workspace for local usage + development (git submodule in `openclaw/`) with modular JSON5 config and optional Docker sandboxes.

• English (this file) · 中文: `README.zh-CN.md`
• Run everything via pnpm openclaw ... (wrapper: `scripts/openclaw.mjs`)
• Commit-safe config lives in `config/openclaw/` (split into modular JSON5 files)
• Repo-local state lives in bots/ (gitignored; migration notes in `bots/README.md`)
• Instead of the default ~/.openclaw/, this repo pins state/config/workspaces under bots/ (e.g. bots/workspaces//) so everything stays in one place

[!NOTE] You are reading the `monorepo` branch. If you need the Termux + proot setup and tooling, switch to the `proot-debian` branch.

[!IMPORTANT] `config/.env` and `bots/` contain secrets/state. Keep them out of git.

This repo intentionally tracks only `bots/README.md` and `bots/openclaw.json` under `bots/`.

What this repo gives you

• A predictable, repo-local OpenClaw setup: config + workspaces + state live together under this repo folder (instead of ~/.openclaw/).
• Modular JSON5 config you can edit/review in git (secrets stay in config/.env, never in JSON5).
• Repo-local plugins (custom tools/skills) under plugins/ that live outside the openclaw/ submodule.
• Optional Docker sandbox images for agents that need extra system dependencies (LibreOffice, OCR, etc.).

Contents

• Prerequisites
• Quick start
• How config is wired
• Repo layout
• Project tree (sketch)
• Docs
• Common commands
• Sandboxed agents (Docker)

Prerequisites

• Node.js 24.x (recommended; OpenClaw requires >=22.12.0)
• corepack enable (for pnpm)
• Docker (optional; only needed for sandboxed agen