@qingchencloud/openclaw-zh 2026.1.29-nightly.202601301956 → 2026.1.29-nightly.202601302059

package/CHANGELOG.md

@@ -41,11 +41,12 @@ Status: stable.
 - Routing: add per-account DM session scope and document multi-account isolation. (#3095) Thanks @jarvis-sam.
 - Routing: precompile session key regexes. (#1697) Thanks @Ray0907.
 - CLI: use Node's module compile cache for faster startup. (#2808) Thanks @pi0.
+- CLI: add per-agent model status and auth order scoping. (#4780) Thanks @jlowin.
 - Auth: show copyable Google auth URL after ASCII prompt. (#1787) Thanks @robbyczgw-cla.
 - Agents: add Kimi K2.5 to the synthetic model catalog. (#4407) Thanks @manikv12.
 - TUI: avoid width overflow when rendering selection lists. (#1686) Thanks @mossein.
 - macOS: finish OpenClaw app rename for macOS sources, bundle identifiers, and shared kit paths. (#2844) Thanks @fal3.
-- Branding: update launchd labels, mobile bundle IDs, and logging subsystems to bot.molt (legacy com.clawdbot migrations). Thanks @thewilloftheshadow.
+- Branding: update launchd labels, mobile bundle IDs, and logging subsystems to bot.molt (legacy bundle ID migrations). Thanks @thewilloftheshadow.
 - macOS: limit project-local `node_modules/.bin` PATH preference to debug builds (reduce PATH hijacking risk).
 - macOS: keep custom SSH usernames in remote target. (#2046) Thanks @algal.
 - macOS: avoid crash when rendering code blocks by bumping Textual to 0.3.1. (#2033) Thanks @garricn.
@@ -417,7 +418,7 @@ Status: stable.
 - Security: warn when <=300B models run without sandboxing while web tools are enabled. https://docs.openclaw.ai/cli/security
 - Exec: add host/security/ask routing for gateway + node exec. https://docs.openclaw.ai/tools/exec
 - Exec: add `/exec` directive for per-session exec defaults (host/security/ask/node). https://docs.openclaw.ai/tools/exec
-- Exec approvals: migrate approvals to `~/.clawdbot/exec-approvals.json` with per-agent allowlists + skill auto-allow toggle, and add approvals UI + node exec lifecycle events. https://docs.openclaw.ai/tools/exec-approvals
+- Exec approvals: migrate approvals to `~/.openclaw/exec-approvals.json` with per-agent allowlists + skill auto-allow toggle, and add approvals UI + node exec lifecycle events. https://docs.openclaw.ai/tools/exec-approvals
 - Nodes: add headless node host (`openclaw node start`) for `system.run`/`system.which`. https://docs.openclaw.ai/cli/node
 - Nodes: add node daemon service install/status/start/stop/restart. https://docs.openclaw.ai/cli/node
 - Bridge: add `skills.bins` RPC to support node host auto-allow skill bins.
@@ -441,7 +442,7 @@ Status: stable.
 - Android: remove legacy bridge transport code now that nodes use the gateway protocol.
 - Android: bump okhttp + dnsjava to satisfy lint dependency checks.
 - Build: update workspace + core/plugin deps.
-- Build: use tsgo for dev/watch builds by default (opt out with `CLAWDBOT_TS_COMPILER=tsc`).
+- Build: use tsgo for dev/watch builds by default (opt out with `OPENCLAW_TS_COMPILER=tsc`).
 - Repo: remove the Peekaboo git submodule now that the SPM release is used.
 - macOS: switch PeekabooBridge integration to the tagged Swift Package Manager release.
 - macOS: stop syncing Peekaboo in postinstall.
@@ -569,7 +570,7 @@ Thanks @AlexMikhalev, @CoreyH, @John-Rood, @KrauseFx, @MaudeBot, @Nachx639, @Nic
 - **BREAKING:** Drop legacy `chatType: "room"` support; use `chatType: "channel"`.
 - **BREAKING:** remove legacy provider-specific target resolution fallbacks; target resolution is centralized with plugin hints + directory lookups.
 - **BREAKING:** `openclaw hooks` is now `openclaw webhooks`; hooks live under `openclaw hooks`. https://docs.openclaw.ai/cli/webhooks
-- **BREAKING:** `openclaw plugins install <path>` now copies into `~/.clawdbot/extensions` (use `--link` to keep path-based loading).
+- **BREAKING:** `openclaw plugins install <path>` now copies into `~/.openclaw/extensions` (use `--link` to keep path-based loading).
 
 ### Changes
 - Plugins: ship bundled plugins disabled by default and allow overrides by installed versions. (#1066) — thanks @ItzR3NO.
@@ -804,7 +805,7 @@ Thanks @AlexMikhalev, @CoreyH, @John-Rood, @KrauseFx, @MaudeBot, @Nachx639, @Nic
 - TUI: render picker overlays via the overlay stack so /models and /settings display. (#921) — thanks @grizzdank.
 - TUI: add a bright spinner + elapsed time in the status line for send/stream/run states.
 - TUI: show LLM error messages (rate limits, auth, etc.) instead of `(no output)`.
-- Gateway/Dev: ensure `pnpm gateway:dev` always uses the dev profile config + state (`~/.clawdbot-dev`).
+- Gateway/Dev: ensure `pnpm gateway:dev` always uses the dev profile config + state (`~/.openclaw-dev`).
 
 #### Agents / Auth / Tools / Sandbox
 - Agents: make user time zone and 24-hour time explicit in the system prompt. (#859) — thanks @CashWilliams.
@@ -865,7 +866,7 @@ Thanks @AlexMikhalev, @CoreyH, @John-Rood, @KrauseFx, @MaudeBot, @Nachx639, @Nic
 
 ### New & Improved
 - Memory: add custom OpenAI-compatible embedding endpoints; support OpenAI/local `node-llama-cpp` embeddings with per-agent overrides and provider metadata in tools/CLI. (#819) — thanks @mukhtharcm.
-- Memory: new `openclaw memory` CLI plus `memory_search`/`memory_get` tools with snippets + line ranges; index stored under `~/.clawdbot/memory/{agentId}.sqlite` with watch-on-by-default.
+- Memory: new `openclaw memory` CLI plus `memory_search`/`memory_get` tools with snippets + line ranges; index stored under `~/.openclaw/memory/{agentId}.sqlite` with watch-on-by-default.
 - Agents: strengthen memory recall guidance; make workspace bootstrap truncation configurable (default 20k) with warnings; add default sub-agent model config.
 - Tools/Sandbox: add tool profiles + group shorthands; support tool-policy groups in `tools.sandbox.tools`; drop legacy `memory` shorthand; allow Docker bind mounts via `docker.binds`. (#790) — thanks @akonyer.
 - Tools: add provider/model-specific tool policy overrides (`tools.byProvider`) to trim tool exposure per provider.
@@ -1113,7 +1114,7 @@ Thanks @AlexMikhalev, @CoreyH, @John-Rood, @KrauseFx, @MaudeBot, @Nachx639, @Nic
 - CLI UX: logs output modes (pretty/plain/JSONL) + colorized health/daemon output; global `--no-color`; lobster palette in onboarding/config.
 - Dev ergonomics: gateway `--dev/--reset` + dev profile auto-config; C-3PO dev templates; dev gateway/TUI helper scripts.
 - Sandbox/Workspace: sandbox list/recreate commands; sync skills into sandbox workspace; sandbox browser auto-start.
-- Config/Onboarding: inline env vars; OpenAI API key flow to shared `~/.clawdbot/.env`; Opus 4.5 default prompt for Anthropic auth; QuickStart auto-install gateway (Node-only) + provider picker tweaks + skip-systemd flags; TUI bootstrap prompt (`tui --message`); remove Bun runtime choice.
+- Config/Onboarding: inline env vars; OpenAI API key flow to shared `~/.openclaw/.env`; Opus 4.5 default prompt for Anthropic auth; QuickStart auto-install gateway (Node-only) + provider picker tweaks + skip-systemd flags; TUI bootstrap prompt (`tui --message`); remove Bun runtime choice.
 - Providers: Microsoft Teams provider (polling, attachments, outbound sends, requireMention, config reload/DM policy). (#404) — thanks @onutc
 - Providers: WhatsApp broadcast groups for multi-agent replies (#547) — thanks @pasogott; inbound media size cap configurable (#505) — thanks @koala73; identity-based message prefixes (#578) — thanks @p6l-richard.
 - Providers: Telegram inline keyboard buttons + callback payload routing (#491) — thanks @azade-c; cron topic delivery targets (#474/#478) — thanks @mitschabaude-bot, @nachoiacovino; `[[audio_as_voice]]` tag support (#490) — thanks @jarvis-medmatic.
@@ -1182,7 +1183,7 @@ Thanks @AlexMikhalev, @CoreyH, @John-Rood, @KrauseFx, @MaudeBot, @Nachx639, @Nic
 - **Control UI/Web:** logs tab, focus mode polish, config form resilience, streaming stability, tool output caps, windowed chat history, and reconnect/password URL auth.
 - **macOS/Android/TUI/Build:** macOS gateway races, QR bundling, JSON5 config safety, Voice Wake hardening; Android EXIF rotation + APK naming/versioning; TUI key handling; tooling/bundling fixes.
 - **Packaging/compat:** npm dist folder coverage, Node 25 qrcode-terminal import fixes, Bun/Playwright/WebSocket patches, and Docker Bun install.
-- **Docs:** new FAQ/ClawdHub/config examples/showcase entries and clarified auth, sandbox, and systemd docs.
+- **Docs:** new FAQ/ClawHub/config examples/showcase entries and clarified auth, sandbox, and systemd docs.
 
 ### Maintenance
 - Skills additions (Himalaya email, CodexBar, 1Password).
@@ -1212,7 +1213,7 @@ Thanks @AlexMikhalev, @CoreyH, @John-Rood, @KrauseFx, @MaudeBot, @Nachx639, @Nic
 - WhatsApp: mark offline history sync messages as read without auto-reply. (#193) — thanks @mcinteerj
 - Discord: avoid duplicate replies when a provider emits late streaming `text_end` events (OpenAI/GPT).
 - CLI: use tailnet IP for local gateway calls when bind is tailnet/auto (fixes #176).
-- Env: load global `$CLAWDBOT_STATE_DIR/.env` (`~/.clawdbot/.env`) as a fallback after CWD `.env`.
+- Env: load global `$OPENCLAW_STATE_DIR/.env` (`~/.openclaw/.env`) as a fallback after CWD `.env`.
 - Env: optional login-shell env fallback (opt-in; imports expected keys without overriding existing env).
 - Agent tools: OpenAI-compatible tool JSON Schemas (fix `browser`, normalize union schemas).
 - Onboarding: when running from source, auto-build missing Control UI assets (`bun run ui:build`).

package/README.md

@@ -270,26 +270,99 @@ openclaw --help             # 查看帮助
 
 ## 🐳 Docker 部署指南
 
-### 快速启动
+### 方式 1：一键部署脚本（推荐）
+
+自动完成初始化、配置远程访问、启动容器：
 
 ```bash
-# 基础运行
+# Linux / macOS
+curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | bash
+
+# Windows PowerShell
+irm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.ps1 | iex
+```
+
+### 方式 2：快速启动（本地访问）
+
+适用于在本机运行并通过 `localhost` 访问：
+
+```bash
+# 基础运行（数据不持久化）
 docker run -d \
   --name openclaw \
   -p 18789:18789 \
   ghcr.io/qingchencloud/openclaw-zh:latest
 
-# 带数据持久化
+# 带数据持久化（推荐）
 docker run -d \
   --name openclaw \
   -p 18789:18789 \
-  -v openclaw-data:/home/node/.openclaw \
+  -v openclaw-data:/root/.openclaw \
   ghcr.io/qingchencloud/openclaw-zh:latest
 ```
 
+访问：`http://localhost:18789`
+
+### 方式 3：服务器部署（远程访问）
+
+部署到服务器并从其他设备访问时，需要额外配置。
+
+**手动配置步骤：**
+
+```bash
+# 1. 创建数据卷
+docker volume create openclaw-data
+
+# 2. 初始化配置
+docker run --rm -v openclaw-data:/root/.openclaw \
+  ghcr.io/qingchencloud/openclaw-zh:latest openclaw setup
+
+# 3. 配置远程访问参数
+docker run --rm -v openclaw-data:/root/.openclaw \
+  ghcr.io/qingchencloud/openclaw-zh:latest openclaw config set gateway.mode local
+
+docker run --rm -v openclaw-data:/root/.openclaw \
+  ghcr.io/qingchencloud/openclaw-zh:latest openclaw config set gateway.bind lan
+
+docker run --rm -v openclaw-data:/root/.openclaw \
+  ghcr.io/qingchencloud/openclaw-zh:latest openclaw config set gateway.controlUi.allowInsecureAuth true
+
+# 4. 启动容器
+docker run -d \
+  --name openclaw \
+  -p 18789:18789 \
+  -v openclaw-data:/root/.openclaw \
+  -e OPENCLAW_GATEWAY_TOKEN=your-secure-token \
+  --restart unless-stopped \
+  ghcr.io/qingchencloud/openclaw-zh:latest \
+  openclaw gateway run
+```
+
+访问：`http://服务器IP:18789?token=your-secure-token`
+
+### 远程访问注意事项
+
+通过 HTTP 从非 localhost 访问时，浏览器会限制某些安全功能（设备身份验证）。
+
+| 方案 | 说明 | 适用场景 |
+|------|------|----------|
+| **启用 allowInsecureAuth** | 仅使用 Token 认证 | 内网/测试环境 |
+| **使用 HTTPS** | Tailscale Serve 或 Nginx 反向代理 | 生产环境（推荐） |
+| **SSH 端口转发** | `ssh -L 18789:127.0.0.1:18789 user@server` | 临时访问 |
+
 ### 使用 Docker Compose
 
-创建 `docker-compose.yml`：
+项目提供了开箱即用的 `docker-compose.yml`：
+
+```bash
+# 下载配置文件
+curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-compose.yml -o docker-compose.yml
+
+# 启动（首次会自动初始化）
+docker-compose up -d
+```
+
+或手动创建 `docker-compose.yml`：
 
 ```yaml
 version: '3.8'
@@ -300,21 +373,17 @@ services:
     ports:
       - "18789:18789"
     volumes:
-      - openclaw-data:/home/node/.openclaw
+      - openclaw-data:/root/.openclaw
     environment:
-      - OPENCLAW_GATEWAY_TOKEN=your-secure-token  # 可选：设置访问令牌
+      - OPENCLAW_GATEWAY_TOKEN=your-secure-token  # 设置访问令牌
     restart: unless-stopped
+    # 远程访问时使用以下命令（需先手动初始化配置）
+    # command: openclaw gateway run
 
 volumes:
   openclaw-data:
 ```
 
-启动：
-
-```bash
-docker-compose up -d
-```
-
 ### 自行构建 Docker 镜像
 
 如果需要自定义或使用最新代码：
@@ -335,7 +404,7 @@ cd openclaw
 docker build -t openclaw-zh:local .
 
 # 5. 运行
-docker run -d --name openclaw -p 18789:18789 openclaw-zh:local
+docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw openclaw-zh:local
 ```
 
 ### 常用 Docker 命令
@@ -355,13 +424,10 @@ docker exec -it openclaw sh
 
 # 删除容器
 docker stop openclaw && docker rm openclaw
-```
-
-### 访问 Dashboard
 
-启动后访问：`http://localhost:18789`
-
-如果设置了令牌，使用：`http://localhost:18789/?token=your-secure-token`
+# 查看配置
+docker run --rm -v openclaw-data:/root/.openclaw alpine cat /root/.openclaw/openclaw.json
+```
 
 ---
 

package/dist/agents/system-prompt.js

@@ -99,7 +99,7 @@ function buildDocsSection(params) {
         "Mirror: https://docs.openclaw.ai",
         "Source: https://github.com/openclaw/openclaw",
         "Community: https://discord.com/invite/clawd",
-        "Find new skills: https://clawdhub.com",
+        "Find new skills: https://clawhub.com",
         "For OpenClaw behavior, commands, config, or architecture: consult local docs first.",
         "When diagnosing issues, run `openclaw status` yourself when possible; only ask the user if you lack access (e.g., sandboxed).",
         "",

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026.1.29-nightly.202601301956",
-  "commit": "6522de6ce045e0166d3136880b26004a04e44f91",
-  "builtAt": "2026-01-30T19:57:23.641Z"
+  "version": "2026.1.29-nightly.202601302059",
+  "commit": "7c96bde3b3db74dcf57bff0138eefd5d03ba1d08",
+  "builtAt": "2026-01-30T21:00:23.151Z"
 }

package/dist/canvas-host/a2ui/.bundle.hash

@@ -1 +1 @@
-d59f24e4a21a391e6b92f94e99745f90e19490d4d659a41095bb1ddc97411f53
+9f71946c42dd48cbf433eb302e8b0824f989785de8f9750671ce2f34c097396d

package/dist/cli/cli-utils.js

@@ -32,3 +32,13 @@ export async function runCommandWithRuntime(runtime, action, onError) {
         runtime.exit(1);
     }
 }
+export function resolveOptionFromCommand(command, key) {
+    let current = command;
+    while (current) {
+        const opts = (current.opts?.() ?? {});
+        if (opts[key] !== undefined)
+            return opts[key];
+        current = current.parent ?? undefined;
+    }
+    return undefined;
+}

package/dist/cli/models-cli.js

@@ -2,7 +2,7 @@ import { githubCopilotLoginCommand, modelsAliasesAddCommand, modelsAliasesListCo
 import { defaultRuntime } from "../runtime.js";
 import { formatDocsLink } from "../terminal/links.js";
 import { theme } from "../terminal/theme.js";
-import { runCommandWithRuntime } from "./cli-utils.js";
+import { resolveOptionFromCommand, runCommandWithRuntime } from "./cli-utils.js";
 function runModelsCommand(action) {
     return runCommandWithRuntime(defaultRuntime, action);
 }
@@ -12,6 +12,7 @@ export function registerModelsCli(program) {
         .description("Model discovery, scanning, and configuration")
         .option("--status-json", "Output JSON (alias for `models status --json`)", false)
         .option("--status-plain", "Plain output (alias for `models status --plain`)", false)
+        .option("--agent <id>", "Agent id to inspect (overrides OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR)")
         .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/models", "docs.openclaw.ai/cli/models")}\n`);
     models
         .command("list")
@@ -42,7 +43,9 @@ export function registerModelsCli(program) {
         .option("--probe-timeout <ms>", "Per-probe timeout in ms")
         .option("--probe-concurrency <n>", "Concurrent probes")
         .option("--probe-max-tokens <n>", "Probe max tokens (best-effort)")
-        .action(async (opts) => {
+        .option("--agent <id>", "Agent id to inspect (overrides OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR)")
+        .action(async (opts, command) => {
+        const agent = resolveOptionFromCommand(command, "agent") ?? opts.agent;
         await runModelsCommand(async () => {
             await modelsStatusCommand({
                 json: Boolean(opts.json),
@@ -54,6 +57,7 @@ export function registerModelsCli(program) {
                 probeTimeout: opts.probeTimeout,
                 probeConcurrency: opts.probeConcurrency,
                 probeMaxTokens: opts.probeMaxTokens,
+                agent,
             }, defaultRuntime);
         });
     });
@@ -206,10 +210,15 @@ export function registerModelsCli(program) {
             await modelsStatusCommand({
                 json: Boolean(opts?.statusJson),
                 plain: Boolean(opts?.statusPlain),
+                agent: opts?.agent,
             }, defaultRuntime);
         });
     });
     const auth = models.command("auth").description("Manage model auth profiles");
+    auth.option("--agent <id>", "Agent id for auth order get/set/clear");
+    auth.action(() => {
+        auth.help();
+    });
     auth
         .command("add")
         .description("Interactive auth helper (setup-token or paste token)")
@@ -281,11 +290,12 @@ export function registerModelsCli(program) {
         .requiredOption("--provider <name>", "Provider id (e.g. anthropic)")
         .option("--agent <id>", "Agent id (default: configured default agent)")
         .option("--json", "Output JSON", false)
-        .action(async (opts) => {
+        .action(async (opts, command) => {
+        const agent = resolveOptionFromCommand(command, "agent") ?? opts.agent;
         await runModelsCommand(async () => {
             await modelsAuthOrderGetCommand({
                 provider: opts.provider,
-                agent: opts.agent,
+                agent,
                 json: Boolean(opts.json),
             }, defaultRuntime);
         });
@@ -296,11 +306,12 @@ export function registerModelsCli(program) {
         .requiredOption("--provider <name>", "Provider id (e.g. anthropic)")
         .option("--agent <id>", "Agent id (default: configured default agent)")
         .argument("<profileIds...>", "Auth profile ids (e.g. anthropic:default)")
-        .action(async (profileIds, opts) => {
+        .action(async (profileIds, opts, command) => {
+        const agent = resolveOptionFromCommand(command, "agent") ?? opts.agent;
         await runModelsCommand(async () => {
             await modelsAuthOrderSetCommand({
                 provider: opts.provider,
-                agent: opts.agent,
+                agent,
                 order: profileIds,
             }, defaultRuntime);
         });
@@ -310,11 +321,12 @@ export function registerModelsCli(program) {
         .description("Clear per-agent auth order override (fall back to config/round-robin)")
         .requiredOption("--provider <name>", "Provider id (e.g. anthropic)")
         .option("--agent <id>", "Agent id (default: configured default agent)")
-        .action(async (opts) => {
+        .action(async (opts, command) => {
+        const agent = resolveOptionFromCommand(command, "agent") ?? opts.agent;
         await runModelsCommand(async () => {
             await modelsAuthOrderClearCommand({
                 provider: opts.provider,
-                agent: opts.agent,
+                agent,
             }, defaultRuntime);
         });
     });

package/dist/cli/skills-cli.js

@@ -7,10 +7,10 @@ import { renderTable } from "../terminal/table.js";
 import { theme } from "../terminal/theme.js";
 import { shortenHomePath } from "../utils.js";
 import { formatCliCommand } from "./command-format.js";
-function appendClawdHubHint(output, json) {
+function appendClawHubHint(output, json) {
     if (json)
         return output;
-    return `${output}\n\nTip: use \`npx clawdhub\` to search, install, and sync skills.`;
+    return `${output}\n\nTip: use \`npx clawhub\` to search, install, and sync skills.`;
 }
 function formatSkillStatus(skill) {
     if (skill.eligible)
@@ -72,7 +72,7 @@ export function formatSkillsList(report, opts) {
         const message = opts.eligible
             ? `No eligible skills found. Run \`${formatCliCommand("openclaw skills list")}\` to see all skills.`
             : "No skills found.";
-        return appendClawdHubHint(message, opts.json);
+        return appendClawHubHint(message, opts.json);
     }
     const eligible = skills.filter((s) => s.eligible);
     const tableWidth = Math.max(60, (process.stdout.columns ?? 120) - 1);
@@ -102,7 +102,7 @@ export function formatSkillsList(report, opts) {
         columns,
         rows,
     }).trimEnd());
-    return appendClawdHubHint(lines.join("\n"), opts.json);
+    return appendClawHubHint(lines.join("\n"), opts.json);
 }
 /**
  * Format detailed info for a single skill
@@ -113,7 +113,7 @@ export function formatSkillInfo(report, skillName, opts) {
         if (opts.json) {
             return JSON.stringify({ error: "not found", skill: skillName }, null, 2);
         }
-        return appendClawdHubHint(`Skill "${skillName}" not found. Run \`${formatCliCommand("openclaw skills list")}\` to see available skills.`, opts.json);
+        return appendClawHubHint(`Skill "${skillName}" not found. Run \`${formatCliCommand("openclaw skills list")}\` to see available skills.`, opts.json);
     }
     if (opts.json) {
         return JSON.stringify(skill, null, 2);
@@ -195,7 +195,7 @@ export function formatSkillInfo(report, skillName, opts) {
             lines.push(`  ${theme.warn("→")} ${inst.label}`);
         }
     }
-    return appendClawdHubHint(lines.join("\n"), opts.json);
+    return appendClawHubHint(lines.join("\n"), opts.json);
 }
 /**
  * Format a check/summary of all skills status
@@ -264,7 +264,7 @@ export function formatSkillsCheck(report, opts) {
             lines.push(`  ${emoji} ${skill.name} ${theme.muted(`(${missing.join("; ")})`)}`);
         }
     }
-    return appendClawdHubHint(lines.join("\n"), opts.json);
+    return appendClawHubHint(lines.join("\n"), opts.json);
 }
 /**
  * Register the skills CLI commands

package/dist/commands/models/auth-order.js

@@ -2,10 +2,10 @@ import { resolveAgentDir, resolveDefaultAgentId } from "../../agents/agent-scope
 import { ensureAuthProfileStore, setAuthProfileOrder, } from "../../agents/auth-profiles.js";
 import { normalizeProviderId } from "../../agents/model-selection.js";
 import { loadConfig } from "../../config/config.js";
-import { normalizeAgentId } from "../../routing/session-key.js";
 import { shortenHomePath } from "../../utils.js";
+import { resolveKnownAgentId } from "./shared.js";
 function resolveTargetAgent(cfg, raw) {
-    const agentId = raw?.trim() ? normalizeAgentId(raw.trim()) : resolveDefaultAgentId(cfg);
+    const agentId = resolveKnownAgentId({ cfg, rawAgentId: raw }) ?? resolveDefaultAgentId(cfg);
     const agentDir = resolveAgentDir(cfg, agentId);
     return { agentId, agentDir };
 }

package/dist/commands/models/list.status-command.js

@@ -1,9 +1,10 @@
 import path from "node:path";
 import { resolveOpenClawAgentDir } from "../../agents/agent-paths.js";
+import { resolveAgentDir, resolveAgentModelFallbacksOverride, resolveAgentModelPrimary, } from "../../agents/agent-scope.js";
 import { buildAuthHealthSummary, DEFAULT_OAUTH_WARN_MS, formatRemainingShort, } from "../../agents/auth-health.js";
 import { ensureAuthProfileStore, resolveAuthStorePathForDisplay, resolveProfileUnusableUntilForDisplay, } from "../../agents/auth-profiles.js";
 import { resolveEnvApiKey } from "../../agents/model-auth.js";
-import { buildModelAliasIndex, parseModelRef, resolveConfiguredModelRef, resolveModelRefFromString, } from "../../agents/model-selection.js";
+import { buildModelAliasIndex, parseModelRef, resolveConfiguredModelRef, resolveDefaultModelForAgent, resolveModelRefFromString, } from "../../agents/model-selection.js";
 import { CONFIG_PATH, loadConfig } from "../../config/config.js";
 import { getShellEnvAppliedKeys, shouldEnableShellEnvFallback } from "../../infra/shell-env.js";
 import { withProgressTotals } from "../../cli/progress.js";
@@ -15,24 +16,34 @@ import { shortenHomePath } from "../../utils.js";
 import { resolveProviderAuthOverview } from "./list.auth-overview.js";
 import { isRich } from "./list.format.js";
 import { describeProbeSummary, formatProbeLatency, runAuthProbes, sortProbeResults, } from "./list.probe.js";
-import { DEFAULT_MODEL, DEFAULT_PROVIDER, ensureFlagCompatibility } from "./shared.js";
+import { DEFAULT_MODEL, DEFAULT_PROVIDER, ensureFlagCompatibility, resolveKnownAgentId, } from "./shared.js";
 export async function modelsStatusCommand(opts, runtime) {
     ensureFlagCompatibility(opts);
     if (opts.plain && opts.probe) {
         throw new Error("--probe cannot be used with --plain output.");
     }
     const cfg = loadConfig();
-    const resolved = resolveConfiguredModelRef({
-        cfg,
-        defaultProvider: DEFAULT_PROVIDER,
-        defaultModel: DEFAULT_MODEL,
-    });
+    const agentId = resolveKnownAgentId({ cfg, rawAgentId: opts.agent });
+    const agentDir = agentId ? resolveAgentDir(cfg, agentId) : resolveOpenClawAgentDir();
+    const agentModelPrimary = agentId ? resolveAgentModelPrimary(cfg, agentId) : undefined;
+    const agentFallbacksOverride = agentId
+        ? resolveAgentModelFallbacksOverride(cfg, agentId)
+        : undefined;
+    const resolved = agentId
+        ? resolveDefaultModelForAgent({ cfg, agentId })
+        : resolveConfiguredModelRef({
+            cfg,
+            defaultProvider: DEFAULT_PROVIDER,
+            defaultModel: DEFAULT_MODEL,
+        });
     const modelConfig = cfg.agents?.defaults?.model;
     const imageConfig = cfg.agents?.defaults?.imageModel;
-    const rawModel = typeof modelConfig === "string" ? modelConfig.trim() : (modelConfig?.primary?.trim() ?? "");
+    const rawDefaultsModel = typeof modelConfig === "string" ? modelConfig.trim() : (modelConfig?.primary?.trim() ?? "");
+    const rawModel = agentModelPrimary ?? rawDefaultsModel;
     const resolvedLabel = `${resolved.provider}/${resolved.model}`;
     const defaultLabel = rawModel || resolvedLabel;
-    const fallbacks = typeof modelConfig === "object" ? (modelConfig?.fallbacks ?? []) : [];
+    const defaultsFallbacks = typeof modelConfig === "object" ? (modelConfig?.fallbacks ?? []) : [];
+    const fallbacks = agentFallbacksOverride ?? defaultsFallbacks;
     const imageModel = typeof imageConfig === "string" ? imageConfig.trim() : (imageConfig?.primary?.trim() ?? "");
     const imageFallbacks = typeof imageConfig === "object" ? (imageConfig?.fallbacks ?? []) : [];
     const aliases = Object.entries(cfg.agents?.defaults?.models ?? {}).reduce((acc, [key, entry]) => {
@@ -42,8 +53,7 @@ export async function modelsStatusCommand(opts, runtime) {
         return acc;
     }, {});
     const allowed = Object.keys(cfg.agents?.defaults?.models ?? {});
-    const agentDir = resolveOpenClawAgentDir();
-    const store = ensureAuthProfileStore();
+    const store = ensureAuthProfileStore(agentDir);
     const modelsPath = path.join(agentDir, "models.json");
     const providersFromStore = new Set(Object.values(store.profiles)
         .map((profile) => profile.provider)
@@ -208,16 +218,25 @@ export async function modelsStatusCommand(opts, runtime) {
     if (opts.json) {
         runtime.log(JSON.stringify({
             configPath: CONFIG_PATH,
+            ...(agentId ? { agentId } : {}),
             agentDir,
             defaultModel: defaultLabel,
             resolvedDefault: resolvedLabel,
             fallbacks,
             imageModel: imageModel || null,
             imageFallbacks,
+            ...(agentId
+                ? {
+                    modelConfig: {
+                        defaultSource: agentModelPrimary ? "agent" : "defaults",
+                        fallbacksSource: agentFallbacksOverride !== undefined ? "agent" : "defaults",
+                    },
+                }
+                : {}),
             aliases,
             allowed,
             auth: {
-                storePath: resolveAuthStorePathForDisplay(),
+                storePath: resolveAuthStorePathForDisplay(agentDir),
                 shellEnvFallback: {
                     enabled: shellFallbackEnabled,
                     appliedKeys: applied,
@@ -246,13 +265,14 @@ export async function modelsStatusCommand(opts, runtime) {
     }
     const rich = isRich(opts);
     const label = (value) => colorize(rich, theme.accent, value.padEnd(14));
+    const labelWithSource = (value, source) => label(source ? `${value} (${source})` : value);
     const displayDefault = rawModel && rawModel !== resolvedLabel ? `${resolvedLabel} (from ${rawModel})` : resolvedLabel;
     runtime.log(`${label("Config")}${colorize(rich, theme.muted, ":")} ${colorize(rich, theme.info, shortenHomePath(CONFIG_PATH))}`);
     runtime.log(`${label("Agent dir")}${colorize(rich, theme.muted, ":")} ${colorize(rich, theme.info, shortenHomePath(agentDir))}`);
-    runtime.log(`${label("Default")}${colorize(rich, theme.muted, ":")} ${colorize(rich, theme.success, displayDefault)}`);
-    runtime.log(`${label(`Fallbacks (${fallbacks.length || 0})`)}${colorize(rich, theme.muted, ":")} ${colorize(rich, fallbacks.length ? theme.warn : theme.muted, fallbacks.length ? fallbacks.join(", ") : "-")}`);
-    runtime.log(`${label("Image model")}${colorize(rich, theme.muted, ":")} ${colorize(rich, imageModel ? theme.accentBright : theme.muted, imageModel || "-")}`);
-    runtime.log(`${label(`Image fallbacks (${imageFallbacks.length || 0})`)}${colorize(rich, theme.muted, ":")} ${colorize(rich, imageFallbacks.length ? theme.accentBright : theme.muted, imageFallbacks.length ? imageFallbacks.join(", ") : "-")}`);
+    runtime.log(`${labelWithSource("Default", agentId ? (agentModelPrimary ? "agent" : "defaults") : undefined)}${colorize(rich, theme.muted, ":")} ${colorize(rich, theme.success, displayDefault)}`);
+    runtime.log(`${labelWithSource(`Fallbacks (${fallbacks.length || 0})`, agentId ? (agentFallbacksOverride !== undefined ? "agent" : "defaults") : undefined)}${colorize(rich, theme.muted, ":")} ${colorize(rich, fallbacks.length ? theme.warn : theme.muted, fallbacks.length ? fallbacks.join(", ") : "-")}`);
+    runtime.log(`${labelWithSource("Image model", agentId ? "defaults" : undefined)}${colorize(rich, theme.muted, ":")} ${colorize(rich, imageModel ? theme.accentBright : theme.muted, imageModel || "-")}`);
+    runtime.log(`${labelWithSource(`Image fallbacks (${imageFallbacks.length || 0})`, agentId ? "defaults" : undefined)}${colorize(rich, theme.muted, ":")} ${colorize(rich, imageFallbacks.length ? theme.accentBright : theme.muted, imageFallbacks.length ? imageFallbacks.join(", ") : "-")}`);
     runtime.log(`${label(`Aliases (${Object.keys(aliases).length || 0})`)}${colorize(rich, theme.muted, ":")} ${colorize(rich, Object.keys(aliases).length ? theme.accent : theme.muted, Object.keys(aliases).length
         ? Object.entries(aliases)
             .map(([alias, target]) => rich
@@ -263,7 +283,7 @@ export async function modelsStatusCommand(opts, runtime) {
     runtime.log(`${label(`Configured models (${allowed.length || 0})`)}${colorize(rich, theme.muted, ":")} ${colorize(rich, allowed.length ? theme.info : theme.muted, allowed.length ? allowed.join(", ") : "all")}`);
     runtime.log("");
     runtime.log(colorize(rich, theme.heading, "Auth overview"));
-    runtime.log(`${label("Auth store")}${colorize(rich, theme.muted, ":")} ${colorize(rich, theme.info, shortenHomePath(resolveAuthStorePathForDisplay()))}`);
+    runtime.log(`${label("Auth store")}${colorize(rich, theme.muted, ":")} ${colorize(rich, theme.info, shortenHomePath(resolveAuthStorePathForDisplay(agentDir)))}`);
     runtime.log(`${label("Shell env")}${colorize(rich, theme.muted, ":")} ${colorize(rich, shellFallbackEnabled ? theme.success : theme.muted, shellFallbackEnabled ? "on" : "off")}${applied.length ? colorize(rich, theme.muted, ` (applied: ${applied.join(", ")})`) : ""}`);
     runtime.log(`${label(`Providers w/ OAuth/tokens (${providersWithOauth.length || 0})`)}${colorize(rich, theme.muted, ":")} ${colorize(rich, providersWithOauth.length ? theme.info : theme.muted, providersWithOauth.length ? providersWithOauth.join(", ") : "-")}`);
     const formatKey = (key) => colorize(rich, theme.warn, key);

package/dist/commands/models/shared.js

@@ -1,6 +1,9 @@
 import { DEFAULT_MODEL, DEFAULT_PROVIDER } from "../../agents/defaults.js";
 import { buildModelAliasIndex, modelKey, parseModelRef, resolveModelRefFromString, } from "../../agents/model-selection.js";
+import { listAgentIds } from "../../agents/agent-scope.js";
+import { formatCliCommand } from "../../cli/command-format.js";
 import { readConfigFileSnapshot, writeConfigFile, } from "../../config/config.js";
+import { normalizeAgentId } from "../../routing/session-key.js";
 export const ensureFlagCompatibility = (opts) => {
     if (opts.json && opts.plain) {
         throw new Error("Choose either --json or --plain, not both.");
@@ -67,6 +70,17 @@ export function normalizeAlias(alias) {
     }
     return trimmed;
 }
+export function resolveKnownAgentId(params) {
+    const raw = params.rawAgentId?.trim();
+    if (!raw)
+        return undefined;
+    const agentId = normalizeAgentId(raw);
+    const knownAgents = listAgentIds(params.cfg);
+    if (!knownAgents.includes(agentId)) {
+        throw new Error(`Unknown agent id "${raw}". Use "${formatCliCommand("openclaw agents list")}" to see configured agents.`);
+    }
+    return agentId;
+}
 export { modelKey };
 export { DEFAULT_MODEL, DEFAULT_PROVIDER };
 /**