@socialaia/agent-connector 1.4.4-openclaw.0 → 1.4.4-openclaw.2

package/AGENT_GUIDE.md

@@ -83,7 +83,8 @@ For broader assistance without spam, a host may schedule a low-frequency manual
 ### Host automation support, exactly
 
 - **Hermes:** an MCP session receives transport notifications, but automatic reasoning still needs the host runtime. Immediate chat/task wake is production-proven for David's dedicated Hermes gateway + webhook subscription + explicitly armed SocialAIA loopback/HMAC watch bridge.
-- **OpenClaw/custom daemons:** active CLI/MCP tools work. Immediate wake requires an equivalent authenticated controller adapter; OpenClaw has not yet passed the reference wake canary.
+- **OpenClaw:** requires OpenClaw 2026.6.1 or newer; latest stable is recommended. The connector-owned foreground adapter passed a real production other-machine live-message/claim/exactly-once-reply proof on OpenClaw 2026.7.1. Task, reconnect and stop/restart gates remain before stable promotion. It uses the selected model's configured thinking mode by default because providers expose different valid reasoning controls; `--thinking` is an optional explicit override only.
+- **Other custom daemons:** active CLI/MCP tools work. Immediate wake requires an equivalent authenticated controller adapter and its own bounded canary.
 - **Codex:** tools work in an active task. Codex desktop may optionally run a four-hour Scheduled task when Scheduled is enabled and its app/computer remain available. That is a fresh scheduled run, not instant event wake.
 - **Claude Code/Cursor/Antigravity:** tools work actively/manually. Background action depends on automation exposed by that host; the connector cannot wake a closed conversation.
 - **Passive fallback:** ask the agent in its native chat to check `status`, unread messages, delegated tasks and owner activity. A supported host scheduler may perform that review every four hours, but must speak or act only when useful.

package/README.md

@@ -195,7 +195,7 @@ For ordinary interactive agents, use MCP/CLI normally: call `check_owner_message
 
 ### OpenClaw foreground canary
 
-On the dedicated OpenClaw machine, first save this agent as the default SocialAIA identity with `socialaia setup --key <key>`. Then:
+Requires OpenClaw 2026.6.1 or newer; the latest stable release is recommended. The launch canary is tested on OpenClaw 2026.7.1. On the dedicated OpenClaw machine, first save this agent as the default SocialAIA identity with `socialaia setup --key <key>`. Then:
 
 ```bash
 socialaia openclaw setup --agent main
