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

config/knip.config.ts

@@ -0,0 +1,249 @@
+/**
+ * Knip configuration for OpenClaw root and bundled plugin dependency hygiene.
+ */
+const BUNDLED_PLUGIN_ROOT_DIR = "extensions";
+
+function bundledPluginFile(pluginId: string, relativePath: string, suffix = ""): string {
+  return `${BUNDLED_PLUGIN_ROOT_DIR}/${pluginId}/${relativePath}${suffix}`;
+}
+
+const rootEntries = [
+  "openclaw.mjs!",
+  "src/index.ts!",
+  "src/entry.ts!",
+  "src/cli/daemon-cli.ts!",
+  "src/agents/code-mode.worker.ts!",
+  "src/agents/model-provider-auth.worker.ts!",
+  "src/infra/kysely-node-sqlite.ts!",
+  "src/infra/warning-filter.ts!",
+  "src/infra/command-explainer/index.ts!",
+  bundledPluginFile("telegram", "src/audit.ts", "!"),
+  bundledPluginFile("telegram", "src/token.ts", "!"),
+  "src/hooks/bundled/*/handler.ts!",
+  "src/hooks/llm-slug-generator.ts!",
+  "src/plugin-sdk/*.ts!",
+] as const;
+
+const bundledPluginEntries = [
+  "*.ts!",
+  "index.ts!",
+  "setup-entry.ts!",
+  "{api,contract-api,helper-api,runtime-api,light-runtime-api,update-offset-runtime-api,channel-plugin-api,provider-plugin-api,setup-api}.ts!",
+  "subagent-hooks-api.ts!",
+  "src/{api,runtime-api,light-runtime-api,update-offset-runtime-api,channel-plugin-api,provider-plugin-api,doctor-contract,setup-surface,mcp-serve}.ts!",
+  "src/subagent-hooks-api.ts!",
+] as const;
+
+const bundledPluginIgnoredRuntimeDependencies = [
+  "@agentclientprotocol/claude-agent-acp",
+  "@a2ui/lit",
+  "@azure/identity",
+  "@clawdbot/lobster",
+  "@discordjs/opus",
+  "@homebridge/ciao",
+  "@lit/context",
+  "@matrix-org/matrix-sdk-crypto-wasm",
+  "@mozilla/readability",
+  "@openai/codex",
+  "@pierre/theme",
+  "@tloncorp/tlon-skill",
+  "@zed-industries/codex-acp",
+  "jiti",
+  "json5",
+  "lit",
+  "linkedom",
+  "openclaw",
+  "clawpdf",
+] as const;
+
+const rootBundledPluginRuntimeDependencies = [
+  "@anthropic-ai/sdk",
+  "@anthropic-ai/vertex-sdk",
+  "@google/genai",
+  "@grammyjs/runner",
+  "@grammyjs/transformer-throttler",
+  "@homebridge/ciao",
+  "@mozilla/readability",
+  "@silvia-odwyer/photon-node",
+  "@slack/bolt",
+  "@slack/types",
+  "@slack/web-api",
+  "grammy",
+  "linkedom",
+  "minimatch",
+  "node-edge-tts",
+  "openshell",
+  "clawpdf",
+  "tokenjuice",
+] as const;
+
+const config = {
+  ignoreFiles: [
+    "scripts/**",
+    "packages/*/dist/**",
+    "**/__tests__/**",
+    "src/test-utils/**",
+    "**/test-helpers/**",
+    "**/test-fixtures/**",
+    "**/test-support/**",
+    "**/live-*.ts",
+    "**/test-*.ts",
+    "**/vitest*.{ts,mjs}",
+    "**/*test-helpers.ts",
+    "**/*test-fixtures.ts",
+    "**/*test-harness.ts",
+    "**/*test-utils.ts",
+    "**/*test-support.ts",
+    "**/*test-shared.ts",
+    "**/*mocks.ts",
+    "**/*.e2e-mocks.ts",
+    "**/*.e2e-*.ts",
+    "**/*.fixture-test-support.ts",
+    "**/*.harness.ts",
+    "**/*.job-fixtures.ts",
+    "**/*.mock-harness.ts",
+    "**/*.menu-test-support.ts",
+    "**/*.suite-helpers.ts",
+    "**/*.test-setup.ts",
+    "**/job-fixtures.ts",
+    "**/*test-mocks.ts",
+    "**/*test-runtime*.ts",
+    "**/*.mock-setup.ts",
+    "**/*.cases.ts",
+    "**/*.e2e-harness.ts",
+    "**/*.fixture.ts",
+    "**/*.fixtures.ts",
+    "**/*.mocks.ts",
+    "**/*.mocks.shared.ts",
+    "**/*.route-test-support.ts",
+    "**/*.shared-test.ts",
+    "**/*.suite.ts",
+    "**/*.test-runtime.ts",
+    "**/*.testkit.ts",
+    "**/*.test-fixtures.ts",
+    "**/*.test-harness.ts",
+    "**/*.test-helper.ts",
+    "**/*.test-helpers.ts",
+    "**/*.test-mocks.ts",
+    "**/*.test-utils.ts",
+    "test/helpers/live-image-probe.ts",
+    "src/secrets/credential-matrix.ts",
+    "src/shared/text/assistant-visible-text.ts",
+    bundledPluginFile("telegram", "src/bot/reply-threading.ts"),
+    bundledPluginFile("telegram", "src/draft-chunking.ts"),
+  ],
+  ignore: ["packages/*/dist/**"],
+  workspaces: {
+    ".": {
+      entry: rootEntries,
+      ignoreDependencies: [
+        "@openclaw/*",
+        // Docker packaging stages @openclaw/ai without nested dependencies after
+        // verifying the root owns its exact runtime dependency versions.
+        "@mistralai/mistralai",
+        "cross-spawn",
+        "file-type",
+        "playwright-core",
+        "partial-json",
+        "sqlite-vec",
+        "tree-sitter-bash",
+        ...rootBundledPluginRuntimeDependencies,
+      ],
+      project: [
+        "src/**/*.ts!",
+        "scripts/**/*.{js,mjs,cjs,ts,mts,cts}!",
+        "*.config.{js,mjs,cjs,ts,mts,cts}!",
+        "*.mjs!",
+      ],
+    },
+    ui: {
+      entry: [
+        "index.html!",
+        "src/main.ts!",
+        "src/lib/browser-redact.ts!",
+        "vite.config.ts!",
+        "vitest*.ts!",
+      ],
+      // Workboard lazy-loads Three.js at runtime; Knip's dependency pass misses it.
+      ignoreDependencies: ["three"],
+      project: ["src/**/*.{ts,tsx}!"],
+    },
+    "packages/ai": {
+      // Mirror the published export map so knip sees every dist entry point.
+      entry: [
+        "src/index.ts!",
+        "src/providers.ts!",
+        "src/types.ts!",
+        "src/validation.ts!",
+        "src/utils/diagnostics.ts!",
+        "src/utils/event-stream.ts!",
+        "src/internal/*.ts!",
+      ],
+      project: ["src/**/*.ts!"],
+    },
+    "packages/sdk": {
+      entry: ["src/index.ts!"],
+      project: ["src/**/*.ts!"],
+    },
+    "packages/agent-core": {
+      entry: ["src/index.ts!", "src/*.ts!", "src/harness/**/*.ts!"],
+      project: ["src/**/*.ts!"],
+    },
+    "packages/gateway-client": {
+      entry: ["src/index.ts!"],
+      project: ["src/**/*.ts!"],
+    },
+    "packages/gateway-protocol": {
+      entry: ["src/index.ts!", "src/schema.ts!"],
+      project: ["src/**/*.ts!"],
+    },
+    "packages/net-policy": {
+      entry: ["src/index.ts!", "src/ip.ts!"],
+      project: ["src/**/*.ts!"],
+    },
+    "packages/markdown-core": {
+      entry: ["src/*.ts!"],
+      project: ["src/**/*.ts!"],
+    },
+    "packages/media-core": {
+      entry: ["src/*.ts!"],
+      project: ["src/**/*.ts!"],
+    },
+    "packages/acp-core": {
+      entry: ["src/*.ts!"],
+      project: ["src/**/*.ts!"],
+    },
+    "packages/terminal-core": {
+      entry: ["src/*.ts!"],
+      project: ["src/**/*.ts!"],
+    },
+    "packages/speech-core": {
+      entry: ["api.ts!", "runtime-api.ts!", "speaker.ts!", "voice-models.ts!"],
+      project: ["**/*.ts!"],
+      ignoreDependencies: ["openclaw"],
+    },
+    "packages/*": {
+      entry: ["index.js!", "scripts/postinstall.js!"],
+      project: ["index.js!", "scripts/**/*.js!"],
+    },
+    [`${BUNDLED_PLUGIN_ROOT_DIR}/llama-cpp`]: {
+      entry: bundledPluginEntries,
+      project: ["index.ts!", "src/**/*.{js,mjs,ts}!"],
+      ignoreDependencies: [
+        // The provider resolves node-llama-cpp from its own package at runtime
+        // so local embeddings use the plugin-owned native dependency.
+        "node-llama-cpp",
+        ...bundledPluginIgnoredRuntimeDependencies,
+      ],
+    },
+    [`${BUNDLED_PLUGIN_ROOT_DIR}/*`]: {
+      // Bundled plugins often load their public surface via string specifiers in
+      // `index.ts` contracts, so Knip needs these convention-based entry files.
+      entry: bundledPluginEntries,
+      project: ["index.ts!", "src/**/*.{js,mjs,ts}!"],
+      ignoreDependencies: bundledPluginIgnoredRuntimeDependencies,
+    },
+  },
+} as const;
+
+export default config;

