nextclaw 0.45.4 → 0.46.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/app/index.js +2 -2
- package/dist/cli/launcher/index.js +10 -4
- package/dist/cli/launcher/index.js.map +1 -1
- package/dist/distribution-BAU3XUQJ.js +2 -0
- package/dist/{nextclaw-distribution.utils-Dryg4WzA.js → distribution-CND3AWXk.js} +3 -1
- package/dist/distribution-CND3AWXk.js.map +1 -0
- package/dist/{nextclaw-cli-app-Bwa2L2Jv.js → nextclaw-cli-app-BVdP2e0w.js} +535 -74
- package/dist/nextclaw-cli-app-BVdP2e0w.js.map +1 -0
- package/package.json +13 -13
- package/resources/USAGE.md +118 -113
- package/ui-dist/assets/{api-DU3C4HfX.js → api-aEu9cEI8.js} +1 -1
- package/ui-dist/assets/api-aEu9cEI8.js.gz +0 -0
- package/ui-dist/assets/{appearance-settings-page-Bh_65RFw.js → appearance-settings-page-z4DaHc_E.js} +1 -1
- package/ui-dist/assets/appearance-settings-page-z4DaHc_E.js.gz +0 -0
- package/ui-dist/assets/{book-open-DMnwJfVM.js → book-open-DYRapW_h.js} +1 -1
- package/ui-dist/assets/{channels-list-page-Bd3_YlyV.js → channels-list-page-x07sGqsT.js} +1 -1
- package/ui-dist/assets/channels-list-page-x07sGqsT.js.gz +0 -0
- package/ui-dist/assets/{config-split-page-DON62DcK.js → config-split-page-DJDp86Ne.js} +1 -1
- package/ui-dist/assets/config-split-page-DJDp86Ne.js.gz +0 -0
- package/ui-dist/assets/{confirm-dialog-B539oJpr.js → confirm-dialog-BALTnP33.js} +1 -1
- package/ui-dist/assets/confirm-dialog-BALTnP33.js.gz +0 -0
- package/ui-dist/assets/{createLucideIcon-CLfqNlvk.js → createLucideIcon-CgM0rnsa.js} +1 -1
- package/ui-dist/assets/{desktop-capabilities-page-CQxp8NvQ.js → desktop-capabilities-page-4-v3wKLV.js} +1 -1
- package/ui-dist/assets/desktop-capabilities-page-4-v3wKLV.js.gz +0 -0
- package/ui-dist/assets/{desktop-update-config-DsyKUJbp.js → desktop-update-config-Cl-_XHqU.js} +1 -1
- package/ui-dist/assets/desktop-update-config-Cl-_XHqU.js.gz +0 -0
- package/ui-dist/assets/{dist-GWWehc4w.js → dist-BjYvUhPL.js} +1 -1
- package/ui-dist/assets/dist-BjYvUhPL.js.gz +0 -0
- package/ui-dist/assets/{dist-WPei0-v8.js → dist-N9zc5bkM.js} +1 -1
- package/ui-dist/assets/dist-N9zc5bkM.js.gz +0 -0
- package/ui-dist/assets/{doc-browser-CKpps-rb.js → doc-browser-DwRLokCI.js} +1 -1
- package/ui-dist/assets/doc-browser-DwRLokCI.js.gz +0 -0
- package/ui-dist/assets/doc-browser-JlXVLNRe.js +1 -0
- package/ui-dist/assets/{doc-browser-context-Vx418ptC.js → doc-browser-context-BDuypObS.js} +1 -1
- package/ui-dist/assets/doc-browser-context-BDuypObS.js.gz +0 -0
- package/ui-dist/assets/{extensions-C_FUBhUf.js → extensions-DFQXmSwG.js} +1 -1
- package/ui-dist/assets/extensions-DFQXmSwG.js.gz +0 -0
- package/ui-dist/assets/{form-actions-DJlfyLEH.js → form-actions-CzGmrPAv.js} +1 -1
- package/ui-dist/assets/{index-C83VUh83.js → index-zuqzAvNx.js} +6 -6
- package/ui-dist/assets/index-zuqzAvNx.js.gz +0 -0
- package/ui-dist/assets/loader-circle-D9etMT9f.js +1 -0
- package/ui-dist/assets/{mcp-marketplace-page-CEr3FgVp.js → mcp-marketplace-page-COUopIOc.js} +1 -1
- package/ui-dist/assets/mcp-marketplace-page-COUopIOc.js.gz +0 -0
- package/ui-dist/assets/mcp-marketplace-page-DxPPmYqh.js +1 -0
- package/ui-dist/assets/{model-config-page-B_w0J2p1.js → model-config-page-g9_-hZqZ.js} +1 -1
- package/ui-dist/assets/model-config-page-g9_-hZqZ.js.gz +0 -0
- package/ui-dist/assets/{navigation-link-DI0mOIVl.js → navigation-link-Ci4Z7Phi.js} +1 -1
- package/ui-dist/assets/navigation-link-Ci4Z7Phi.js.gz +0 -0
- package/ui-dist/assets/plus-DKGD04AO.js +1 -0
- package/ui-dist/assets/{privacy-settings-page-D3RzjGyz.js → privacy-settings-page-pNhQQT4r.js} +1 -1
- package/ui-dist/assets/privacy-settings-page-pNhQQT4r.js.gz +0 -0
- package/ui-dist/assets/{providers-config-page-ONfW4tjw.js → providers-config-page-DftW_6KU.js} +1 -1
- package/ui-dist/assets/providers-config-page-DftW_6KU.js.gz +0 -0
- package/ui-dist/assets/{react-BwGMzqXA.js → react-CVFx225w.js} +1 -1
- package/ui-dist/assets/{react-BwGMzqXA.js.gz → react-CVFx225w.js.gz} +0 -0
- package/ui-dist/assets/{refresh-cw-DmR6-f9A.js → refresh-cw-C-3_thgr.js} +1 -1
- package/ui-dist/assets/remote-DS2TkMPm.js +1 -0
- package/ui-dist/assets/{rotate-cw-BUWqEgob.js → rotate-cw-DSFTq_yu.js} +1 -1
- package/ui-dist/assets/{runtime-config-page-CdwKIwZc.js → runtime-config-page-Cd9sOYvn.js} +1 -1
- package/ui-dist/assets/runtime-config-page-Cd9sOYvn.js.gz +0 -0
- package/ui-dist/assets/{save-DdohrEEJ.js → save-CpPr78_S.js} +1 -1
- package/ui-dist/assets/{search-config-page-C0YgfpcA.js → search-config-page-BqoDbKpM.js} +1 -1
- package/ui-dist/assets/search-config-page-BqoDbKpM.js.gz +0 -0
- package/ui-dist/assets/{search-BVeIVVGT.js → search-msqk2-rd.js} +1 -1
- package/ui-dist/assets/{secrets-config-page-Bb28CTv4.js → secrets-config-page-GsahsEVw.js} +1 -1
- package/ui-dist/assets/secrets-config-page-GsahsEVw.js.gz +0 -0
- package/ui-dist/assets/security-config-BnHQyrtG.js +1 -0
- package/ui-dist/assets/{select-DvuHOwPH.js → select-DPKCWajZ.js} +1 -1
- package/ui-dist/assets/select-DPKCWajZ.js.gz +0 -0
- package/ui-dist/assets/skeleton-BsR5rwB7.js +1 -0
- package/ui-dist/assets/{tag-chip-BI9NffVf.js → tag-chip-ClBWeQ4p.js} +1 -1
- package/ui-dist/assets/x-Dp5GAFmP.js +1 -0
- package/ui-dist/index.html +20 -20
- package/ui-dist/index.html.gz +0 -0
- package/dist/nextclaw-cli-app-Bwa2L2Jv.js.map +0 -1
- package/dist/nextclaw-distribution.utils-Dryg4WzA.js.map +0 -1
- package/ui-dist/assets/api-DU3C4HfX.js.gz +0 -0
- package/ui-dist/assets/appearance-settings-page-Bh_65RFw.js.gz +0 -0
- package/ui-dist/assets/channels-list-page-Bd3_YlyV.js.gz +0 -0
- package/ui-dist/assets/config-split-page-DON62DcK.js.gz +0 -0
- package/ui-dist/assets/confirm-dialog-B539oJpr.js.gz +0 -0
- package/ui-dist/assets/desktop-capabilities-page-CQxp8NvQ.js.gz +0 -0
- package/ui-dist/assets/desktop-update-config-DsyKUJbp.js.gz +0 -0
- package/ui-dist/assets/dist-GWWehc4w.js.gz +0 -0
- package/ui-dist/assets/dist-WPei0-v8.js.gz +0 -0
- package/ui-dist/assets/doc-browser-CKpps-rb.js.gz +0 -0
- package/ui-dist/assets/doc-browser-context-Vx418ptC.js.gz +0 -0
- package/ui-dist/assets/doc-browser-y3e2_MXe.js +0 -1
- package/ui-dist/assets/extensions-C_FUBhUf.js.gz +0 -0
- package/ui-dist/assets/index-C83VUh83.js.gz +0 -0
- package/ui-dist/assets/loader-circle-DXH2fVRq.js +0 -1
- package/ui-dist/assets/mcp-marketplace-page-CEr3FgVp.js.gz +0 -0
- package/ui-dist/assets/mcp-marketplace-page-Dj0xiFAV.js +0 -1
- package/ui-dist/assets/model-config-page-B_w0J2p1.js.gz +0 -0
- package/ui-dist/assets/navigation-link-DI0mOIVl.js.gz +0 -0
- package/ui-dist/assets/plus-C6Kx4b6T.js +0 -1
- package/ui-dist/assets/privacy-settings-page-D3RzjGyz.js.gz +0 -0
- package/ui-dist/assets/providers-config-page-ONfW4tjw.js.gz +0 -0
- package/ui-dist/assets/remote-DRh0aAHG.js +0 -1
- package/ui-dist/assets/runtime-config-page-CdwKIwZc.js.gz +0 -0
- package/ui-dist/assets/search-config-page-C0YgfpcA.js.gz +0 -0
- package/ui-dist/assets/secrets-config-page-Bb28CTv4.js.gz +0 -0
- package/ui-dist/assets/security-config-CNdun2s-.js +0 -1
- package/ui-dist/assets/select-DvuHOwPH.js.gz +0 -0
- package/ui-dist/assets/skeleton-u2lc3JJg.js +0 -1
- package/ui-dist/assets/x-27QFIvUt.js +0 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nextclaw",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.46.0",
|
|
4
4
|
"description": "Powerful AI assistant for coordinating agents, skills, CLI tools, automations, and messaging apps.",
|
|
5
5
|
"private": false,
|
|
6
6
|
"type": "module",
|
|
@@ -44,22 +44,22 @@
|
|
|
44
44
|
"commander": "^12.1.0",
|
|
45
45
|
"jszip": "^3.10.1",
|
|
46
46
|
"yaml": "^2.8.1",
|
|
47
|
-
"@nextclaw/app-runtime": "0.
|
|
48
|
-
"@nextclaw/
|
|
49
|
-
"@nextclaw/
|
|
50
|
-
"@nextclaw/mcp": "0.3.40",
|
|
51
|
-
"@nextclaw/ncp-agent-runtime": "0.4.21",
|
|
47
|
+
"@nextclaw/app-runtime": "0.15.0",
|
|
48
|
+
"@nextclaw/core": "0.17.14",
|
|
49
|
+
"@nextclaw/kernel": "0.13.0",
|
|
52
50
|
"@nextclaw/ncp": "0.10.0",
|
|
53
|
-
"@nextclaw/
|
|
51
|
+
"@nextclaw/mcp": "0.3.41",
|
|
52
|
+
"@nextclaw/ncp-agent-runtime": "0.4.21",
|
|
53
|
+
"@nextclaw/ncp-mcp": "0.2.41",
|
|
54
54
|
"@nextclaw/ncp-toolkit": "0.6.23",
|
|
55
55
|
"@nextclaw/nextclaw-hermes-acp-bridge": "0.3.21",
|
|
56
56
|
"@nextclaw/nextclaw-ncp-runtime-http-client": "0.3.22",
|
|
57
|
-
"@nextclaw/runtime": "0.
|
|
58
|
-
"@nextclaw/
|
|
59
|
-
"@nextclaw/
|
|
60
|
-
"@nextclaw/
|
|
57
|
+
"@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.3.41",
|
|
58
|
+
"@nextclaw/service": "0.4.6",
|
|
59
|
+
"@nextclaw/runtime": "0.4.40",
|
|
60
|
+
"@nextclaw/remote": "0.3.52",
|
|
61
61
|
"@nextclaw/shared": "0.4.30",
|
|
62
|
-
"@nextclaw/
|
|
62
|
+
"@nextclaw/server": "0.20.5"
|
|
63
63
|
},
|
|
64
64
|
"devDependencies": {
|
|
65
65
|
"@types/node": "^20.17.6",
|
|
@@ -67,7 +67,7 @@
|
|
|
67
67
|
"tsx": "^4.19.2",
|
|
68
68
|
"typescript": "^5.6.3",
|
|
69
69
|
"vitest": "^4.1.2",
|
|
70
|
-
"@nextclaw/ui": "0.22.
|
|
70
|
+
"@nextclaw/ui": "0.22.5"
|
|
71
71
|
},
|
|
72
72
|
"scripts": {
|
|
73
73
|
"dev": "tsx watch --tsconfig ../../scripts/dev/dev-runtime.tsconfig.json src/cli/app/index.ts",
|
package/resources/USAGE.md
CHANGED
|
@@ -518,16 +518,16 @@ Use `nextclaw init --force` to overwrite existing template files.
|
|
|
518
518
|
|
|
519
519
|
Created under the workspace:
|
|
520
520
|
|
|
521
|
-
| File / folder
|
|
522
|
-
|
|
523
|
-
| `AGENTS.md`
|
|
524
|
-
| `SOUL.md`
|
|
525
|
-
| `USER.md`
|
|
526
|
-
| `IDENTITY.md`
|
|
527
|
-
| `TOOLS.md`
|
|
528
|
-
| `BOOT.md` / `BOOTSTRAP.md` | Boot context
|
|
529
|
-
| `memory/MEMORY.md`
|
|
530
|
-
| `skills/`
|
|
521
|
+
| File / folder | Purpose |
|
|
522
|
+
| -------------------------- | --------------------------------- |
|
|
523
|
+
| `AGENTS.md` | System instructions for the agent |
|
|
524
|
+
| `SOUL.md` | Personality and values |
|
|
525
|
+
| `USER.md` | User profile hints |
|
|
526
|
+
| `IDENTITY.md` | Identity context |
|
|
527
|
+
| `TOOLS.md` | Tool usage guidelines |
|
|
528
|
+
| `BOOT.md` / `BOOTSTRAP.md` | Boot context |
|
|
529
|
+
| `memory/MEMORY.md` | Long-term notes |
|
|
530
|
+
| `skills/` | Custom skills |
|
|
531
531
|
|
|
532
532
|
NextClaw's AI self-management guide is built into the app package and is not written into each workspace anymore.
|
|
533
533
|
|
|
@@ -595,7 +595,7 @@ nextclaw app enable nextclaw.personal-organizer --json
|
|
|
595
595
|
|
|
596
596
|
Install, update, rollback, and uninstall return a background operation receipt. Check `nextclaw app operations --json` or the Apps page for progress. Schema v2 Apps remain disabled after installation until explicitly enabled.
|
|
597
597
|
|
|
598
|
-
Personal submissions return `publishStatus: pending` and appear in the public App Marketplace only after approval with `catalogVisibility: listed`. Community Panel-only Apps follow normal review. Schema v2 Service components
|
|
598
|
+
Personal submissions return `publishStatus: pending` and appear in the public App Marketplace only after approval with `catalogVisibility: listed`. Community Panel-only Apps follow normal review. Schema v2 native-process Service components launch host processes with the user's permissions, so they enter high-privilege manual review. Rust/WASI Service components declare `runtime.profile: wasi` and run through the host-mediated Portable Runtime; use the generated WIT contract and capability declarations rather than treating a profile change as automatic sandboxing. An administrator may approve Apps as `listed` or `unlisted`. Installed schema v2 Apps remain disabled until the user explicitly enables them. Pending or rejected submissions can be corrected and submitted again. Updating an already published personal app is intentionally blocked until version-level review is available, so the current public version remains online.
|
|
599
599
|
|
|
600
600
|
Use `https://platform.nextclaw.io/apps` to review submission status. The built-in `nextclaw-app-publisher` skill lets NextClaw AI assemble a package from existing Panel/Service directories, run the checks, guide login, and submit it with the same native commands.
|
|
601
601
|
|
|
@@ -654,104 +654,108 @@ nextclaw app uninstall <app-id> --purge-data --confirm <app-id>
|
|
|
654
654
|
Service App development gets a separate, deterministic development instance. Resetting it is destructive and therefore requires both the reset flag and an exact manifest id confirmation:
|
|
655
655
|
|
|
656
656
|
```bash
|
|
657
|
-
nextclaw app dev <
|
|
657
|
+
nextclaw app dev <app-dir> --reset-data --confirm <app-id> --json
|
|
658
658
|
```
|
|
659
659
|
|
|
660
660
|
---
|
|
661
661
|
|
|
662
662
|
## Commands
|
|
663
663
|
|
|
664
|
-
| Command
|
|
665
|
-
|
|
666
|
-
| `nextclaw start`
|
|
667
|
-
| `nextclaw restart`
|
|
668
|
-
| `nextclaw stop`
|
|
669
|
-
| `nextclaw app
|
|
670
|
-
| `nextclaw app
|
|
671
|
-
| `nextclaw app
|
|
672
|
-
| `nextclaw app
|
|
673
|
-
| `nextclaw app
|
|
674
|
-
| `nextclaw app
|
|
675
|
-
| `nextclaw app
|
|
676
|
-
| `nextclaw app
|
|
677
|
-
| `nextclaw app
|
|
678
|
-
| `nextclaw app
|
|
679
|
-
| `nextclaw app
|
|
680
|
-
| `nextclaw app
|
|
681
|
-
| `nextclaw app
|
|
682
|
-
| `nextclaw app
|
|
683
|
-
| `nextclaw app
|
|
684
|
-
| `nextclaw app
|
|
685
|
-
| `nextclaw app
|
|
686
|
-
| `nextclaw app
|
|
687
|
-
| `nextclaw app
|
|
688
|
-
| `nextclaw app
|
|
689
|
-
| `nextclaw app
|
|
690
|
-
| `nextclaw
|
|
691
|
-
| `
|
|
692
|
-
| `nextclaw
|
|
693
|
-
| `
|
|
694
|
-
| `nextclaw service install-
|
|
695
|
-
| `nextclaw service
|
|
696
|
-
| `nextclaw service
|
|
697
|
-
| `nextclaw service uninstall-
|
|
698
|
-
| `nextclaw service
|
|
699
|
-
| `nextclaw service
|
|
700
|
-
| `nextclaw
|
|
701
|
-
| `nextclaw
|
|
702
|
-
| `nextclaw
|
|
703
|
-
| `nextclaw
|
|
704
|
-
| `nextclaw
|
|
705
|
-
| `nextclaw
|
|
706
|
-
| `nextclaw
|
|
707
|
-
| `nextclaw
|
|
708
|
-
| `nextclaw
|
|
709
|
-
| `nextclaw
|
|
710
|
-
| `nextclaw
|
|
711
|
-
| `nextclaw
|
|
712
|
-
| `nextclaw
|
|
713
|
-
| `nextclaw
|
|
714
|
-
| `nextclaw
|
|
715
|
-
| `nextclaw
|
|
716
|
-
| `nextclaw agents
|
|
717
|
-
| `nextclaw agents
|
|
718
|
-
| `nextclaw
|
|
719
|
-
| `nextclaw
|
|
720
|
-
| `nextclaw
|
|
721
|
-
| `nextclaw
|
|
722
|
-
| `nextclaw
|
|
723
|
-
| `nextclaw
|
|
724
|
-
| `nextclaw
|
|
725
|
-
| `nextclaw
|
|
726
|
-
| `nextclaw
|
|
727
|
-
| `nextclaw
|
|
728
|
-
| `nextclaw
|
|
729
|
-
| `nextclaw remote
|
|
730
|
-
| `nextclaw
|
|
731
|
-
| `nextclaw
|
|
732
|
-
| `nextclaw
|
|
733
|
-
| `nextclaw
|
|
734
|
-
| `nextclaw
|
|
735
|
-
| `nextclaw channels
|
|
736
|
-
| `nextclaw
|
|
737
|
-
| `nextclaw
|
|
738
|
-
| `nextclaw
|
|
739
|
-
| `nextclaw
|
|
740
|
-
| `nextclaw cron
|
|
741
|
-
| `nextclaw cron
|
|
742
|
-
| `nextclaw
|
|
743
|
-
| `nextclaw
|
|
744
|
-
| `nextclaw
|
|
745
|
-
| `nextclaw
|
|
746
|
-
| `nextclaw skills
|
|
747
|
-
| `nextclaw
|
|
748
|
-
| `nextclaw
|
|
749
|
-
| `nextclaw
|
|
750
|
-
| `nextclaw
|
|
751
|
-
| `nextclaw marketplace skills
|
|
752
|
-
| `nextclaw
|
|
753
|
-
| `nextclaw
|
|
754
|
-
| `nextclaw
|
|
664
|
+
| Command | Description |
|
|
665
|
+
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
666
|
+
| `nextclaw start` | Start gateway + UI in the background |
|
|
667
|
+
| `nextclaw restart` | Restart the background service with optional start flags |
|
|
668
|
+
| `nextclaw stop` | Stop the background service |
|
|
669
|
+
| `nextclaw app create <app-dir> --template rust-wasi` | Create a standalone Rust/WASI App with WIT, Panel, Service, lockfile, and smoke test |
|
|
670
|
+
| `nextclaw app doctor --profile wasi` | Diagnose Cargo, Rust, and the `wasm32-wasip2` target |
|
|
671
|
+
| `nextclaw app build <app-dir>` | Build and place the App's Rust/WASI Components |
|
|
672
|
+
| `nextclaw app check <app-dir>` | Check a complete schema v2 App, Panel App, or Service App directory |
|
|
673
|
+
| `nextclaw app test <app-dir>` | Execute the App's declared Service Action smoke tests |
|
|
674
|
+
| `nextclaw app dev <app-dir>` | Start a Service App from the package in an isolated runtime and inspect its actions |
|
|
675
|
+
| `nextclaw app dev <app-dir> --reset-data --confirm <app-id>` | Reset that App's isolated development instance before starting |
|
|
676
|
+
| `nextclaw app call <app-dir> <action-name>` | Call a Service Action from the complete App package |
|
|
677
|
+
| `nextclaw app data list` | List active and retained App data through the running host |
|
|
678
|
+
| `nextclaw app data delete <data-id> --confirm <app-id>` | Permanently delete one retained App data instance |
|
|
679
|
+
| `nextclaw app pack <mini-app-dir> --out <file>` | Pack a schema v2 App; pure WASI Apps default to a universal artifact |
|
|
680
|
+
| `nextclaw app validate-publish <mini-app-dir>` | Validate a schema v2 Mini App package before Marketplace submission |
|
|
681
|
+
| `nextclaw app publish <mini-app-dir>` | Submit a validated Mini App to the App Marketplace for review |
|
|
682
|
+
| `nextclaw app restart <app-id>` | Restart a live Service App runtime in the running UI before live retest |
|
|
683
|
+
| `nextclaw app marketplace search` | Search Apps available from the official App Marketplace |
|
|
684
|
+
| `nextclaw app marketplace info <app-id>` | Show a Marketplace App and its derived installation command |
|
|
685
|
+
| `nextclaw app list` | List Apps installed in the running NextClaw host |
|
|
686
|
+
| `nextclaw app info <app-id>` | Show the installed App state and versions |
|
|
687
|
+
| `nextclaw app operations` | List durable App lifecycle operations |
|
|
688
|
+
| `nextclaw app install <app-id\|local-dir\|bundle.napp>` | Install an App through the running host |
|
|
689
|
+
| `nextclaw app enable <app-id>` | Enable an installed App |
|
|
690
|
+
| `nextclaw app disable <app-id>` | Disable an installed App |
|
|
691
|
+
| `nextclaw app update <app-id>` | Start a background App update |
|
|
692
|
+
| `nextclaw app rollback <app-id> --version <version>` | Roll back to an installed version |
|
|
693
|
+
| `nextclaw app uninstall <app-id>` | Start a background uninstall; require exact confirmation to purge data |
|
|
694
|
+
| `nextclaw service install-systemd --user` | Install a user-level Linux `systemd` service for NextClaw |
|
|
695
|
+
| `sudo nextclaw service install-systemd --system` | Install a system-wide Linux `systemd` service for NextClaw |
|
|
696
|
+
| `nextclaw service uninstall-systemd --user` | Remove a user-level Linux `systemd` service |
|
|
697
|
+
| `sudo nextclaw service uninstall-systemd --system` | Remove a system-wide Linux `systemd` service |
|
|
698
|
+
| `nextclaw service install-launch-agent` | Install a managed macOS LaunchAgent for NextClaw |
|
|
699
|
+
| `nextclaw service uninstall-launch-agent` | Remove a managed macOS LaunchAgent |
|
|
700
|
+
| `nextclaw service install-task` | Install a managed Windows Scheduled Task for NextClaw |
|
|
701
|
+
| `nextclaw service uninstall-task` | Remove a managed Windows Scheduled Task |
|
|
702
|
+
| `nextclaw service autostart status` | Show host autostart status |
|
|
703
|
+
| `nextclaw service autostart doctor` | Diagnose host autostart setup |
|
|
704
|
+
| `nextclaw ui` | Start UI and gateway in the foreground |
|
|
705
|
+
| `nextclaw gateway` | Start gateway only (for channels) |
|
|
706
|
+
| `nextclaw serve` | Run gateway + UI in the foreground (no background) |
|
|
707
|
+
| `nextclaw --version` | Show the installed NextClaw version |
|
|
708
|
+
| `nextclaw agent -m "message"` | Send a one-off message to the agent |
|
|
709
|
+
| `nextclaw agent` | Interactive chat in the terminal |
|
|
710
|
+
| `nextclaw exec "message"` | Run one non-interactive task (text output) |
|
|
711
|
+
| `nextclaw agent --session <id> --model <model>` | Use a session-specific model/provider route (sticky for that session) |
|
|
712
|
+
| `nextclaw status` | Show runtime process/health/config status (`--json`, `--verbose`, `--fix`) |
|
|
713
|
+
| `nextclaw usage` | Show the latest observed LLM usage snapshot; add `--history`, `--stats`, `--limit <n>`, or `--json` for local usage history and prompt cache stats |
|
|
714
|
+
| `nextclaw init` | Initialize workspace and template files |
|
|
715
|
+
| `nextclaw init --force` | Re-run init and overwrite templates |
|
|
716
|
+
| `nextclaw agents list` | List built-in and created agents |
|
|
717
|
+
| `nextclaw agents runtimes` | List installed agent runtimes (`--json`, `--probe`) |
|
|
718
|
+
| `nextclaw agents runtime config <runtime-id>` | Show or update one runtime's NextClaw context injection setting |
|
|
719
|
+
| `nextclaw agents new <agent-id>` | Create a new agent with default home/template/avatar |
|
|
720
|
+
| `nextclaw agents update <agent-id>` | Update an existing agent's display metadata |
|
|
721
|
+
| `nextclaw agents remove <agent-id>` | Remove an extra agent (built-in `main` cannot be removed) |
|
|
722
|
+
| `nextclaw projects list` | List registered projects, including projects without sessions |
|
|
723
|
+
| `nextclaw projects templates` | List built-in project templates |
|
|
724
|
+
| `nextclaw projects create <name>` | Create an empty or knowledge-base project |
|
|
725
|
+
| `nextclaw sessions rename <session-id> <label>` | Rename a session |
|
|
726
|
+
| `nextclaw sessions set-project <session-id> <directory>` | Bind a session to an existing project directory |
|
|
727
|
+
| `nextclaw sessions clear-project <session-id>` | Clear a session project binding |
|
|
728
|
+
| `nextclaw login --api-base <url>` | Start browser sign-in for NextClaw Platform and save the platform token locally (`--no-open` for headless servers, `--email/--password` for direct fallback) |
|
|
729
|
+
| `nextclaw remote enable` | Enable service-managed remote access |
|
|
730
|
+
| `nextclaw remote disable` | Disable service-managed remote access |
|
|
731
|
+
| `nextclaw remote status` | Show remote runtime/config status |
|
|
732
|
+
| `nextclaw remote doctor` | Diagnose remote readiness |
|
|
733
|
+
| `nextclaw remote connect` | Foreground debug mode: register this machine and keep the connector online |
|
|
734
|
+
| `nextclaw update` | Self-update the CLI |
|
|
735
|
+
| `nextclaw channels list --json` | List extension channels for automation and agent channel discovery |
|
|
736
|
+
| `nextclaw channels status` | Show enabled channels and status |
|
|
737
|
+
| `nextclaw doctor` | Run runtime diagnostics (`--json`, `--verbose`, `--fix`) |
|
|
738
|
+
| `nextclaw channels login` | Channel login is handled by the running UI extension auth flow |
|
|
739
|
+
| `nextclaw channels add --channel <id> ...` | Configure an extension channel |
|
|
740
|
+
| `nextclaw cron list` | List all scheduled jobs, including disabled ones |
|
|
741
|
+
| `nextclaw cron add ...` | Add a cron job (see [Cron](#cron)) |
|
|
742
|
+
| `nextclaw cron remove <jobId>` | Remove a job |
|
|
743
|
+
| `nextclaw cron enable <jobId>` | Enable a disabled job |
|
|
744
|
+
| `nextclaw cron disable <jobId>` | Disable a job without deleting it |
|
|
745
|
+
| `nextclaw cron run <jobId>` | Run a job once (optionally with `--force` if disabled) |
|
|
746
|
+
| `nextclaw skills installed` | List installed skills from the local runtime (`--json`, `--scope`, `--query`) |
|
|
747
|
+
| `nextclaw skills info <selector>` | Show installed skill details from the local runtime (`--json`) |
|
|
748
|
+
| `nextclaw skills install <slug>` | Compatibility shortcut: install a marketplace skill into `<workspace>/skills/<slug>` |
|
|
749
|
+
| `nextclaw skills publish <dir>` | Upload/create a skill to marketplace |
|
|
750
|
+
| `nextclaw skills update <dir>` | Update an existing marketplace skill |
|
|
751
|
+
| `nextclaw marketplace skills search` | Search marketplace skills (`--json`, `--query`, `--tag`, `--sort`, `--page`, `--page-size`) |
|
|
752
|
+
| `nextclaw marketplace skills info <slug>` | Show marketplace skill details (`--json`) |
|
|
753
|
+
| `nextclaw marketplace skills recommend` | List recommended marketplace skills (`--json`, `--scene`, `--limit`) |
|
|
754
|
+
| `nextclaw marketplace skills install <slug>` | Install a marketplace skill using the explicit marketplace domain |
|
|
755
|
+
| `nextclaw marketplace skills update <slug>` | Update an installed marketplace skill; refuses local file drift unless `--force` is used |
|
|
756
|
+
| `nextclaw config get <path>` | Get config value by path (use `--json` for structured output) |
|
|
757
|
+
| `nextclaw config set <path> <value>` | Set config value by path (use `--json` to parse value as JSON) |
|
|
758
|
+
| `nextclaw config unset <path>` | Remove config value by path |
|
|
755
759
|
|
|
756
760
|
Autostart notes:
|
|
757
761
|
|
|
@@ -1356,18 +1360,19 @@ NextClaw binds UI to `0.0.0.0` by default and attempts to detect/print a public
|
|
|
1356
1360
|
|
|
1357
1361
|
## Troubleshooting
|
|
1358
1362
|
|
|
1359
|
-
| Issue
|
|
1360
|
-
|
|
1361
|
-
| **401 / invalid API key**
|
|
1362
|
-
| **Unknown model**
|
|
1363
|
-
| **No replies on a channel**
|
|
1364
|
-
| **Port already in use**
|
|
1365
|
-
| **Port connects but the UI never responds** | This usually means the target port is occupied by a stale or wrong listener instead of a healthy NextClaw HTTP server. Newer `nextclaw start` now preflights the UI port and fails fast with diagnostics. On the server, run `ss -ltnp
|
|
1366
|
-
| **Public browser access returns 502**
|
|
1367
|
-
| **Config not loading**
|
|
1368
|
-
| **Agent not responding in CLI**
|
|
1363
|
+
| Issue | What to check |
|
|
1364
|
+
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
|
|
1365
|
+
| **401 / invalid API key** | Verify the provider `apiKey` and `apiBase` in config or UI. Ensure no extra spaces or wrong key. |
|
|
1366
|
+
| **Unknown model** | Confirm the model ID is supported by your provider (e.g. OpenRouter model list). |
|
|
1367
|
+
| **No replies on a channel** | Run `nextclaw status --json`, `nextclaw channels status`, and `nextclaw logs query --since 2h --domain channel.delivery --json`. Use the returned correlation id to query the full operation. If no inbound event exists, local logs cannot prove whether the external platform delivered the message; send a new unique test message and check again. |
|
|
1368
|
+
| **Port already in use** | Change `ui.port` in config or use `--ui-port` when starting. Default UI port is 55667, gateway 18790. |
|
|
1369
|
+
| **Port connects but the UI never responds** | This usually means the target port is occupied by a stale or wrong listener instead of a healthy NextClaw HTTP server. Newer `nextclaw start` now preflights the UI port and fails fast with diagnostics. On the server, run `ss -ltnp | grep 55667`or`lsof -iTCP:55667 -sTCP:LISTEN -n -P`, then free the port or restart with `--ui-port <port>`. |
|
|
1370
|
+
| **Public browser access returns 502** | First verify `curl http://127.0.0.1:55667/api/health` on the server. If it is `200`, your reverse proxy is misconfigured. Make sure it proxies to `http://127.0.0.1:55667` instead of `https://127.0.0.1:55667`, and that `443` is terminated by Nginx/Caddy rather than NextClaw itself. |
|
|
1371
|
+
| **Config not loading** | Ensure `NEXTCLAW_HOME` (if set) points to the directory that contains `config.json`. Run `nextclaw status` to see which config file is used. |
|
|
1372
|
+
| **Agent not responding in CLI** | Run `nextclaw init` if you have not yet; ensure a provider and model are set and the provider key is valid. |
|
|
1369
1373
|
|
|
1370
1374
|
---
|
|
1375
|
+
|
|
1371
1376
|
### Headless execution
|
|
1372
1377
|
|
|
1373
1378
|
Use `nextclaw exec` from scripts, CI, or a pipeline. It accepts prompt arguments, piped stdin, `--agent`, `--session`, `--model`, `--timeout <ms>`, and `--format text|json|jsonl`. Without `--session`, each invocation uses a new `exec:<uuid>` session. Text writes only the final reply to stdout; JSON and JSONL are machine-readable, while diagnostics are written to stderr. Exit codes are `0` for success, `2` for invalid input, `130` for cancellation/timeout, and `1` for runtime failures.
|