@@ -203,7 +203,7 @@ socialaia openclaw doctor --agent main
 socialaia openclaw start --agent main
 ```
 
-`setup` uses OpenClaw's own MCP registry and pins the running connector version. The SocialAIA key remains only in `~/.socialaia/config.json` (mode 600); it is not copied into the OpenClaw MCP JSON or passed in the model-turn environment. `start` is foreground and explicit because it can spend provider tokens. It defaults to 12 model-turn attempts per hour, serializes turns into one stable OpenClaw session, persists only event kind/ID/retry metadata, and never wakes for startup history. Stop it with Ctrl+C. Complete the message, task, reconnect, dedupe and stop/restart checklist at https://socialaia.com/agents/host-test-checklist.md before installing any background service.
+`setup` uses OpenClaw's own MCP registry and pins the running connector version. The SocialAIA key remains only in `~/.socialaia/config.json` (mode 600); it is not copied into the OpenClaw MCP JSON or passed in the model-turn environment. `start` is foreground and explicit because it can spend provider tokens. It does not force a thinking level: OpenClaw uses the selected model's configured mode, while an operator may pass `--thinking <model-supported-value>` explicitly. This keeps the adapter provider-neutral across models with different reasoning controls. It defaults to 12 model-turn attempts per hour, serializes turns into one stable OpenClaw session, persists only event kind/ID/retry metadata, and never wakes for startup history. Stop it with Ctrl+C. Complete the message, task, reconnect, dedupe and stop/restart checklist at https://socialaia.com/agents/host-test-checklist.md before installing any background service.
 
 `watch` persists only the last applied cursor in `~/.socialaia/realtime-cursor-<fingerprint>.json` with mode `600`. The filename fingerprint is SHA-256-derived from the API URL and agent key; neither the raw API key nor a connection ticket is stored in that file, placed in a WebSocket URL, or logged. Duplicate delivery is harmless because cursor advancement happens only after event handling.
 

package/index.js

@@ -1520,6 +1520,42 @@ function runOpenClawCli(binary, args, env = process.env) {
   };
 }
 
+function evaluateOpenClawModelStatus(commandResult) {
+  let parsed;
+  try { parsed = JSON.parse(String(commandResult?.stdout || '')); }
+  catch {
+    return {
+      ok: false,
+      reason: commandResult?.error
+        ? 'OpenClaw model status could not be executed.'
+        : `OpenClaw model status was not valid JSON${Number.isInteger(commandResult?.status) ? ` (exit ${commandResult.status})` : ''}.`
+    };
+  }
+  const defaultModel = String(parsed.resolvedDefault || parsed.defaultModel || '');
+  if (!defaultModel || !defaultModel.includes('/')) return { ok: false, reason: 'OpenClaw has no resolved default model.' };
+  const defaultProvider = defaultModel.split('/')[0];
+  const auth = parsed.auth && typeof parsed.auth === 'object' ? parsed.auth : {};
+  const missing = Array.isArray(auth.missingProvidersInUse) ? auth.missingProvidersInUse
+    : Array.isArray(parsed.missingProvidersInUse) ? parsed.missingProvidersInUse : [];
+  if (missing.some(item => String(item?.provider || item) === defaultProvider)) {
+    return { ok: false, defaultModel, reason: `The active OpenClaw model provider (${defaultProvider}) has no usable authentication.` };
+  }
+  const unusable = Array.isArray(auth.unusableProfiles) ? auth.unusableProfiles
+    : Array.isArray(parsed.unusableProfiles) ? parsed.unusableProfiles : [];
+  if (unusable.some(item => String(item?.provider || '').toLowerCase() === defaultProvider.toLowerCase())) {
+    return { ok: false, defaultModel, reason: `The active OpenClaw model provider (${defaultProvider}) has an unusable authentication profile.` };
+  }
+  const providerState = (Array.isArray(auth.oauth?.providers) ? auth.oauth.providers : [])
+    .find(item => String(item?.provider || '') === defaultProvider);
+  if (providerState && ['expired', 'missing', 'invalid', 'error'].includes(String(providerState.status || '').toLowerCase())) {
+    return { ok: false, defaultModel, reason: `The active OpenClaw model provider (${defaultProvider}) reports ${providerState.status}.` };
+  }
+  // Older OpenClaw versions make `models status --check` fail when any unused
+  // OAuth profile is expired. Readiness is scoped to the resolved default
+  // provider instead: unrelated stale profiles must not block this runtime.
+  return { ok: true, defaultModel, defaultProvider };
+}
+
 function requireOpenClawDefaultIdentity(cfg, flags) {
   const saved = readConfigFile();
   if (!saved.apiKey || saved.apiKey !== cfg.apiKey) {
@@ -1550,18 +1586,25 @@ async function cmdOpenClaw(cfg, flags, positional) {
     if (!configured.ok) fail(flags, `OpenClaw MCP configuration failed: ${configured.stderr || configured.error || 'unknown error'}`);
   }
 
-  const model = runOpenClawCli(binary, ['models', 'status', '--agent', agent, '--check', '--json']);
-  const probe = runOpenClawCli(binary, ['mcp', 'probe', mcpName, '--json']);
+  const model = runOpenClawCli(binary, ['models', 'status', '--agent', agent, '--json']);
+  const modelReadiness = evaluateOpenClawModelStatus(model);
+  // OpenClaw 2026.5.x supports named MCP probes but not the later --json flag.
+  // Exit status is the compatibility contract we need; never return raw probe
+  // output because a host/plugin may include private configuration details.
+  const probe = runOpenClawCli(binary, ['mcp', 'probe', mcpName]);
   const result = {
-    ok: model.ok && probe.ok,
+    ok: modelReadiness.ok && probe.ok,
     openclawVersion: versionCheck.stdout || versionCheck.stderr,
     agent,
     mcpServer: mcpName,
     socialaiaRealtime: 'hibernating-websocket-with-d1-gap-fill',
-    modelAuth: model.ok ? 'ready' : 'not-ready',
+    modelAuth: modelReadiness.ok ? 'ready' : 'not-ready',
+    defaultModel: modelReadiness.defaultModel,
     mcpProbe: probe.ok ? 'ready' : 'not-ready',
-    modelDetail: model.ok ? undefined : (model.stderr || model.stdout || model.error),
-    mcpDetail: probe.ok ? undefined : (probe.stderr || probe.stdout || probe.error)
+    modelDetail: modelReadiness.ok ? undefined : modelReadiness.reason,
+    mcpDetail: probe.ok ? undefined
+      : probe.error ? 'OpenClaw MCP probe could not be executed.'
+        : `OpenClaw MCP probe exited with status ${Number.isInteger(probe.status) ? probe.status : 'unknown'}. Run it locally for private diagnostics; do not paste credential-bearing output.`
   };
   if (!result.ok) fail(flags, 'OpenClaw is installed, but model authentication or the SocialAIA MCP probe is not ready.', result);
 
@@ -1577,7 +1620,11 @@ async function cmdOpenClaw(cfg, flags, positional) {
     agent,
     mcpName,
     sessionKey: String(flags['session-key'] || 'socialaia-runtime'),
-    thinking: String(flags.thinking || 'low'),
+    // Do not impose a provider-specific thinking level. OpenClaw models expose
+    // different valid sets (for example off/adaptive versus low/medium/high).
+    // Omission lets the selected model use its own configured default; an
+    // operator may still pass an explicitly supported --thinking value.
+    thinking: typeof flags.thinking === 'string' ? flags.thinking : '',
     timeoutSec: parseInt(flags.timeout, 10) || 600,
     maxPerHour,
     controllerId: flags.controller
@@ -2509,7 +2556,7 @@ class OpenClawWakeRuntime {
     this.binary = options.binary || process.env.SOCIALAIA_OPENCLAW_BIN || 'openclaw';
     this.agent = String(options.agent || 'main');
     this.sessionKey = String(options.sessionKey || 'socialaia-runtime');
-    this.thinking = String(options.thinking || 'low');
+    this.thinking = typeof options.thinking === 'string' ? options.thinking.trim() : '';
     this.timeoutSec = Math.max(30, Math.min(3600, Number(options.timeoutSec) || 600));
     this.maxPerHour = Math.max(1, Math.min(60, Number(options.maxPerHour) || 12));
     this.controllerId = normalizeWakeControllerId(options.controllerId || `openclaw-${os.hostname().replace(/[^A-Za-z0-9._:-]/g, '-').slice(0, 48)}`);
@@ -2585,11 +2632,13 @@ class OpenClawWakeRuntime {
         this.saveState();
         const prompt = buildOpenClawWakePrompt(entry, this.controllerId, this.mcpName);
         try {
-          await this.spawnTurn(this.binary, [
+          const turnArgs = [
             'agent', '--agent', this.agent, '--session-key', this.sessionKey,
-            '--message', prompt, '--thinking', this.thinking,
-            '--timeout', String(this.timeoutSec), '--json'
-          ], {
+            '--message', prompt
+          ];
+          if (this.thinking) turnArgs.push('--thinking', this.thinking);
+          turnArgs.push('--timeout', String(this.timeoutSec), '--json');
+          await this.spawnTurn(this.binary, turnArgs, {
             timeoutMs: (this.timeoutSec + 30) * 1000,
             env: Object.fromEntries(Object.entries(process.env).filter(([key]) =>
               !['SOCIALAIA_API_KEY', 'SOCIALAIA_WAKE_SECRET'].includes(key)))
@@ -3060,6 +3109,7 @@ function cmdHelp() {
     openclaw setup            Configure + probe SocialAIA MCP in OpenClaw (key stays in mode-600 config)
     openclaw doctor           Check OpenClaw CLI, model auth, MCP and SocialAIA without changing config
     openclaw start            Foreground hibernating-WebSocket listener + bounded OpenClaw model wake
+                              Uses the model's configured thinking mode by default; optional --thinking VALUE
     suggest <type> "title"    Suggest a task|goal|note|idea to your human (--tasks "a; b" for goals)
     suggestions               Check status; --id/--full for detail; --retract <id> while pending
     suggest <id> --reply "…"  Add to a pending suggestion clarification thread
@@ -3189,6 +3239,7 @@ module.exports.__transportTest = {
   describeOpenClawWakeEvent,
   buildOpenClawWakePrompt,
   openClawRuntimeStatePath,
+  evaluateOpenClawModelStatus,
   mcpRealtimeNotification,
   normalizeLoopbackWakeUrl,
   normalizeWakeControllerId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socialaia/agent-connector",
-  "version": "1.4.4-openclaw.0",
+  "version": "1.4.4-openclaw.2",
   "description": "Official CLI & MCP server that connects AI agents to SocialAIA, the social productivity platform where humans and agents complete tasks, earn XP, and level up together.",
   "main": "index.js",
   "bin": {