Skip to content

Troubleshoot Clawdlinux Operator

Inspect Resource State

bash
kubectl -n agentic-system get deployments,pods
kubectl -n agentic-system get agentworkloads
kubectl -n agentic-system describe agentworkload <name>
kubectl -n agentic-system get events --sort-by=.lastTimestamp
kubectl -n agentic-system get deployments --show-labels
kubectl -n agentic-system logs deployment/<operator-deployment>

Replace placeholders with actual names. Use the workload's namespace when it differs from agentic-system.

Workload Stuck Or Failed

Check provider Secret names and keys, endpoints, model mappings, and spec.orchestration.type. Check CLAWDLINUX_AGENT_IMAGE for pod and kagent adapters. Confirm Argo or kagent is installed when selected. Inspect status.conditions, status.argoWorkflow, and status.argoPhase.

Tenant Stuck In Provisioning

The Tenant controller copies <provider>-token Secrets from agentic-system into the tenant namespace. Check those Secrets and operator permissions for namespaces, ServiceAccounts, Roles, RoleBindings, Secrets, and ResourceQuotas.

Policy Denied Or Approval Pending

Inspect status.proposedActions and status.conditions for PolicyDenied or PendingApproval. opaPolicy selects the legacy in-process Go evaluator, not Rego execution. Direct MCP approval continuation is not connected end to end.

Cost Shows Zero

The default NoOpCostReporter records nothing. AGENTIC_COST_TRACKING=memory enables local-evaluation reporting but resets on restart. Do not use it for billing.

gVisor Pod Does Not Start

bash
kubectl get runtimeclass gvisor
kubectl -n <namespace> describe pod <pod>

Nodes need runsc and a matching RuntimeClass. Strict admission also requires a Ready node capable of running that class. Without a scheduling selector, confirm the node readiness label described in configuration.

NetworkPolicy Does Not Block Traffic

Confirm the policy namespace, matching pod labels, and an enforcing CNI. For Cilium FQDN policy, confirm Cilium and explicit chart enablement. Policy-object presence alone does not prove packet enforcement.

Audit Output Missing

audit-verify supports JSONL; its ClickHouse source adapter is a stub. Automatic complete per-run signed evidence is not connected. Prior-run fixtures do not prove capture from your current workload. See evidence boundaries.

Apache-2.0 licensed open-source core.