@benkovy/doh

@benkovy/doh is the OpenClaw channel plugin for DOH.

It registers the doh channel and connects OpenClaw to doh-host, the local runtime that authenticates to the DOH cloud backend.

Quick Start

1. Install plugin and host runtime:

openclaw plugins install @benkovy/doh
npm install -g @benkovy/doh-host

2. Bootstrap host credentials:

doh-host init --email [email protected]
doh-host init --token <token-from-email>

3. Enable plugin and configure channel:

{
  plugins: {
    entries: {
      doh: { enabled: true }
    }
  },
  channels: {
    doh: {
      host: {
        bin: "doh-host"
      },
      accounts: {
        default: { enabled: true }
      },
      security: {
        dmPolicy: "pairing"
      }
    }
  }
}

4. Restart OpenClaw Gateway.

Config Model

• Plugin enablement lives under plugins.entries.doh.
• Channel/runtime config lives under channels.doh.
• If channels.doh.accounts is omitted, plugin falls back to implicit default account.

Runtime Model

@benkovy/doh now always uses external host runtime mode. The plugin never spawns doh-host; it only provides diagnostics and channel wiring.

Run the host runtime separately (for example via launchd/systemd/pm2/supervisor):

channels: {
  doh: {
    host: {
      bin: "doh-host"
    }
  }
}

Start host runtime externally:

doh-host run

The plugin syncs OPENCLAW_GATEWAY_TOKEN from OpenClaw config into ~/.doh-host/config.env, so external doh-host run picks it up without requiring manual token export each time.

Verify Setup

doh-host status --json

Expect configured: true with tenantId, hostId, and keyId populated.

Troubleshooting

Unknown channel doh

• ensure plugin is installed: openclaw plugins list
• ensure plugin is enabled: plugins.entries.doh.enabled = true
• restart Gateway after config/plugin changes

doh-host command missing

npm install -g @benkovy/doh-host

Or set channels.doh.host.bin to absolute path.

Host runtime not connected

• run: doh-host status --probe
• run host in foreground temporarily: doh-host run
• ensure plugin account is enabled and backend tenant/email matches bootstrap identity

Channel status is healthy but app says no host

• doh-host status --probe should report backend and gateway ok
• backend /health should show hostConnections > 0 while doh-host run is active

Wrong email/account used

doh-host reset --yes
doh-host init --email [email protected]
doh-host init --token <token-from-email>

Notes

• bootstrapToken config support was removed.
• Setup and diagnostics are CLI-driven through doh-host.