ZeroClaw OpenShift deployment

Deploy a minimal ZeroClaw agent on OpenShift with an external LLM provider (Anthropic, OpenAI, or any OpenAI-compatible API).

Prerequisites

oc CLI authenticated to your OpenShift cluster
Container image pushed to an accessible registry
API key for your LLM provider

Quick start

Copy the sample manifests to create your real ones:

bash

for f in deploy-k8s/*-sample.yaml; do cp "$f" "${f/-sample/}"; done

Edit secret.yaml and replace REPLACE_WITH_YOUR_API_KEY with your actual API key
Update the image field in deployment.yaml to point to your registry (e.g., ghcr.io/youruser/zeroclaw:latest)
Update the namespace in all files if you want a different name
Optionally edit configmap.yaml to change the provider or model
Apply all manifests:
bash
```
oc apply -f deploy-k8s/
```

The real .yaml files are gitignored so your secrets and customizations stay local.

Verification

Check that the pod is running and the route is accessible:

bash

oc -n zeroclaw get pods
oc -n zeroclaw get route zeroclaw

Test the health endpoint:

bash

ROUTE=$(oc -n zeroclaw get route zeroclaw -o jsonpath='{.spec.host}')
curl -sf "https://${ROUTE}/health"

Send a test message:

bash

curl -X POST "https://${ROUTE}/webhook" \
  -H "Content-Type: application/json" \
  -d '{"message": "hello, what model are you?"}'

Configuration

The shape of configmap.yaml's embedded config.toml follows the canonical Provider Configuration → Minimal working example. The sample's aliases are cloud (provider entry) and assistant (agent + risk profile) — substitute your own. Common edit points:

Setting	Path in `config.toml`	Sample value
Model	`providers.models.anthropic.cloud.model`	`claude-sonnet-4-20250514`
Temperature	`providers.models.anthropic.cloud.temperature`	`0.7`
Autonomy level	`risk_profiles.assistant.level`	`supervised`
Agent → provider link	`agents.assistant.model_provider`	`anthropic.cloud`

To swap to a different provider type (OpenAI, OpenRouter, Ollama, etc.), replace the [providers.models.anthropic.cloud] block with a [providers.models.<type>.<alias>] entry from providers/catalog and update agents.assistant.model_provider to match.

After editing, re-apply and restart the pod:

bash

oc apply -f deploy-k8s/configmap.yaml
oc -n zeroclaw rollout restart deployment zeroclaw

Notes

State is ephemeral. Both state and workspace volumes use emptyDir — agent memory and session history do not persist across pod restarts. For production, replace these with PersistentVolumeClaims.
Vanilla Kubernetes. The Route object is OpenShift-specific. On vanilla Kubernetes, replace route-sample.yaml with a Kubernetes Ingress targeting port 42617.

Cleanup

bash

oc delete namespace zeroclaw