config/markdownlint-cli2.jsonc

@@ -0,0 +1,60 @@
+{
+  "globs": ["docs/**/*.md", "docs/**/*.mdx", "README.md"],
+  "ignores": ["docs/zh-CN/**", "docs/.i18n/**", "docs/reference/templates/**", "**/.local/**"],
+  "config": {
+    "default": true,
+
+    "MD013": false,
+    "MD025": false,
+    "MD029": false,
+
+    "MD033": {
+      "allowed_elements": [
+        "Note",
+        "Info",
+        "Tip",
+        "Warning",
+        "Card",
+        "CardGroup",
+        "Columns",
+        "Steps",
+        "Step",
+        "Tabs",
+        "Tab",
+        "Accordion",
+        "AccordionGroup",
+        "CodeGroup",
+        "Frame",
+        "Callout",
+        "ParamField",
+        "ResponseField",
+        "RequestExample",
+        "ResponseExample",
+        "img",
+        "a",
+        "br",
+        "table",
+        "tr",
+        "td",
+        "details",
+        "summary",
+        "p",
+        "div",
+        "strong",
+        "span",
+        "iframe",
+        "h2",
+        "h3",
+        "picture",
+        "source",
+        "Tooltip",
+        "Check",
+      ],
+    },
+
+    "MD036": false,
+    "MD040": false,
+    "MD041": false,
+    "MD046": false,
+  },
+}

