nextclaw 0.19.7 → 0.19.12

package/dist/cli/app/index.js

@@ -3646,7 +3646,7 @@ registerHostServiceControls({
 	nextclaw: runtime
 });
 program.command("agent").description("Interact with the agent directly").option("-m, --message <message>", "Message to send to the agent").option("-s, --session <session>", "Session ID", "cli:default").option("--model <model>", "Session model override for this run").option("--no-markdown", "Disable Markdown rendering").action(async (opts) => runtime.agent(opts));
-program.command("update").description(`Check, download, or apply ${APP_NAME} runtime updates`).option("--check", "Only check for a runtime update", false).option("--download", "Download an available runtime update without applying it").option("--apply", "Apply the downloaded runtime update", false).option("--channel <channel>", "Update channel (stable or beta)").option("--manifest-url <url>", "Explicit runtime update manifest URL").option("--json", "Output JSON", false).action(async (opts) => runtime.update(opts));
+program.command("update").description(`Update the ${APP_NAME} runtime`).option("--check", "Only check for a runtime update", false).option("--download-only", "Download an available runtime update without applying it", false).option("--download", "Alias for --download-only").option("--apply", "Apply the downloaded runtime update", false).option("--channel <channel>", "Update channel (stable or beta)").option("--manifest-url <url>", "Explicit runtime update manifest URL").option("--json", "Output JSON", false).action(async (opts) => runtime.update(opts));
 registerSkillsCommands(program, runtime);
 registerAgentsCommands(program, runtime);
 const plugins = program.command("plugins").description("Manage OpenClaw-compatible plugins");
@@ -3676,6 +3676,7 @@ secrets.command("apply").description("Apply secret refs/providers/defaults patch
 secrets.command("reload").description("Trigger runtime secrets reload signal").option("--json", "Output JSON", false).action((opts) => runtime.commands.secrets.reload(opts));
 const channels = program.command("channels").description("Manage channels");
 channels.command("add").description("Configure a plugin channel (OpenClaw-compatible setup)").requiredOption("--channel <id>", "Plugin channel id").option("--code <code>", "Pairing code").option("--token <token>", "Connector token").option("--name <name>", "Display name").option("--url <url>", "API base URL").option("--http-url <url>", "Alias for --url").action((opts) => runtime.commands.channels.add(opts));
+channels.command("list").description("List configured plugin channels").option("--json", "Output JSON", false).action((opts) => runtime.commands.channels.list(opts));
 channels.command("status").description("Show channel status").action(() => runtime.commands.channels.status());
 channels.command("login").description("Link device via QR code").option("--channel <id>", "Plugin channel id").option("--account <id>", "Channel account id").option("--url <url>", "Channel API base URL").option("--http-url <url>", "Alias for --url").option("-v, --verbose", "Verbose output", false).action(async (opts) => runtime.commands.channels.login(opts));
 const cron = program.command("cron").description("Manage scheduled tasks");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.19.7",
+  "version": "0.19.12",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",
@@ -41,21 +41,21 @@
     "commander": "^12.1.0",
     "jszip": "^3.10.1",
     "yaml": "^2.8.1",
-    "@nextclaw/core": "0.12.17",
     "@nextclaw/kernel": "0.1.6",
     "@nextclaw/mcp": "0.1.82",
+    "@nextclaw/ncp-agent-runtime": "0.3.20",
     "@nextclaw/ncp-mcp": "0.1.84",
+    "@nextclaw/core": "0.12.17",
     "@nextclaw/ncp": "0.5.10",
-    "@nextclaw/ncp-agent-runtime": "0.3.20",
-    "@nextclaw/ncp-toolkit": "0.5.15",
     "@nextclaw/nextclaw-hermes-acp-bridge": "0.1.9",
-    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.9",
-    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.10",
     "@nextclaw/openclaw-compat": "1.0.17",
+    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.1.9",
+    "@nextclaw/ncp-toolkit": "0.5.15",
     "@nextclaw/remote": "0.1.94",
+    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.1.10",
     "@nextclaw/runtime": "0.2.49",
-    "@nextclaw/server": "0.12.17",
-    "@nextclaw/service": "0.1.8"
+    "@nextclaw/service": "0.1.9",
+    "@nextclaw/server": "0.12.17"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",

package/resources/USAGE.md

@@ -505,6 +505,7 @@ Skill loading contract:
 | `nextclaw plugins enable <id>` | Enable plugin in config |
 | `nextclaw plugins disable <id>` | Disable plugin in config |
 | `nextclaw plugins doctor` | Diagnose plugin loading issues |
+| `nextclaw channels list --json` | List plugin channels for automation and agent channel discovery |
 | `nextclaw channels status` | Show enabled channels and status |
 | `nextclaw doctor` | Run runtime diagnostics (`--json`, `--verbose`, `--fix`) |
 | `nextclaw channels login` | Open QR login for supported channels |
@@ -689,9 +690,10 @@ nextclaw update
 Behavior:
 
 - If `NEXTCLAW_UPDATE_COMMAND` is set, the CLI executes it (useful for custom update flows).
-- Otherwise it falls back to `npm i -g nextclaw`.
-- `nextclaw update` now prints version progress explicitly: `Current version: x.y.z`, then either `Version updated: x.y.z -> a.b.c` or `Version unchanged: x.y.z`.
-- If the background service is running, restart it after the update to apply changes.
+- Otherwise `nextclaw update` checks the runtime update channel, downloads the latest compatible runtime bundle, and applies it.
+- Use `nextclaw update --check` to check without downloading or applying.
+- Use `nextclaw update --download-only` to stage an update without switching the active runtime. `nextclaw update --apply` applies an already staged runtime update.
+- If the background service is running, restart it after `nextclaw update` reports that the runtime update was applied.
 - When update is triggered from the running gateway (agent `update.run`), NextClaw arms a self-relaunch helper before exiting, so the service comes back automatically (like an OS reboot flow).
 - After restart, NextClaw automatically pings the last active session with restart/update status (including note when provided).
 
@@ -708,6 +710,8 @@ All message channels use a common **allowFrom** rule:
 
 Configure channels in the UI at http://127.0.0.1:55667 or in `~/.nextclaw/config.json` under `channels`.
 
+Use `nextclaw channels list --json` when an automation or AI agent needs the exact runtime channel ids and outbound capabilities before calling messaging tools. Treat returned `channels[].id` values as authoritative; do not guess aliases such as `wechat` for the Weixin channel.
+
 ### Discord
 
 1. Create a bot in the [Discord Developer Portal](https://discord.com/developers/applications) and get the bot token.