OpenClaw

OpenClaw is the primary host for LightRSI, with the deepest integration via a native plugin slot.

Installation

pnpm component:install:tokenpilot:openclaw

This command:

• Updates ~/.openclaw/openclaw.json
• Enables the TokenPilot plugin
• Switches plugins.slots.contextEngine to layered-context
• Sets the default normal mode
• Attempts to restart the OpenClaw gateway

Custom Paths

export LIGHTRSI_OPENCLAW_HOME="/path/to/openclaw-home"
export OPENCLAW_CONFIG_PATH="/path/to/openclaw.json"
pnpm component:install:tokenpilot:openclaw

Expected Output

After install, your ~/.openclaw/openclaw.json will include a TokenPilot section:

{
  "plugins": {
    "slots": {
      "contextEngine": "layered-context"
    },
    "entries": {
      "tokenpilot": {
        "enabled": true,
        "mode": "normal"
      }
    }
  }
}

Verification

Inside an OpenClaw session:

/lightrsi status

Expected output:

• plugin entry enabled
• config enabled
• mode normal
• context engine slot layered-context
• stabilizer enabled
• reduction enabled

For a fuller check:

/lightrsi doctor
/lightrsi report
/lightrsi visual

In-Session Commands

OpenClaw supports in-session slash commands:

/lightrsi status          # View current status
/lightrsi report          # Session token/cost report
/lightrsi doctor          # Integration self-check
/lightrsi visual          # Open visual inspector
/lightrsi mode normal     # Switch mode
/lightrsi stabilizer target developer
/lightrsi reduction mode balanced
/lightrsi eviction on
/lightrsi help            # List all commands

Standalone CLI

Commands also work outside OpenClaw:

lightrsi openclaw status
lightrsi openclaw report
lightrsi openclaw doctor
lightrsi openclaw visual
lightrsi openclaw mode normal
lightrsi openclaw session <session-id> report

Model Selection

lightrsi/gpt-5.4-mini

Recovery

cp ~/.openclaw/openclaw.json.tokenpilot.bak ~/.openclaw/openclaw.json

Troubleshooting

See TokenPilot Troubleshooting for OpenClaw-specific issues.