config/shellcheckrc

@@ -0,0 +1,25 @@
+# ShellCheck configuration
+# https://www.shellcheck.net/wiki/
+
+# Disable common false positives and style suggestions
+
+# SC2034: Variable appears unused (often exported or used indirectly)
+disable=SC2034
+
+# SC2155: Declare and assign separately (common idiom, rarely causes issues)
+disable=SC2155
+
+# SC2295: Expansions inside ${..} need quoting (info-level, rarely causes issues)
+disable=SC2295
+
+# SC1012: \r is literal (tr -d '\r' works as intended on most systems)
+disable=SC1012
+
+# SC2026: Word outside quotes (info-level, often intentional)
+disable=SC2026
+
+# SC2016: Expressions don't expand in single quotes (often intentional in sed/awk)
+disable=SC2016
+
+# SC2129: Consider using { cmd1; cmd2; } >> file (style preference)
+disable=SC2129

config/swiftformat

@@ -0,0 +1,51 @@
+# SwiftFormat configuration adapted from Peekaboo defaults (Swift 6 friendly)
+
+--swiftversion 6.2
+
+# Self handling
+--self insert
+--selfrequired
+
+# Imports / extensions
+--importgrouping testable-bottom
+--extensionacl on-declarations
+
+# Indentation
+--indent 4
+--indentcase false
+--ifdef no-indent
+--xcodeindentation enabled
+
+# Line breaks
+--linebreaks lf
+--maxwidth 120
+
+# Whitespace
+--trimwhitespace always
+--emptybraces no-space
+--nospaceoperators ...,..<
+--ranges no-space
+--someAny true
+--voidtype void
+
+# Wrapping
+--wraparguments before-first
+--wrapparameters before-first
+--wrapcollections before-first
+--closingparen same-line
+
+# Organization
+--organizetypes class,struct,enum,extension
+--extensionmark "MARK: - %t + %p"
+--marktypes always
+--markextensions always
+--structthreshold 0
+--enumthreshold 0
+
+# Other
+--stripunusedargs closure-only
+--header ignore
+--allman false
+
+# Exclusions
+--exclude .build,.swiftpm,DerivedData,node_modules,dist,coverage,xcuserdata,Peekaboo,apps/swabble,apps/android,apps/ios,apps/shared

config/swiftlint.yml

