@metaharness/openclaw 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rUv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# MetaHarness × OpenClaw .openclaw/ config
+
+A minimal MetaHarness scaffold pre-wired for [OpenClaw](https://github.com/openclaw), the open-source AI coding host that reads its configuration from a `.openclaw/` directory. Run one command and you get a working harness folder with the right config file layout, a starter agent, and the doctor/validate tooling that ships with MetaHarness. This is for developers who want to bootstrap an OpenClaw-compatible project without copy-pasting a config tree from another repo. It does NOT install OpenClaw itself, ship a model, or run any agent for you — it scaffolds the static files you need so `openclaw` (or any OpenClaw-compatible runner) finds a valid configuration on first launch.
+
+## Quickstart
+
+```bash
+npx @metaharness/openclaw@latest my-bot
+cd my-bot
+npm install
+harness doctor
+```
+
+`harness doctor` walks the generated tree, confirms the `.openclaw/` config is present and parseable, and reports anything missing before you point a runtime at it.
+
+## What you get
+
+- `.openclaw/config.json` — the host-specific manifest OpenClaw looks for on startup
+- `.openclaw/agents/` — one starter agent definition you can rename, duplicate, or delete
+- `harness.config.mjs` — the MetaHarness root config that ties templates, hosts, and validators together
+- `package.json` — pinned `harness` CLI plus `doctor`, `validate`, and `dev` scripts
+- `README.md` — a short orientation for whoever opens the repo next
+- `.gitignore` — sensible defaults so you don't commit `node_modules/` or local secret files
+
+## Advanced
+
+Run the built-in diagnostics:
+
+```bash
+harness doctor
+# ✓ .openclaw/config.json found
+# ✓ 1 agent definition discovered
+# ✓ harness.config.mjs parses
+# ✓ host=openclaw template=minimal
+```
+
+Validate the config schema without running anything:
+
+```bash
+harness validate
+# .openclaw/config.json   ok
+# .openclaw/agents/*.json  ok
+# 0 errors, 0 warnings
+```
+
+Point another tool at the same folder (any Claude-compatible CLI works):
+
+```bash
+claude -p --plugin-dir ./my-bot "list the agents in this project"
+```
+
+Re-scaffold in place after editing the template (overwrites the harness skeleton, leaves your agents alone):
+
+```bash
+npx metaharness@latest my-bot --template minimal --host openclaw --force
+```
+
+## FAQ
+
+**Q: Does this install OpenClaw?**
+A: No. It only writes the `.openclaw/` configuration tree that an OpenClaw runtime expects to find. Install OpenClaw separately following its own docs.
+
+**Q: Can I use this with Claude Code, Codex, or another host?**
+A: This scaffold is specifically wired for the OpenClaw host config layout. For other hosts, run `npx metaharness@latest my-bot --host <name>` directly, or use one of the sibling `@metaharness/*` example packages.
+
+**Q: How do I add a second agent?**
+A: Copy `.openclaw/agents/<starter>.json`, rename it, edit the `name` and `prompt` fields, then run `harness validate` to confirm the schema still passes.
+
+## License
+
+MIT. Built on metaharness (https://www.npmjs.com/package/metaharness).
+
+## Deep-dive
+
+Full explainer gist: https://gist.github.com/ruvnet/d88608ce148db9ca410243d35997d38a

package/bin/scaffold.mjs

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { execSync } from 'node:child_process';
+import process from 'node:process';
+
+const args = process.argv.slice(2);
+const name = args[0] && !args[0].startsWith('-') ? args[0] : 'my-bot';
+const extra = (args[0] && !args[0].startsWith('-') ? args.slice(1) : args)
+  .map((a) => JSON.stringify(a))
+  .join(' ');
+
+const cmd = `npx --yes metaharness@latest ${JSON.stringify(name)} --template minimal --host openclaw --force${extra ? ' ' + extra : ''}`;
+
+try {
+  execSync(cmd, { stdio: 'inherit' });
+} catch (err) {
+  console.error(`\nmetaharness failed: ${err && err.message ? err.message : err}`);
+  process.exit(typeof err?.status === 'number' ? err.status : 1);
+}
+
+console.log('');
+console.log(`Next steps:`);
+console.log(`  1. cd ${name}`);
+console.log(`  2. npm install`);
+console.log(`  3. harness doctor   # verify the .openclaw/ config`);

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@metaharness/openclaw",
+  "version": "0.1.0",
+  "description": "MetaHarness example — minimal scaffold wired to OpenClaw's .openclaw/ config (npx @metaharness/openclaw my-bot)",
+  "homepage": "https://github.com/ruvnet/agent-harness-generator/tree/main/examples-packages/openclaw",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ruvnet/agent-harness-generator.git",
+    "directory": "examples-packages/openclaw"
+  },
+  "license": "MIT",
+  "author": "rUv <ruv@ruv.net>",
+  "type": "module",
+  "bin": "./bin/scaffold.mjs",
+  "files": [
+    "bin/**",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "smoke": "node --check bin/scaffold.mjs"
+  },
+  "keywords": [
+    "metaharness",
+    "agent-harness",
+    "agent-harness-generator",
+    "openclaw",
+    "host",
+    "ai-agent",
+    "mcp",
+    "npx",
+    "scaffold"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}