clawmarketbot 0.1.2 → 0.1.3

package/README.md

@@ -1,12 +1,12 @@
 # clawmarketbot
 
-CLI for [ClawMarket](https://clawmarket.cc) — download and install OpenClaw agent configs directly from the marketplace or from npm.
+CLI for [ClawMarket](https://clawmarket.cc) — download and install OpenClaw agent configs directly from the marketplace.
 
 ## Requirements
 
 - Node.js 18+
 - OpenClaw installed and configured (`~/.openclaw/openclaw.json` must exist)
-- `unzip` or `tar` available in your PATH
+- `unzip` available in your PATH (macOS and most Linux distros include it)
 
 ## Install
 
@@ -16,55 +16,85 @@ npm install -g clawmarketbot
 
 ## Usage
 
-### Install a bot from an npm package
+### Install an agent from a download token
 
 ```bash
-clawmarketbot config install-npm @clawmarket/my-bot
+clawmarketbot config install <token>
 ```
 
-Optionally pin a version:
+Tokens are obtained from the ClawMarket download modal on the config detail page.
 
-```bash
-clawmarketbot config install-npm @clawmarket/my-bot@1.2.0
-```
+The command will:
 
-### Install a bot from a one-time download token
+1. Download the bot package from ClawMarket and verify its checksum
+2. Locate the `source/bot-config.json` manifest inside the zip
+3. Prompt you for an agent ID (a unique name for this instance)
+4. Resolve source → target install paths using the manifest
+5. Stage workspace and agent state into a temp directory
+6. Patch `openclaw.json` with the new agent entry (heartbeat, identity, tools.web)
+7. Prompt you to install any packaged cron jobs
+8. Atomically commit everything — workspace, agent state, memory DB, cron jobs, and config update — with full rollback on failure
+9. Prompt for any required API keys and save them to `openclaw.json` / `.env`
+10. Run an optional `installer.sh` post-hook if bundled in the package
+11. Validate required workspace files and directories
+12. Print a summary
+
+### Download a config artifact to disk (without installing)
 
 ```bash
-clawmarketbot config install <token>
+clawmarketbot config download <token>
 ```
 
-Tokens are obtained from the ClawMarket download modal.
+Saves the raw zip file to the current directory.
 
-### Download a config artifact to disk
+### Authentication
 
 ```bash
-clawmarketbot config download <token>
+clawmarketbot auth login     # save a ClawMarket API key
+clawmarketbot auth status    # check current login status
+clawmarketbot auth logout    # clear saved credentials
 ```
 
-### Auth
+You can also pass the API key via stdin (recommended for automation):
 
 ```bash
-clawmarketbot auth login    # save an API key
-clawmarketbot auth status   # check current auth
-clawmarketbot auth logout   # clear credentials
+echo "$MY_API_KEY" | clawmarketbot auth login --stdin
 ```
 
 ## Environment Variables
 
 | Variable | Default | Purpose |
 |---|---|---|
-| `CLAWMARKET_API_URL` | `https://api.clawmarket.cc` | ClawMarket backend URL |
-| `OPENCLAW_HOME` | `os.homedir()` | OpenClaw home directory |
-| `OPENCLAW_STATE_DIR` | `~/.openclaw` | OpenClaw state directory |
-| `OPENCLAW_CONFIG_PATH` | `~/.openclaw/openclaw.json` | OpenClaw config file |
+| `CLAWMARKET_API_URL` | *(required)* | ClawMarket backend base URL — set this to your ClawMarket instance |
+| `OPENCLAW_HOME` | `os.homedir()` | Override the home directory used for tilde expansion |
+| `OPENCLAW_STATE_DIR` | `~/.openclaw` | Override the OpenClaw state directory |
+| `OPENCLAW_CONFIG_PATH` | `~/.openclaw/openclaw.json` | Override the OpenClaw config file path |
 
-## How npm-based install works
+Example:
 
-When you run `clawmarketbot config install-npm @clawmarket/some-bot`:
+```bash
+export CLAWMARKET_API_URL=https://api.clawmarket.cc
+clawmarketbot config install <token>
+```
+
+## What gets installed
+
+When you run `config install`, the CLI installs:
+
+| What | Where |
+|---|---|
+| Agent workspace | `~/.openclaw/workspace-<agent-id>/` |
+| Agent state dir | `~/.openclaw/agents/<agent-id>/` |
+| Memory database (SQLite) | `~/.openclaw/memory/<agent-id>.sqlite` *(if bundled)* |
+| Cron jobs | `~/.openclaw/cron/jobs.json` *(merged, not overwritten)* |
+| Agent registration | `~/.openclaw/openclaw.json` *(appended to agents.list)* |
+| API keys | `~/.openclaw/openclaw.json` and/or `~/.openclaw/.env` |
 
-1. Package metadata is fetched from the npm registry
-2. The tarball is downloaded and its integrity verified
-3. A `bot.zip` bundled inside the package is extracted
-4. The bot's `installer.sh` is run, registering the agent in your OpenClaw config
-5. All temp files are cleaned up automatically
+All install paths are declared inside the package's `bot-config.json` manifest and may use `{agent_id}` template substitution.
+
+## After installing
+
+```bash
+openclaw agents list      # confirm the new agent appears
+openclaw gateway restart  # pick up the new config
+```

package/dist/index.js

@@ -1199,7 +1199,7 @@ function registerConfigCommands(program2) {
 
 // src/index.ts
 var program = new Command();
-program.name("clawmarketbot").description("CLI tool for ClawMarket - discover, download, and install OpenClaw configs").version("0.1.0");
+program.name("clawmarketbot").description("CLI tool for ClawMarket - discover, download, and install OpenClaw configs").version("0.1.3");
 registerAuthCommands(program);
 registerConfigCommands(program);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawmarketbot",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "private": false,
   "description": "CLI tool for ClawMarket - discover, download, and install OpenClaw configs",
   "type": "module",