@robbiesrobotics/alice-agents 1.2.7 → 1.2.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robbies Robotics (av3.ai)
+
+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

@@ -1,8 +1,10 @@
-# 🧠 A.L.I.C.E. — AI Agent Framework for OpenClaw
+# 🧠 A.L.I.C.E. — AI Agent Framework for NemoClaw & OpenClaw
 
 **Adaptive Learning & Intelligent Coordination Engine**
 
-One conversation. One orchestrator. Ten starter agents — with 18 more in Pro. A.L.I.C.E. turns OpenClaw into a full AI team — talk to Olivia, and she routes your request to the right expert.
+One conversation. One orchestrator. Ten starter agents — with 18 more in Pro. A.L.I.C.E. turns your agent runtime into a full AI team — talk to Olivia, and she routes your request to the right expert.
+
+**NemoClaw compatible** — A.L.I.C.E. v1.2.7+ runs natively on [NVIDIA NemoClaw](https://nvidia.com/nemoclaw), the secure open-source agent runtime. Agents execute inside the OpenShell sandbox for enterprise-grade security.
 
 ## Quick Start
 
@@ -10,7 +12,7 @@ One conversation. One orchestrator. Ten starter agents — with 18 more in Pro.
 npx @robbiesrobotics/alice-agents
 ```
 
-That's it. The installer detects your OpenClaw installation, asks a few questions, and sets up everything.
+That's it. The installer detects your runtime (NemoClaw or OpenClaw) and sets everything up. If neither is installed, it will offer to install NemoClaw — the recommended option.
 
 ## What You Get
 
@@ -49,16 +51,23 @@ An orchestrator (Olivia) backed by specialist agents across every domain:
 | **Eva** | Executive Assistant | 📌 | Pro |
 | **Parker** | Project Management | 📅 | Pro |
 
-## Model Presets
+## Model Flexibility
+
+A.L.I.C.E. works with **whatever model you already have configured** in OpenClaw/NemoClaw. There's no required API key — just use what you've got.
+
+When you install, the installer will **auto-detect your configured model** and use it by default. You can also choose from presets or specify a custom model.
 
 | Preset | Models | Best For |
 |--------|--------|----------|
-| **Sonnet** (default) | claude-sonnet-4-6 for all | Balanced speed + quality |
-| **Opus + Sonnet** | Opus for orchestrator, Sonnet for specialists | Maximum orchestration quality |
-| **OpenAI** | GPT-4.1 / GPT-4.1-mini | OpenAI users |
-| **Local (Ollama)** | Local models | Privacy, offline use |
+| **Auto-detect** (default) | Your current OpenClaw model | Zero friction — works with what you have |
+| **Sonnet** | claude-sonnet-4-6 for all | Balanced speed + quality (requires Anthropic key) |
+| **Opus + Sonnet** | Opus for orchestrator, Sonnet for specialists | Maximum quality (requires Anthropic key) |
+| **OpenAI** | GPT-5.4 / GPT-5.4-mini | OpenAI users |
+| **Local (Ollama)** | Local models | Privacy, offline use, no API key needed |
 | **Custom** | Your choice | Full control |
 
+> **Tip:** We prefer Claude Opus for orchestration when available — but A.L.I.C.E. is model-agnostic. Whatever model OpenClaw has configured will work.
+
 ## Install Options
 
 ```bash
@@ -117,18 +126,20 @@ A.L.I.C.E. runs on any OpenClaw-compatible runtime:
 
 | Runtime | Status | Notes |
 |---------|--------|-------|
-| **OpenClaw** | ✅ Fully supported | Default. [openclaw.com](https://openclaw.com) |
-| **NemoClaw** | ✅ Fully supported | NVIDIA's enterprise distribution. Agents run inside OpenShell sandbox. |
+| **NemoClaw** | ✅ Recommended | NVIDIA's secure distribution. Agents run inside OpenShell sandbox. [Get NemoClaw](https://nvidia.com/nemoclaw) |
+| **OpenClaw** | ✅ Fully supported | Lightweight option. [openclaw.ai](https://openclaw.ai) |
+
+### Why NemoClaw?
 
-### NemoClaw Users
+NemoClaw is NVIDIA's open-source, enterprise-grade distribution of OpenClaw. It adds the OpenShell security sandbox — isolating what agents can access on your machine, enforcing policy-based guardrails, and keeping your data private. A.L.I.C.E. is NemoClaw-native as of v1.2.7: the installer defaults to NemoClaw, and agents display their sandbox status on startup.
 
-If you're running NemoClaw (NVIDIA's enterprise OpenClaw distribution), A.L.I.C.E. agents are fully compatible. Your OpenShell security policies will apply to all A.L.I.C.E. agent tool use — this is expected behavior and adds enterprise-grade security to your AI team.
+If you're already running NemoClaw, A.L.I.C.E. works out of the box — no extra config needed.
 
 ## Requirements
 
-- [OpenClaw](https://openclaw.com) or [NemoClaw](https://nemoclaw.com) installed and configured
+- [OpenClaw](https://openclaw.ai) or [NemoClaw](https://nemoclaw.com) installed and configured
 - Node.js 18+
-- At least one AI provider configured (Anthropic, OpenAI, or Ollama)
+- At least one AI provider configured in OpenClaw (Anthropic, OpenAI, Ollama, or any other supported provider)
 
 ## License
 

package/lib/config-merger.mjs

@@ -15,6 +15,43 @@ export function readConfig() {
   return JSON.parse(raw);
 }
 
+/**
+ * Inspect the existing OpenClaw/NemoClaw config and return what models
+ * and providers the user already has set up. This is used to avoid
+ * forcing Anthropic/Claude on users who haven't configured those keys.
+ *
+ * Returns null if config can't be read.
+ */
+export function detectAvailableModels() {
+  if (!configExists()) return null;
+  try {
+    const config = readConfig();
+
+    // Current agents.defaults.model (set by a prior install or manually)
+    const agentDefaults = config?.agents?.defaults?.model || {};
+
+    // Top-level model override (some users set this)
+    const globalModel = config?.model;
+
+    // Configured provider keys (e.g. ['anthropic', 'openai', 'ollama'])
+    const providers = Object.keys(config?.models?.providers || {});
+
+    const primary = agentDefaults.primary || globalModel || null;
+    const orchestrator = agentDefaults.orchestrator || primary;
+    const fallbacks = agentDefaults.fallbacks || [];
+
+    return {
+      primary,
+      orchestrator,
+      fallbacks,
+      providers,
+      hasModel: !!primary,
+    };
+  } catch {
+    return null;
+  }
+}
+
 function backupConfig() {
   const ts = Date.now();
   const backupPath = join(OPENCLAW_DIR, `openclaw.json.bak.alice-${ts}`);
@@ -29,8 +66,17 @@ function writeConfigAtomic(config) {
   renameSync(tmpPath, CONFIG_PATH);
 }
 
-function getModelConfig(preset, customModels) {
+function getModelConfig(preset, customModels, detectedModels) {
   switch (preset) {
+    case 'detected':
+      // Use whatever the user already has configured — don't touch model settings at all
+      return {
+        primary: detectedModels?.primary || null,
+        orchestrator: detectedModels?.orchestrator || detectedModels?.primary || null,
+        fallbacks: detectedModels?.fallbacks || [],
+        models: {},
+        preserve: true, // signal: don't overwrite model defaults
+      };
     case 'sonnet':
       return {
         primary: 'anthropic/claude-sonnet-4-6',
@@ -54,12 +100,12 @@ function getModelConfig(preset, customModels) {
       };
     case 'openai':
       return {
-        primary: 'openai/gpt-4.1-mini',
-        orchestrator: 'openai/gpt-4.1',
-        fallbacks: ['openai/gpt-4.1', 'openai/gpt-4.1-mini'],
+        primary: 'openai/gpt-5.4-mini',
+        orchestrator: 'openai/gpt-5.4',
+        fallbacks: ['openai/gpt-5.4', 'openai/gpt-5.4-mini'],
         models: {
-          'openai/gpt-4.1': {},
-          'openai/gpt-4.1-mini': {},
+          'openai/gpt-5.4': {},
+          'openai/gpt-5.4-mini': {},
         },
       };
     case 'local':
@@ -71,8 +117,8 @@ function getModelConfig(preset, customModels) {
       };
     case 'custom':
       return {
-        primary: customModels?.primary || 'anthropic/claude-sonnet-4-6',
-        orchestrator: customModels?.orchestrator || customModels?.primary || 'anthropic/claude-sonnet-4-6',
+        primary: customModels?.primary || null,
+        orchestrator: customModels?.orchestrator || customModels?.primary || null,
         fallbacks: [],
         models: {},
       };
@@ -110,7 +156,8 @@ function buildAgentEntry(agent, modelCfg) {
 export function mergeConfig({ agents, mode, preset, customModels }) {
   const backupPath = backupConfig();
   const config = readConfig();
-  const modelCfg = getModelConfig(preset, customModels);
+  const detectedModels = detectAvailableModels();
+  const modelCfg = getModelConfig(preset, customModels, detectedModels);
 
   // Build agent entries
   const aliceEntries = agents.map((a) => buildAgentEntry(a, modelCfg));
@@ -140,13 +187,24 @@ export function mergeConfig({ agents, mode, preset, customModels }) {
 
   // Set defaults
   config.agents.defaults = config.agents.defaults || {};
-  config.agents.defaults.model = {
-    primary: modelCfg.primary,
-    fallbacks: modelCfg.fallbacks,
-  };
-  if (Object.keys(modelCfg.models).length > 0) {
-    config.agents.defaults.models = modelCfg.models;
+
+  if (modelCfg.preserve) {
+    // User's existing model config is intact — don't overwrite it.
+    // Only initialize the key if it doesn't exist at all (safety net).
+    config.agents.defaults.model = config.agents.defaults.model || {};
+  } else if (modelCfg.primary) {
+    config.agents.defaults.model = {
+      primary: modelCfg.primary,
+      fallbacks: modelCfg.fallbacks,
+    };
+    if (modelCfg.orchestrator && modelCfg.orchestrator !== modelCfg.primary) {
+      config.agents.defaults.model.orchestrator = modelCfg.orchestrator;
+    }
+    if (Object.keys(modelCfg.models).length > 0) {
+      config.agents.defaults.models = modelCfg.models;
+    }
   }
+  // If modelCfg.primary is null (custom/detected with nothing set), leave existing model config alone
   config.agents.defaults.workspace = join(OPENCLAW_DIR, 'workspace-olivia');
   config.agents.defaults.compaction = config.agents.defaults.compaction || { mode: 'safeguard' };
   config.agents.defaults.maxConcurrent = config.agents.defaults.maxConcurrent || 4;

package/lib/installer.mjs

@@ -2,7 +2,7 @@ import { readFileSync, existsSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { execSync } from 'node:child_process';
-import { configExists, mergeConfig, removeAliceAgents } from './config-merger.mjs';
+import { configExists, mergeConfig, removeAliceAgents, detectAvailableModels } from './config-merger.mjs';
 import { scaffoldAll } from './workspace-scaffolder.mjs';
 import { readManifest, writeManifest } from './manifest.mjs';
 import {
@@ -170,11 +170,18 @@ function printBanner() {
   console.log();
 }
 
-function printSummary(mode, tier, agents, preset, userInfo) {
+function printSummary(mode, tier, agents, preset, userInfo, detectedModels) {
+  const modelLabel =
+    preset === 'detected'
+      ? `${detectedModels?.primary || 'your configured model'} (detected)`
+      : preset === 'custom'
+        ? `custom`
+        : preset;
+
   console.log('\n  ── Install Summary ──────────────────────────────');
   console.log(`  Mode:      ${mode}`);
   console.log(`  Tier:      ${tier} (${agents.length} agents)`);
-  console.log(`  Model:     ${preset}`);
+  console.log(`  Model:     ${modelLabel}`);
   console.log(`  User:      ${userInfo.name}`);
   console.log(`  Timezone:  ${userInfo.timezone}`);
   console.log('  ─────────────────────────────────────────────────');
@@ -229,6 +236,19 @@ export async function runInstall(options = {}) {
     console.log('  💡 Tip: Upgrade to NemoClaw for enterprise security: https://nvidia.com/nemoclaw\n');
   }
 
+  // Detect what models the user already has configured
+  const detectedModels = detectAvailableModels();
+  if (detectedModels?.hasModel) {
+    console.log(`  ✔  Detected configured model: ${detectedModels.primary}`);
+    if (detectedModels.providers.length > 0) {
+      console.log(`     Providers: ${detectedModels.providers.join(', ')}\n`);
+    } else {
+      console.log();
+    }
+  } else {
+    console.log('  ℹ  No model configured yet — you\'ll be prompted to choose one.\n');
+  }
+
   const allAgents = loadAgentRegistry();
 
   // 2. Install mode
@@ -269,9 +289,12 @@ export async function runInstall(options = {}) {
   // 4. Model preset
   let preset, customModels;
   if (auto) {
-    preset = 'sonnet';
+    // Non-interactive: use whatever the user already has configured.
+    // Only fall back to sonnet if nothing is detected (e.g. fresh OpenClaw install
+    // where the user explicitly set up Claude credentials).
+    preset = detectedModels?.hasModel ? 'detected' : 'sonnet';
   } else {
-    preset = await promptModelPreset();
+    preset = await promptModelPreset(detectedModels);
     if (preset === 'custom') {
       customModels = await promptCustomModel();
     }
@@ -307,7 +330,7 @@ export async function runInstall(options = {}) {
   const agents = allAgents;
 
   // 6. Confirmation
-  printSummary(mode, tier, agents, preset, userInfo);
+  printSummary(mode, tier, agents, preset, userInfo, detectedModels);
 
   if (!auto) {
     const ok = await confirm('  Proceed with installation?');

package/lib/prompter.mjs

@@ -78,19 +78,29 @@ export async function promptUserInfo() {
   return { name, timezone: tz, notes };
 }
 
-export async function promptModelPreset() {
-  return choose('Model preset:', [
-    { label: 'Sonnet (recommended) — claude-sonnet-4-6 for all agents', value: 'sonnet' },
+export async function promptModelPreset(detectedModels) {
+  const options = [];
+
+  // If the user already has a model configured, put it first
+  if (detectedModels?.hasModel) {
+    const label = `Use your current model (${detectedModels.primary}) — recommended`;
+    options.push({ label, value: 'detected' });
+  }
+
+  options.push(
+    { label: 'Sonnet — claude-sonnet-4-6 for all agents', value: 'sonnet' },
     { label: 'Opus + Sonnet — Opus for orchestrator, Sonnet for specialists', value: 'opus-sonnet' },
-    { label: 'OpenAI — GPT-4.1 / GPT-4.1-mini', value: 'openai' },
+    { label: 'OpenAI — GPT-5.4 / GPT-5.4-mini', value: 'openai' },
     { label: 'Local (Ollama) — requires local models', value: 'local' },
     { label: 'Custom — specify your own model strings', value: 'custom' },
-  ]);
+  );
+
+  return choose('\n  Model selection:', options);
 }
 
 export async function promptCustomModel() {
-  const primary = await input('Primary model (e.g., anthropic/claude-sonnet-4-6)');
-  const orchestrator = await input('Orchestrator model (or same as primary)', primary);
+  const primary = await input('  Primary model (e.g., anthropic/claude-sonnet-4-6, openai/gpt-4o, ollama/llama3)');
+  const orchestrator = await input('  Orchestrator model (or same as primary)', primary);
   return { primary, orchestrator };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbiesrobotics/alice-agents",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "description": "A.L.I.C.E. — 28 AI agents for OpenClaw. One conversation, one team.",
   "bin": {
     "alice-agents": "bin/alice-install.mjs"