Skip to main content

Installation

Get xops.bot up and running in a few minutes.

Prerequisites​

Before installing xops.bot, make sure you have:

  • Bun v1.0 or later (runtime)
  • OpenClaw installed and accessible on your PATH
  • An LLM provider subscription -- Claude Pro/Max, ChatGPT Plus, or Gemini Advanced (OpenClaw handles authentication)

Optional (for specific agents)​

ToolRequired byPurpose
kubectlK8s BotKubernetes cluster operations
helmK8s BotHelm chart management
aws CLIFinOps Bot, Platform BotAWS cloud operations
terraformPlatform BotInfrastructure as Code

Install​

1. Clone the repository​

git clone https://github.com/agenticdevops/xopsbot.git
cd xopsbot

2. Install dependencies​

bun install

3. Run the setup wizard​

bun run setup

The wizard walks you through selecting agent workspaces, channels, tools, safety mode, and LLM provider. See the Setup Wizard for a detailed guide.

4. Start OpenClaw​

openclaw

OpenClaw will load your xops.bot configuration and start the agents you selected.

Verify Installation​

After running the wizard, check that the following files were created:

~/.openclaw/openclaw.json      # OpenClaw config pointing to xops.bot workspaces
~/.xopsbot/workspaces/         # Your selected agent workspace templates
~/.xopsbot/profiles/           # Your selected safety profile

You can also verify by running:

bun run wizard

If the banner appears and the wizard starts, everything is working.

Directory Structure​

After installation, your project looks like this:

xopsbot/
  schemas/           # Zod schemas (profile, safety, presets)
  safety/            # Risk classifications for tools
  workspaces/        # Agent workspace templates
    k8s-agent/       # K8s Bot workspace
    rca-agent/       # RCA Bot workspace
    incident-agent/  # Incident Bot workspace
    finops-agent/    # FinOps Bot workspace
    platform-agent/  # Platform Bot workspace
  profiles/          # Environment profile templates
    dev/             # Development (full access)
    stage/           # Staging (approval required)
    prod/            # Production (restricted)
  skills/            # Shared DevOps skill files
  plugins/           # Plugin manifests and registry
  presets/           # Role-based preset definitions
  cli/               # CLI commands (plugin, preset, safety-switch)
  wizard/            # Setup wizard
    banner.ts        # ASCII art banner
    index.ts         # Wizard entry point
    steps/           # Wizard step implementations
    templates/       # Config generation templates

Next Steps​