claw.config.ts Reference

Complete reference for every option in the Testy Claw config file.

Full config with all options

claw.config.ts
import { defineConfig } from "testy-claw";

export default defineConfig({
  // ── Model ──────────────────────────────────────────
  model: "gpt-4o",
  provider: "openai",          // "openai" | "anthropic" | "mistral" | "custom"
  baseUrl: undefined,          // custom API base URL (for self-hosted models)
  apiKey: undefined,           // override env var (not recommended)

  // ── Tools ──────────────────────────────────────────
  tools: ["fs", "shell"],      // built-in keys or custom tool objects
  shellAllowList: undefined,   // string[] — restrict shell commands
  allowAbsolutePaths: false,   // allow fs tool to access paths outside CWD

  // ── Execution ──────────────────────────────────────
  maxSteps: 20,
  maxRetries: 2,               // retries per failed tool call
  timeout: 30_000,             // ms per tool call
  parallelTools: false,        // allow model to call multiple tools per step

  // ── Context ────────────────────────────────────────
  contextFiles: [],            // always-included files
  systemPrompt: undefined,     // override the default system prompt

  // ── Output ─────────────────────────────────────────
  logDir: ".claw/runs",
  verbose: false,
  noColor: false,
});

All options

OptionTypeDefaultDescription
modelstring"gpt-4o"Model identifier
providerstring"openai"API provider
baseUrlstringundefinedCustom API base URL
toolsarray["fs"]Enabled tools
shellAllowListstring[]undefinedAllowed shell commands
allowAbsolutePathsbooleanfalseAllow fs outside CWD
maxStepsnumber20Max tool calls per run
maxRetriesnumber2Retries per failed call
timeoutnumber30000Per-step timeout ms
parallelToolsbooleanfalseParallel tool calls
contextFilesstring[][]Always-included files
systemPromptstringundefinedOverride system prompt
logDirstring".claw/runs"Run log directory
verbosebooleanfalsePrint each step
noColorbooleanfalseDisable ANSI colors