Usage Surface

Web Console Guide

The web console is the broadest control surface today. Use it when you need the full ClawButler feature set: OpenClaw-first governance, runtime host pairing and discovery, visual navigation, audit investigation, or configuration workflows.

Current status#

Current status
As of the current codebase, the web console remains the reference implementation for the product surface. It carries the broadest shipped operator surface, including runtime host pairing, discovery, batch-add, and attach-mode session sync for Hermes, Claude Code, Codex, and OpenClaw.

Feature Map#

Operate

  • - Dashboard
  • - Agents
  • - Approvals
  • - Activity
  • - Sessions
  • - Chat

Insights

  • - Audit search
  • - Cost tracking
  • - Budgets
  • - Cron jobs
  • - Config versions

Productivity

  • - Templates
  • - Runbooks
  • - Tool monitor

System

  • - Connectors
  • - Runtime Hosts
  • - Notifications
  • - Health check
  • - Analytics
  • - Topology
  • - Infrastructure
  • - Organizations

Day-to-Day Workflows#

Review and resolve high-risk approvals

  1. Open `Approvals` to inspect pending requests, risk level, reasoning, and cost estimate.
  2. Use the list view for triage and the detailed card for decision context.
  3. Approve or reject directly in the page, then confirm the result in Activity or Audit.

Inspect and edit an agent configuration

  1. Go to `Agents`, open the target agent, then move across the Overview / Files / Tools / Skills / Channels / Cron tabs.
  2. Use file editing for AGENTS.md-like content and form-based edits for supported model and skill settings.
  3. After saving, verify the change in the detail page and downstream audit events.

Pair a runtime host and sync local sessions

  1. Open `Connectors`, then use the runtime-host pairing entry to authorize the machine that runs Hermes, Claude Code, Codex, or OpenClaw.
  2. Run `Discover` on the paired host to inspect detected local runtimes, then use `Add Selected` to create connectors only for the instances you want governed.
  3. Use `Sync Sessions` when you want attach-mode threads projected into ClawButler sessions for investigation and follow-up.

Run governance investigations

  1. Use `Activity` for real-time feed and `Audit` for historical search.
  2. Use `Cost`, `Cron`, `Analytics`, and `Reports` when you need trend or root-cause context.
  3. Escalate with `Kill Switch` from the Agents views when a workflow must be stopped immediately.

Navigation Model#

  • - The left sidebar is the authoritative map of current web capabilities.
  • - Agent-specific editing lives under `Agents` detail pages, not under a global settings page.
  • - Connector and runtime-host operations are concentrated under `Connectors`, while diagnostics and admin flows now stay focused on notifications, health, infrastructure, topology, and internal org management.

Suggested Screenshots#

Screenshot Placeholder
Dashboard overview
Show the top-level dashboard with metrics, urgent approval, and agent health summary.
Screenshot Placeholder
Agent detail configuration tabs
Show the Overview / Files / Tools / Skills / Channels / Cron tab layout for one agent.
Screenshot Placeholder
Approvals workspace
Show the approval list with decision controls and risk/cost context.
Screenshot Placeholder
Runtime host discovery flow
Show paired runtime hosts, discovered Hermes / Claude Code / Codex / OpenClaw instances, and the Add Selected / Sync Sessions actions.
Web Console Guide — ClawButler