Skip to content

Interactive SPA for managing OpenClaw configuration and environment variables.

Notifications You must be signed in to change notification settings

dazeb/openclaw-config-editor

Repository files navigation

Gemini_Generated_Image_kbrgwmkbrgwmkbrg

🛠️ OpenClaw Config Editor

Precision Configuration for the Agentic Era.

Version License macOS Compatible

OpenClaw Config Editor is a high-fidelity Web SPA for managing your openclaw.json configuration and .env variables. Designed for speed, security, and deep context.

🍎 macOS Compatible - Runs locally on your Mac with full Homebrew integration and native file paths.


🚀 Features

  • Schema-Driven UI: Full coverage of all OpenClaw configuration nodes with smart controls.
  • Model Fallback Orchestrator: Interactive drag-to-reorder fallback chain with provider-specific logic.
  • Sentinel Intelligence: Integrated help system providing CLI commands and contextual reasoning for every field.
  • Security-First: Smart redaction of sensitive keys and environment variable interpolation.
  • .env Mastery: Dedicated environment variable editor with a registry of 25+ known OpenClaw variables.
  • Draft Persistence: Auto-saves to local storage so you never lose a session.
  • Agent Creator: Multi-agent management with 5 persona templates (Sentinel, Foreman, Code Specialist, Archivist).
  • Bootstrap Generator: Auto-generates SOUL.md, IDENTITY.md, MEMORY.md, and TOOLS.md files.
  • macOS Native: Full Homebrew integration, native file paths, and Apple Silicon compatibility.

📦 Getting Started

Prerequisites (macOS)

# Install Node.js via Homebrew (recommended)
brew install node

# Or download from nodejs.org
# Verify installation
node --version
npm --version

Installation

# Clone the repository
git clone https://github.com/dazeb/openclaw-config-editor.git
cd openclaw-config-editor

# Install dependencies
npm install

Development

# Start development server
npm run dev

# Navigate to http://localhost:5173
# Works in Safari, Chrome, Firefox, and Arc

Production Build

# Build for production
npm run build

# Static files will be generated in dist/
# Serve with any web server or open index.html directly

🕹️ How to Use

  1. Load Config: Paste your existing openclaw.json or start from defaults.
  2. Edit: Use the intuitive cards to adjust parameters. Hover or click the ? for Sentinel guidance.
  3. Create Agents: Use the "Agents" tab to create multiple agents with different personas.
  4. Generate Bootstrap: Download setup scripts that create SOUL.md, IDENTITY.md, and other files.
  5. Export: Export your modified config as a JSON file.
  6. Apply: Move the file to your OpenClaw root and restart the gateway.

🍎 macOS-Specific Setup

Install Dependencies via Homebrew

# Install ChromaDB for memory features
brew install python3
pip3 install chromadb

# Install Ollama for local embeddings
brew install ollama
ollama pull nomic-embed-text

# Install Docker Desktop (for sandboxing)
brew install --cask docker

macOS File Paths

The editor uses these macOS-compatible paths:

  • OpenClaw workspace: ~/.openclaw/workspace-<agent-id>
  • Agent directory: ~/.openclaw/agents/<agent-id>/agent
  • Config files: ~/.openclaw/openclaw.json
  • Environment files: ~/.openclaw/.env

Bootstrap Setup

# Run the generated setup script
chmod +x setup-<agent-id>.sh
./setup-<agent-id>.sh

# The script creates:
# - Workspace directory
# - All bootstrap files (AGENTS.md, SOUL.md, etc.)
# - Initializes the agent environment

🛡️ Security Directives

This editor runs entirely in your browser. No configuration data is ever sent to a server. For maximum security, use the __OPENCLAW_REDACTED__ patterns for sensitive keys.


📜 License

ISC © dazeb

About

Interactive SPA for managing OpenClaw configuration and environment variables.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages