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 agent detail governance tabs with lifecycle actions, plus runtime host pairing, discovery, batch-add, attach-mode session sync, experimental managed inspection, runtime-host governance summaries, and managed write boundary previews for supported Hermes, Claude Code, Codex, and OpenClaw runtimes.

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 configuration tabs and the scorecard / governance views.
  2. Use file editing for AGENTS.md-like content and form-based edits for supported model and skill settings.
  3. Use the Governance tab to review recent decisions, activity, and traces, or to pause / resume / retire the agent before or after a change.

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, inspect managed session summaries inline when you need prompt state, cost, or pending approval context, and open the host governance panel to review decision/activity/trace summaries plus task-grant boundaries before higher-risk managed actions.

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.
  • - The old `/operations` page now acts only as a legacy launcher to `Approvals`, `Runbooks`, `Cron`, and `Sessions`, rather than a separate operations cockpit.

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 one agent detail page with configuration tabs plus the governance view and lifecycle actions.
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, the Add Selected / Sync Sessions actions, and managed session inspection on supported runtimes.
Web Console Guide — ClawButler