Claude Code — installer for hooks + plugin

npm run hooks:install ln -s "$(pwd)/plugins/dashclaw" ~/.claude/plugins/dashclaw

Codex — installer wires manifest, hooks, and AGENTS.md governance protocol

node cli/bin/dashclaw.js install codex --project /path/to/your/project

Deploy

$0 to deploy. Vercel free tier plus Neon free tier. Click the button, add the Neon integration when prompted, fill in the env vars listed in .env.example. The schema migration runs as part of the build, so there is no manual migration step.

After deploy

1. Open the app at https://your-app.vercel.app and sign in.
2. Copy the integration snippet from Mission Control. It pre-fills your base URL and gives you a one-click API key.
3. Run it. node --env-file=.env demo.js from any client environment and watch the governed action land in your decisions ledger.

Quick start

10-second demo

npx dashclaw-demo

Spins up a local demo runtime, fires a simulated high-risk deployment, lets DashClaw block it, and opens Decision Replay in your browser. No setup, no accounts.

Optional

• Live decision stream. Add Upstash Redis credentials (UPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN) to get cross-instance event replay. Without it, Mission Control uses in-memory events, which is fine for getting started but does not persist across serverless invocations.
• Hosted trial mode. If you want DashClaw itself to mint trial workspaces (operator deployments only), follow docs/hosted-deployment-runbook.md. That path needs Turnstile, cleanup secrets, and an operator-managed cron.
• Self-host without Vercel. A Dockerfile and standalone next start path are available; see Dockerfile. The schema migration in scripts/auto-migrate.mjs is idempotent and safe to re-run.

---

3. Node and Python SDKs — including framework integrations

For custom agents, frameworks, and anywhere you want explicit control over what gets governed.

npm install dashclaw     # Node 18+
pip install dashclaw     # Python 3.7+

87-method canonical Node surface: core governance, durable execution finality, scoring profiles, learning analytics, messaging, handoffs, security scanning, threads, sessions, and the execution-studio domains (workflow templates, model strategies, knowledge collections, capability runtime). The Python SDK exposes 227 methods including ready-made framework integrations:

```python

5. Direct REST API and webhooks

Every governance primitive is reachable as HTTP. The stable contract is pinned in docs/openapi/critical-stable.openapi.json; the full inventory (259 routes: 46 stable, 24 beta, 189 experimental) is at docs/api-inventory.md. Webhook events include signal.detected, decision.created, action.created, lost_confirmation, and the rest of the catalog — configurable per org.

6. Skills — governance protocol + live platform reference

Two drop-in skills, both available as zip bundles or source directories in public/downloads/ and auto-bundled into the coding-agent plugins:

• dashclaw-governance — governance protocol skill. Teaches agents the decision tree (allow / warn / block / require_approval), action recording, approval-wait protocol, session lifecycle, plus six new sections for handoffs, secret hygiene, skill safety, action-scoped open loops, learning, and in-session retrospection.
• dashclaw-platform-intelligence — live API reference, env var contract, and troubleshooting playbook with progressive disclosure. Regenerated from the codebase on every release so it never drifts from the running runtime.

cp -r public/downloads/dashclaw-governance .claude/skills/
cp -r public/downloads/dashclaw-platform-intelligence .claude/skills/

Or grab the zips from dashclaw.io/downloads. The platform-intelligence skill is also published on ClawHub.

---

Real agent in 8 minutes (SDK path)

npm install dashclaw   # or: pip install dashclaw

import { DashClaw, GuardBlockedError, ApprovalDeniedError } from 'dashclaw';

const claw = new DashClaw({
  baseUrl: process.env.DASHCLAW_BASE_URL,
  apiKey: process.env.DASHCLAW_API_KEY,
  agentId: 'my-agent',
});

// 1. Guard
const decision = await claw.guard({ action_type: 'deploy', risk_score: 80 });

// 2. Record
const action = await claw.createAction({
  action_type: 'deploy',
  declared_goal: 'Ship release 2.13.4 to production',
});

// 3. Verify reasoning basis
await claw.recordAssumption({
  action_id: action.action_id,
  assumption: 'Tests passed on the candidate commit',
});

// 4. Outcome (durable, retry-safe)
try {
  // ...do the real work...
  await claw.reportActionSuccess(action.action_id, 'Deployed 2.13.4');
} catch (err) {
  await claw.reportActionFailure(action.action_id, err.message);
}

Python uses the same shape with snake_case. Full reference: sdk/README.md. Step-by-step walkthrough: QUICK-START.md.

---

Choose your integration path

DashClaw meets agents where they already are. Every path lands on the same governance primitives, audit ledger, and approval queue — pick the one closest to how your agent already runs.

1. Coding-agent plugins (Claude Code, Codex, Hermes Agent)

One plugin source, three ecosystems. Distributed via plugins/dashclaw/. Each manifest ships the MCP server config, the dashclaw-governance protocol skill, the dashclaw-platform-intelligence reference skill, and a distinct agent_id so Mission Control separates sessions per host.

```bash

4. OpenClaw plugin

For agents built on OpenClaw, @dashclaw/openclaw-plugin wires governance into the lifecycle directly.

npm install @dashclaw/openclaw-plugin

It intercepts every tool-use call (before_tool_call, llm_output, after_tool_call, agent_end), calls guard / record / waitForApproval automatically, and ships a HOOK.md the openclaw CLI installs. Tool-classification vocabulary aligns with DashClaw guard action types so policies behave consistently across plugin, hook, and SDK paths.