Integration
Sentinel Bridge
By OpenClaw plugin — Multi-engine provider bridge for Claude Code, Codex & Grok. Use your existing subscriptions instead of per-token billing.
Install
npm install sentinel-bridgeConfiguration Example
// openclaw config
{
"plugins": {
"sentinel-bridge": {
"defaultEngine": "claude"
}
}
}README
# sentinel-bridge
**Multi-engine coding agent for OpenClaw — route through Claude Code, Codex, and Grok.**
[](https://www.npmjs.com/package/sentinel-bridge)
[](LICENSE)
[](https://nodejs.org)
---
## Why?
As of April 2026, Anthropic bills third-party harness usage of Claude models separately — even if you already have a Claude Pro or Max subscription. Your existing plan only covers Anthropic's own tools.
**Claude Code CLI**, however, remains fully covered by the subscription. sentinel-bridge exploits this: it routes OpenClaw requests _through_ Claude Code CLI, so your subscription covers the usage. Zero additional cost.
## What It Does
sentinel-bridge is an OpenClaw plugin that exposes three coding agent engines through a unified interface:
- **Claude Code CLI** — subscription-covered, zero extra cost
- **OpenAI Codex CLI** — full Codex integration with working directory persistence
- **xAI Grok API** — Grok models via HTTP
All engines look the same to OpenClaw. Start sessions, send messages, switch models, track costs — one API for everything.
## Quick Start
```bash
npm install sentinel-bridge
openclaw plugins install sentinel-bridge
```
```jsonc
// openclaw config
{
"plugins": {
"sentinel-bridge": {
"defaultEngine": "claude"
}
}
}
```
That's it. Your Claude requests now route through the CLI. 🎯
## Architecture
```
┌─────────────────────────────────────────────────┐
│ OpenClaw Host │
│ │
│ ┌─────────────────────────────────────────────┐ │
│ │ sentinel-bridge │ │
│ │ │ │
│ │ Tools (sb_*) → SessionManager │ │
│ │ ├── Session #1 │ │
│ │ ├── Session #2 │ │
│ │ └── ... │ │
│ │ │ │
│ │ ┌── IEngine Interface ──┐ │ │
│ │ │ │ │ │
│ │ Claude Engine Codex Engine Grok │ │
│ │ │ │ Engine │ │
│ └────────────┼────────────┼──────────┼────────┘ │
│ │ │ │ │
└───────────────┼────────────┼──────────┼──────────┘
│ │ │
claude CLI codex CLI xAI HTTP API
(subscription) (API key) (API key)
```
## Features
- **Subscription passthrough** — Claude usage via CLI costs $0 beyond your existing plan
- **Multi-engine sessions** — Claude, Codex, and Grok through one interface
- **Session persistence** — Claude sessions resume across restarts; Codex persists via working directory
- **Live model switching** — change models mid-session without losing context
- **Engine switching** — swap engines on the fly, same working directory
- **Cost tracking** — per-session, per-engine breakdowns with subscription savings highlighted
- **Fallback chains** — automatic failover to a backup engine on errors
- **Lazy initialization** — zero memory footprint until first use
- **11 tools** in the `sb_*` namespace — full session lifecycle management
## Engines
| Engine | Transport | Auth | Cost | Status |
|--------|-----------|------|------|--------|
| **Claude** | CLI subprocess (stream-json) | Subscription OAuth | $0 (subscription-covered) | ✅ Implemented |
| **Codex** | CLI per-message (quiet mode) | `OPENAI_API_KEY` | Standard OpenAI pricing | ✅ Implemented |
| **Grok** | HTTP API (OpenAI-compatible) | `XAI_API_KEY` | Standard xAI pricing | ✅ Implemented |
### Supported Models
| Model | Aliases | Engine | Input/1M | Output/1M |
|-------|---------|--------|----------|-----------|
| claude-opus-4 | `opus` | Claude | $15.00* | $75.00* |
| claude-sonnet-4 | `sonnet` | Claude | $3.00* | $15.00* |
| claude-haiku-4 | `haiku` | Claude | — | — |
| o4-mini | — | Codex | $1.10 | $4.40 |
| codex-mini | `codex-mini` | Codex | $1.50 | $6.00 |
| grok-3 | `grok-3` | Grok | $3.00 | $15.00 |
| grok-3-mini | `grok-mini` | Grok | $0.30 | $0.50 |
_*Tracked for visibility but covered by subscription — actual cost is $0._
## Configuration
```jsonc
{
"plugins": {
"sentinel-bridge": {
"defaultEngine": "claude", // "claude" | "codex" | "grok"
"defaultModel": "claude-sonnet-4",
"maxConcurrentSessions": 5,
"sessionTtlMinutes": 120,
"fallbackEngine": "codex", // optional: auto-failover
// Engine-specific overrides
"claude": {
"command": "claude", // path to claude CLI
"model": "claude-sonnet-4"
},
"codex": {
"command": "codex",
"model": "o4-mini"
},
"grok": {
"apiKey": "xai-...", // or use XAI_API_KEY env
"model": "grok-3"
}
}
}
}
```
For the full configuration reference, see [docs/configuration.md](docs/configuration.md).
## Migration Guide
Moving from direct Anthropic API usage to sentinel-bridge:
**Before** (direct API — billed separately):
```jsonc
{
"model": "anthropic/claude-opus-4-6"
}
```
**After** (routed through Claude Code CLI — subscription-covered):
```bash
# 1. Install
npm install sentinel-bridge
# 2. Ensure Claude CLI is authenticated
claude login
# 3. Configure OpenClaw
openclaw plugins install sentinel-bridge
```
```jsonc
{
"plugins": {
"sentinel-bridge": {
"defaultEngine": "claude",
"defaultModel": "claude-opus-4"
}
}
}
```
Your requests now go through the CLI. Same models, same quality, zero additional billing.
## Tools
sentinel-bridge registers 11 tools under the `sb_*` namespace:
| Tool | Description |
|------|-------------|
| `sb_session_start` | Start a new session with any engine |
| `sb_session_send` | Send a message to an active session |
| `sb_session_stop` | Stop a session and clean up |
| `sb_session_list` | List all active sessions |
| `sb_session_status` | Detailed session status with cost/tokens |
| `sb_session_compact` | Compact context window |
| `sb_engine_list` | List available engines and auth status |
| `sb_model_list` | List models with pricing |
| `sb_session_switch_model` | Switch model mid-session |
| `sb_session_switch_engine` | Switch engine mid-session |
| `sb_cost_report` | Aggregated cost report |
For full parameter documentation, see [docs/API-REFERENCE.md](docs/API-REFERENCE.md).
## Documentation
- [Getting Started](docs/getting-started.md)
- [Configuration Reference](docs/configuration.md)
- [API Reference](docs/API-REFERENCE.md)
- [Technical Architecture](docs/TECHNICAL-ARCHITECTURE.md)
## Contributing
1. Fork the repo
2. Create a feature branch (`git checkout -b feat/my-feature`)
3. Write tests (`npm test`)
4. Ensure types pass (`npm run lint`)
5. Open a PR
Keep dependencies minimal — sentinel-bridge targets zero runtime dependencies beyond Node.js built-ins.
## License
[MIT](LICENSE) © 2026 Adrian Muff
integration
Comments
Sign in to leave a comment