@@ -0,0 +1,150 @@
+# SwiftLint configuration adapted from Peekaboo defaults (Swift 6 friendly)
+
+included:
+  - ../apps/macos/Sources
+
+excluded:
+  - ../.build
+  - ../DerivedData
+  - "**/.build"
+  - "**/.swiftpm"
+  - "**/DerivedData"
+  - "**/Generated"
+  - "**/Resources"
+  - "**/Package.swift"
+  - "**/Tests/Resources"
+  - ../node_modules
+  - ../dist
+  - ../coverage
+  - "*.playground"
+  # Generated (protocol-gen-swift.ts)
+  - ../apps/macos/Sources/OpenClawProtocol/GatewayModels.swift
+  # Generated (generate-host-env-security-policy-swift.mjs)
+  - ../apps/macos/Sources/OpenClaw/HostEnvSecurityPolicy.generated.swift
+
+analyzer_rules:
+  - unused_declaration
+  - unused_import
+
+opt_in_rules:
+  - array_init
+  - closure_spacing
+  - contains_over_first_not_nil
+  - empty_count
+  - empty_string
+  - explicit_init
+  - fallthrough
+  - fatal_error_message
+  - first_where
+  - joined_default_parameter
+  - last_where
+  - literal_expression_end_indentation
+  - multiline_arguments
+  - multiline_parameters
+  - operator_usage_whitespace
+  - overridden_super_call
+  - pattern_matching_keywords
+  - private_outlet
+  - prohibited_super_call
+  - redundant_nil_coalescing
+  - sorted_first_last
+  - switch_case_alignment
+  - unneeded_parentheses_in_closure_argument
+  - vertical_parameter_alignment_on_call
+
+disabled_rules:
+  # SwiftFormat handles these
+  - trailing_whitespace
+  - trailing_newline
+  - trailing_comma
+  - vertical_whitespace
+  - indentation_width
+
+  # Style exclusions
+  - explicit_self
+  - identifier_name
+  - file_header
+  - explicit_top_level_acl
+  - explicit_acl
+  - explicit_type_interface
+  - missing_docs
+  - required_deinit
+  - prefer_nimble
+  - quick_discouraged_call
+  - quick_discouraged_focused_test
+  - quick_discouraged_pending_test
+  - anonymous_argument_in_multiline_closure
+  - no_extension_access_modifier
+  - no_grouping_extension
+  - switch_case_on_newline
+  - strict_fileprivate
+  - extension_access_modifier
+  - convenience_type
+  - no_magic_numbers
+  - one_declaration_per_file
+  - vertical_whitespace_between_cases
+  - vertical_whitespace_closing_braces
+  - superfluous_else
+  - number_separator
+  - prefixed_toplevel_constant
+  - opening_brace
+  - trailing_closure
+  - contrasted_opening_brace
+  - sorted_imports
+  - redundant_type_annotation
+  - shorthand_optional_binding
+  - untyped_error_in_catch
+  - file_name
+  - todo
+
+force_cast: warning
+force_try: warning
+
+type_name:
+  min_length:
+    warning: 2
+    error: 1
+  max_length:
+    warning: 60
+    error: 80
+
+function_body_length:
+  warning: 150
+  error: 300
+
+function_parameter_count:
+  warning: 7
+  error: 10
+
+file_length:
+  warning: 1500
+  error: 2500
+  ignore_comment_only_lines: true
+
+type_body_length:
+  warning: 800
+  error: 1200
+
+cyclomatic_complexity:
+  warning: 20
+  error: 120
+
+large_tuple:
+  warning: 4
+  error: 5
+
+nesting:
+  type_level:
+    warning: 4
+    error: 6
+  function_level:
+    warning: 5
+    error: 7
+
+line_length:
+  warning: 120
+  error: 250
+  ignores_comments: true
+  ignores_urls: true
+
+reporter: "xcode"

config/tsconfig/oxlint.core.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.json",
+  "include": ["../../src/**/*", "../../ui/**/*", "../../packages/**/*"],
+  "exclude": ["../../node_modules", "../../dist", "../../dist-runtime"]
+}

config/tsconfig/oxlint.extensions.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.json",
+  "include": [
+    "../../src/**/*",
+    "../../ui/src/**/*",
+    "../../packages/**/*.ts",
+    "../../extensions/**/*"
+  ],
+  "exclude": ["../../node_modules", "../../dist", "../../dist-runtime"]
+}

config/tsconfig/oxlint.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.json",
+  "include": [
+    "../../src/**/*",
+    "../../ui/**/*",
+    "../../packages/**/*",
+    "../../extensions/**/*",
+    "../../scripts/**/*"
+  ],
+  "exclude": ["../../node_modules", "../../dist", "../../dist-runtime"]
+}

config/tsconfig/oxlint.scripts.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.json",
+  "include": ["../../src/**/*.d.ts", "../../packages/**/*.d.ts", "../../scripts/**/*"],
+  "exclude": ["../../node_modules", "../../dist", "../../dist-runtime"]
+}