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
| Option | Type | Default | Description |
|---|---|---|---|
| model | string | "gpt-4o" | Model identifier |
| provider | string | "openai" | API provider |
| baseUrl | string | undefined | Custom API base URL |
| tools | array | ["fs"] | Enabled tools |
| shellAllowList | string[] | undefined | Allowed shell commands |
| allowAbsolutePaths | boolean | false | Allow fs outside CWD |
| maxSteps | number | 20 | Max tool calls per run |
| maxRetries | number | 2 | Retries per failed call |
| timeout | number | 30000 | Per-step timeout ms |
| parallelTools | boolean | false | Parallel tool calls |
| contextFiles | string[] | [] | Always-included files |
| systemPrompt | string | undefined | Override system prompt |
| logDir | string | ".claw/runs" | Run log directory |
| verbose | boolean | false | Print each step |
| noColor | boolean | false | Disable ANSI colors |