Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

examples/ai-chat/README.md

@@ -0,0 +1,29 @@
+# @openclaw/ai example: minimal chat completion
+
+Smallest possible consumer of the published `@openclaw/ai` package: creates an
+isolated runtime, registers the built-in API providers, and streams one
+completion. No OpenClaw application code is involved — inside this repo the
+workspace link resolves to the package's built `dist`, the same artifact npm
+consumers install, so `pnpm build` must have run first.
+
+```sh
+ANTHROPIC_API_KEY=sk-ant-... node index.mjs "Say hello"
+OPENAI_API_KEY=sk-... node index.mjs --provider openai "Say hello"
+# keyless, against a local Ollama server (OLLAMA_MODEL overrides the model id)
+node index.mjs --provider ollama "Say hello"
+```
+
+Text deltas stream to stdout; stop reason and token usage go to stderr.
+
+Notes for library consumers:
+
+- `createLlmRuntime()` gives you an isolated registry; nothing is registered
+  globally by importing the package.
+- `registerBuiltInApiProviders(runtime.registry)` opts into the eight built-in
+  transports (Anthropic, OpenAI Completions/Responses, Azure OpenAI, ChatGPT
+  Responses, Google, Vertex, Mistral). Provider SDK modules load lazily on
+  first use.
+- Host policy (custom fetch, secret redaction, strict-tool defaults, logging)
+  is injectable via `configureAiTransportHost`; the defaults are inert.
+- Full TypeScript types ship with the package; this example uses plain ESM so
+  it runs with bare `node`.

examples/ai-chat/index.mjs

@@ -0,0 +1,85 @@
+// Minimal @openclaw/ai consumer: one isolated runtime, built-in providers,
+// one streamed completion. Uses only the public package surface — no OpenClaw
+// application code. Run with:
+//   ANTHROPIC_API_KEY=... node index.mjs "your prompt"
+//   OPENAI_API_KEY=... node index.mjs --provider openai "your prompt"
+import { createLlmRuntime } from "@openclaw/ai";
+import { registerBuiltInApiProviders } from "@openclaw/ai/providers";
+
+const MODELS = {
+  anthropic: {
+    id: "claude-sonnet-4-6",
+    name: "Claude Sonnet 4.6",
+    api: "anthropic-messages",
+    provider: "anthropic",
+    baseUrl: "https://api.anthropic.com",
+    reasoning: true,
+    input: ["text"],
+    cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
+    contextWindow: 200_000,
+    maxTokens: 8192,
+  },
+  openai: {
+    id: "gpt-5.5",
+    name: "GPT-5.5",
+    api: "openai-responses",
+    provider: "openai",
+    baseUrl: "https://api.openai.com/v1",
+    reasoning: true,
+    input: ["text"],
+    cost: { input: 1.25, output: 10, cacheRead: 0.125, cacheWrite: 0 },
+    contextWindow: 400_000,
+    maxTokens: 16_384,
+  },
+  // Local Ollama server; no API key required.
+  ollama: {
+    id: process.env.OLLAMA_MODEL || "llama3.2:latest",
+    name: "Ollama",
+    api: "openai-completions",
+    provider: "ollama",
+    baseUrl: "http://localhost:11434/v1",
+    reasoning: false,
+    input: ["text"],
+    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+    contextWindow: 32_000,
+    maxTokens: 4096,
+  },
+};
+
+const args = process.argv.slice(2);
+const providerFlag = args.indexOf("--provider");
+const provider = providerFlag === -1 ? "anthropic" : args[providerFlag + 1];
+const prompt =
+  args.filter((_, i) => i !== providerFlag && i !== providerFlag + 1).join(" ") ||
+  "Reply with one short sentence: what is @openclaw/ai?";
+
+const model = MODELS[provider];
+if (!model) {
+  console.error(`Unknown provider "${provider}". Use one of: ${Object.keys(MODELS).join(", ")}`);
+  process.exit(1);
+}
+
+const runtime = createLlmRuntime();
+registerBuiltInApiProviders(runtime.registry);
+
+const stream = runtime.streamSimple(
+  model,
+  { messages: [{ role: "user", content: prompt, timestamp: Date.now() }] },
+  // Ollama ignores credentials but the OpenAI-compatible transport requires one.
+  provider === "ollama" ? { apiKey: "ollama" } : undefined,
+);
+
+for await (const event of stream) {
+  if (event.type === "text_delta") {
+    process.stdout.write(event.delta);
+  }
+}
+const result = await stream.result();
+process.stdout.write("\n");
+
+if (result.stopReason === "error" || result.stopReason === "aborted") {
+  console.error(`error: ${result.errorMessage ?? result.stopReason}`);
+  process.exit(1);
+}
+const { input, output } = result.usage;
+console.error(`[${model.id}] stop=${result.stopReason} tokens in=${input} out=${output}`);

examples/ai-chat/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@openclaw/example-ai-chat",
+  "version": "0.0.0-private",
+  "private": true,
+  "description": "Minimal external-consumer example for @openclaw/ai",
+  "type": "module",
+  "scripts": {
+    "start": "node index.mjs"
+  },
+  "dependencies": {
+    "@openclaw/ai": "workspace:*"
+  }
+}