NyxClaw 🦞

Claude Max Sub proxy for OpenClaw. Fork of Meridian with full tool passthrough.

Why NyxClaw?

Meridian's passthrough mode defaults to OFF and uses maxTurns: 2, which can cause the SDK to execute a no-op passthrough tool and feed incorrect results back to the model. NyxClaw fixes this:

• PASSTHROUGH defaults to true — OpenClaw handles all tool execution
• maxTurns: 1 in passthrough mode — we only need the model's initial response with tool_use blocks, OpenClaw takes it from there

Installation

npm install -g nyxclaw

Setup

1. Create a dedicated user for Claude auth

sudo useradd -m -s /bin/bash meridian
sudo -u meridian claude login

2. Create a systemd service

# /etc/systemd/system/nyxclaw.service
[Unit]
Description=NyxClaw - Claude Max Sub proxy
After=network.target

[Service]
Type=simple
User=meridian
ExecStart=/usr/bin/env nyxclaw
Restart=always
RestartSec=5
Environment=MERIDIAN_PORT=3456
Environment=MERIDIAN_HOST=127.0.0.1

[Install]
WantedBy=multi-user.target

sudo systemctl enable --now nyxclaw

3. Point OpenClaw at it

In your OpenClaw config, set the model provider to:

ANTHROPIC_BASE_URL=http://127.0.0.1:3456
ANTHROPIC_API_KEY=x

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | MERIDIAN_PORT | 3456 | Port to listen on | | MERIDIAN_HOST | 127.0.0.1 | Host to bind to | | MERIDIAN_PASSTHROUGH | true | Passthrough mode (tools forwarded to client) | | MERIDIAN_IDLE_TIMEOUT_SECONDS | 120 | Idle connection timeout |

Credits

NyxClaw is a fork of Meridian by rynfar. All the heavy lifting — SDK integration, session management, streaming, OpenAI compat — is Meridian's work. NyxClaw just tunes the defaults for OpenClaw's architecture.

License

MIT