coze_lab 0.1.33 → 0.1.35

package/index.js

@@ -5172,6 +5172,7 @@ function writeClaudeCodeHook(patToken, workspaceId, pythonCmd, configBaseDir, cl
   const hooksDir    = path.join(os.homedir(), '.claude', 'hooks');
   const hookScript  = path.join(hooksDir, 'cozeloop_hook.py');
   const baseDir     = configBaseDir || process.cwd();
+  const logFile     = path.join(baseDir, '.claude', 'hooks', 'cozeloop.log');
   // per-agent 时 settings.json 写进 agent 的 .claude；全局时仍写 ~/.claude/settings.json。
   const claudeDir   = configBaseDir
     ? path.join(baseDir, '.claude')
@@ -5218,9 +5219,11 @@ function writeClaudeCodeHook(patToken, workspaceId, pythonCmd, configBaseDir, cl
 
   // 3. Write credentials into <baseDir>/.claude/settings.local.json
   ensureDir(path.join(baseDir, '.claude'));
+  ensureDir(path.dirname(logFile));
   const localSettings = mergeJson(localSettingsPath, (existing) => {
     if (!existing.env) existing.env = {};
     existing.env.COZELOOP_WORKSPACE_ID = workspaceId;
+    existing.env.COZELOOP_HOOK_LOG = logFile;
     if (cloud) {
       const loopToken = readEnv('COZELOOP_API_TOKEN');
       const cozeToken = readEnv('COZE_API_TOKEN');
@@ -5259,7 +5262,7 @@ function writeClaudeCodeHook(patToken, workspaceId, pythonCmd, configBaseDir, cl
   ok(`Credentials written to ${localSettingsPath}`);
 
 
-  return { hookScript, settingsPath, localSettingsPath };
+  return { hookScript, settingsPath, localSettingsPath, logFile };
 }
 
 // writeCodexHook 把 hook 写进指定的 CODEX_HOME。codexHome 缺省 ~/.codex；
@@ -5386,33 +5389,32 @@ function normalizeTraceAgentIds(ids) {
 }
 
 function getCloudCozeloopApiBaseUrl() {
-  const raw = process.env.COZELOOP_API_BASE_URL || process.env.OTEL_ENDPOINT || '';
+  const raw = process.env.COZELOOP_API_BASE_URL || '';
   return normalizeCozeloopApiBaseUrl(raw);
 }
 
 function normalizeCozeloopApiBaseUrl(raw) {
-  const base = raw.trim().replace(/\/+$/, '');
+  const base = (raw || '').trim().replace(/\/+$/, '');
   if (!base) return '';
-  if (base.endsWith('/v1/loop/traces/ingest')) {
-    return base.slice(0, -'/v1/loop/traces/ingest'.length).replace(/\/+$/, '');
-  }
-  if (base.endsWith('/api/v1/loop/traces/ingest')) {
-    return base.slice(0, -'/v1/loop/traces/ingest'.length).replace(/\/+$/, '');
-  }
-  if (base.endsWith('/v1/loop/opentelemetry/v1/traces')) {
-    return base.slice(0, -'/v1/loop/opentelemetry/v1/traces'.length).replace(/\/+$/, '');
-  }
-  if (base.endsWith('/api/v1/loop/opentelemetry/v1/traces')) {
-    return base.slice(0, -'/v1/loop/opentelemetry/v1/traces'.length).replace(/\/+$/, '');
-  }
-  if (base.endsWith('/v1/loop/opentelemetry')) {
-    return base.slice(0, -'/v1/loop/opentelemetry'.length).replace(/\/+$/, '');
-  }
-  if (base.endsWith('/api/v1/loop/opentelemetry')) {
-    return base.slice(0, -'/v1/loop/opentelemetry'.length).replace(/\/+$/, '');
-  }
-  if (base.endsWith('/api/v1')) {
-    return base.slice(0, -'/v1'.length).replace(/\/+$/, '');
+  // 剥除已知 loop 路径后缀，还原出纯 API base。
+  // 关键：cozeloop ingest 正确端点是 <host>/v1/loop/traces/ingest，【不带 /api 前缀】。
+  // 含 /api 的变体必须连 /api 一起剥掉 —— 否则残留 /api 会拼出 /api/v1/loop/traces/ingest，
+  // 命中不处理 ingest 协议的网关入口 → 后端 400 "unknown event type"。
+  // 顺序约定：更长 / 带 /api 的变体在前，最短的裸 /v1 在最后，避免 endsWith 误匹配短后缀。
+  const suffixes = [
+    '/api/v1/loop/traces/ingest',
+    '/v1/loop/traces/ingest',
+    '/api/v1/loop/opentelemetry/v1/traces',
+    '/v1/loop/opentelemetry/v1/traces',
+    '/api/v1/loop/opentelemetry',
+    '/v1/loop/opentelemetry',
+    '/api/v1',
+    '/v1',
+  ];
+  for (const suffix of suffixes) {
+    if (base.endsWith(suffix)) {
+      return base.slice(0, -suffix.length).replace(/\/+$/, '');
+    }
   }
   return base;
 }
@@ -5445,7 +5447,41 @@ function getCozeloopIngestUrl(cloud) {
   return getCozeloopIngestUrlFromBase(getCozeloopApiBaseUrl(cloud));
 }
 
-function applyOpenClawPluginConfig(existing, token, workspaceId, agentId, cloud) {
+function buildOpenClawSelfcheckTags(pcfg, workspaceId, pair) {
+  const tags = {
+    pair_code: pair,
+    source: 'cozelab-onboard-openclaw',
+  };
+  const allowlist = normalizeTraceAgentIds(pcfg?.traceAgentIds);
+  if (allowlist[0]) {
+    tags.coze_agent_id = allowlist[0];
+  }
+  const sessionId = readEnv('COZELOOP_SELF_CHECK_SESSION_ID')
+    || readEnv('COZE_SESSION_ID')
+    || readEnv('COZELOOP_SESSION_ID');
+  if (sessionId) {
+    tags.coze_session_id = sessionId;
+  }
+  const messageId = readEnv('COZELOOP_SELF_CHECK_MESSAGE_ID')
+    || readEnv('COZE_MESSAGE_ID')
+    || readEnv('COZELOOP_MESSAGE_ID')
+    || `cozelab-onboard-${pair}`;
+  tags.coze_message_id = messageId;
+  const groupId = readEnv('COZE_GROUP_ID') || readEnv('COZELOOP_GROUP_ID');
+  if (groupId) {
+    tags.coze_group_id = groupId;
+  }
+  const accountId = readEnv('COZE_ACCOUNT_ID') || readEnv('COZELOOP_ACCOUNT_ID');
+  if (accountId) {
+    tags.coze_account_id = accountId;
+  }
+  if (workspaceId) {
+    tags.coze_workspace_id = String(workspaceId);
+  }
+  return tags;
+}
+
+function applyOpenClawPluginConfig(existing, token, workspaceId, agentId, cloud, logFile) {
   if (!existing.plugins)         existing.plugins = {};
   if (!existing.plugins.allow)   existing.plugins.allow = [];
   if (!existing.plugins.entries) existing.plugins.entries = {};
@@ -5469,6 +5505,9 @@ function applyOpenClawPluginConfig(existing, token, workspaceId, agentId, cloud)
   pcfg.endpoint      = getCozeloopApiBaseUrl(cloud);
   pcfg.workspaceId   = workspaceId;
   pcfg.debug         = true;
+  if (logFile) {
+    pcfg.logFile = logFile;
+  }
   pcfg.disableLocalCredentials = !!cloud;
   // 插件代码版本：参与幂等比对，升级插件（bump scripts/openclaw/package.json version）后
   // 强制触发重写+重装+重启，避免云端 pluginDir 滞留旧插件 dist。
@@ -5487,7 +5526,7 @@ function applyOpenClawPluginConfig(existing, token, workspaceId, agentId, cloud)
   return existing;
 }
 
-function isOpenClawAlreadyInjected(configPath, pluginDir, token, workspaceId, agentId, cloud) {
+function isOpenClawAlreadyInjected(configPath, pluginDir, token, workspaceId, agentId, cloud, logFile) {
   if (!fs.existsSync(pluginDir)) return false;
   let existing;
   try {
@@ -5501,14 +5540,16 @@ function isOpenClawAlreadyInjected(configPath, pluginDir, token, workspaceId, ag
     workspaceId,
     agentId,
     cloud,
+    logFile,
   );
   return JSON.stringify(existing) === JSON.stringify(desired);
 }
 
-function writeOpenClawHook(token, workspaceId, agentId, cloud) {
+function writeOpenClawHook(token, workspaceId, agentId, cloud, force) {
   const home       = resolveHomeDir(cloud);
   const configPath = path.join(home, '.openclaw', 'openclaw.json');
   const pluginDir  = path.join(home, '.cozeloop', 'openclaw-plugin');
+  const logFile    = path.join(pluginDir, 'cozeloop.log');
 
   if (!fs.existsSync(configPath)) {
     errorBox([
@@ -5519,10 +5560,13 @@ function writeOpenClawHook(token, workspaceId, agentId, cloud) {
     ]);
   }
 
-  if (isOpenClawAlreadyInjected(configPath, pluginDir, token, workspaceId, agentId, cloud)) {
+  if (!force && isOpenClawAlreadyInjected(configPath, pluginDir, token, workspaceId, agentId, cloud, logFile)) {
     ok(`OpenClaw plugin already configured in ${configPath}`);
     info('OpenClaw gateway restart skipped (configuration unchanged).');
-    return { configPath, pluginDir, unchanged: true, gatewayRestarted: false, gatewayRestartSkipped: true };
+    return { configPath, pluginDir, logFile, unchanged: true, gatewayRestarted: false, gatewayRestartSkipped: true };
+  }
+  if (force) {
+    info('OpenClaw force mode enabled; rewriting plugin files and reinstalling.');
   }
 
   // 1. Write plugin files to ~/.cozeloop/openclaw-plugin/
@@ -5575,7 +5619,7 @@ function writeOpenClawHook(token, workspaceId, agentId, cloud) {
 
   // 4. Update openclaw.json with token and workspace
   const config = mergeJson(configPath, (existing) => {
-    return applyOpenClawPluginConfig(existing, token, workspaceId, agentId, cloud);
+    return applyOpenClawPluginConfig(existing, token, workspaceId, agentId, cloud, logFile);
   });
 
   try {
@@ -5591,10 +5635,10 @@ function writeOpenClawHook(token, workspaceId, agentId, cloud) {
     info('Restarting OpenClaw gateway to apply hook changes...');
     execSync('openclaw gateway restart', { stdio: 'pipe' });
     ok('OpenClaw gateway restarted');
-    return { configPath, pluginDir, gatewayRestarted: true };
+    return { configPath, pluginDir, logFile, gatewayRestarted: true };
   } catch (e) {
     warn(`gateway restart 失败，请手动执行: openclaw gateway restart（${e.message}）`);
-    return { configPath, pluginDir, gatewayRestarted: false, gatewayRestartError: e.message };
+    return { configPath, pluginDir, logFile, gatewayRestarted: false, gatewayRestartError: e.message };
   }
 }
 
@@ -5749,6 +5793,8 @@ except Exception as e:
     x_use_ppe: PPE_USE_PPE,
   };
   if (apiBase) env.COZELOOP_API_BASE_URL = apiBase;
+  // 打出 SDK 实际使用的 ingest base，便于核对云端注入的 api_base_url 是否正确（无 /api 残留）。
+  info(`trace 上报 URL: ${getCozeloopIngestUrlFromBase(apiBase || COZE_API)} (api_base_url=${apiBase || '(default)'})`);
   const result = await runCommand({
     cmd: pythonCmd || 'python3',
     args: ['-c', script],
@@ -5812,6 +5858,7 @@ async function verifyTraceReport(token, workspaceId, pairCode, tracesUrl) {
 
   let res;
   const url = tracesUrl || getOtelTracesUrl(false);
+  info(`trace 上报 URL: ${url}`);
   try {
     res = await httpsPost(
       url,
@@ -5867,6 +5914,8 @@ async function verifyOpenClawTraceLink(cloud) {
   // 1) 用插件【实际配置的】token 打一条最小 CozeLoop ingest trace ——这才是运行时真实用的那个 token。
   const authHeader = pcfg.authorization; // 形如 "Bearer czu_xxx"
   const tracesUrl = getCozeloopIngestUrlFromBase(normalizeCozeloopApiBaseUrl(pcfg.endpoint || getCozeloopApiBaseUrl(cloud)));
+  // 打出实际 ingest URL —— 云端只能看 stdout，借此立即发现 URL 是否仍残留 /api 前缀（400 根因）。
+  info(`openclaw ingest URL: ${tracesUrl} (plugin endpoint=${pcfg.endpoint || '(default)'})`);
   const workspaceId = pcfg.workspaceId || WORKSPACE_ID;
   const traceId = crypto.randomBytes(16).toString('hex');
   const spanId = crypto.randomBytes(8).toString('hex');
@@ -5880,7 +5929,7 @@ async function verifyOpenClawTraceLink(cloud) {
       parent_id: '0',
       trace_id: traceId,
       duration_micros: 1,
-      service_name: 'cozelab-onboard-openclaw',
+      service_name: '',
       workspace_id: String(workspaceId),
       span_name: 'cozelab-onboard-openclaw-selfcheck',
       span_type: 'main',
@@ -5889,14 +5938,16 @@ async function verifyOpenClawTraceLink(cloud) {
       output: 'ok',
       object_storage: '',
       system_tags_string: {
-        runtime: JSON.stringify({ language: 'nodejs', library: 'openclaw', scene: process.env.COZELOOP_SCENE || 'custom' }),
+        runtime: JSON.stringify({
+          language: 'nodejs',
+          library: 'openclaw',
+          scene: process.env.COZELOOP_SCENE || 'custom',
+          loop_sdk_version: `coze_lab@${PACKAGE_VERSION}`,
+        }),
       },
       system_tags_long: {},
       system_tags_double: {},
-      tags_string: {
-        pair_code: pair,
-        source: 'cozelab-onboard-openclaw',
-      },
+      tags_string: buildOpenClawSelfcheckTags(pcfg, workspaceId, pair),
       tags_long: {},
       tags_double: {},
       tags_bool: {},
@@ -5907,7 +5958,18 @@ async function verifyOpenClawTraceLink(cloud) {
     res = await httpsPost(
       tracesUrl,
       ingestBody,
-      { Authorization: authHeader },
+      {
+        Authorization: authHeader,
+        'User-Agent': `coze_lab/${PACKAGE_VERSION} node/${process.versions.node}`,
+        'X-Coze-Client-User-Agent': JSON.stringify({
+          version: PACKAGE_VERSION,
+          lang: 'nodejs',
+          lang_version: process.versions.node,
+          os_name: process.platform,
+          scene: 'cozeloop',
+          source: 'openapi',
+        }),
+      },
     );
   } catch (e) {
     warn(`openclaw 插件 token 上报探测失败: ${e.message}`);
@@ -6424,7 +6486,7 @@ async function main() {
     written = writeCodexHook(token, WORKSPACE_ID, pythonCmd, codexHome, args.cloud);
   } else {
     // openclaw：云端用 traceAgentIds allowlist 做 per-agent 放行。
-    written = writeOpenClawHook(token, WORKSPACE_ID, args.agentId, args.cloud) || {};
+    written = writeOpenClawHook(token, WORKSPACE_ID, args.agentId, args.cloud, args.force) || {};
   }
   // 走到这里说明 detectAgent / 环境检查 / 写 hook 配置全部成功 → 注入成功。
   cloudResult.inject = 'ok';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coze_lab",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "description": "Configure local AI agents (Claude Code, Codex, OpenClaw) to report traces to CozeLoop",
   "keywords": [
     "cozeloop",

package/scripts/claude-code/cozeloop_hook.py

@@ -212,16 +212,41 @@ def _make_finish_event_processor(upload_events: Optional[List[str]] = None):
             logid = _extract_logid(detail)
             if logid:
                 print(f"[CozeLoop] 上报失败 logid={logid} (可用 bytedcli log get-logid-log {logid} 排查)", file=sys.stderr)
+                hook_log(f"upload FAILED logid={logid} detail={detail[:300]}")
             else:
                 print(f"[CozeLoop] 上报失败: {detail[:300]}", file=sys.stderr)
+                hook_log(f"upload FAILED detail={detail[:300]}")
         except Exception:
             pass
     return _processor
 
 
 
+def _log_file_path() -> str:
+    return os.environ.get("COZELOOP_HOOK_LOG", "").strip()
+
+
+def hook_log(message: str):
+    """Append one diagnostic line to the hook log, if configured.
+
+    onboard writes COZELOOP_HOOK_LOG into settings.local.json (env), so this
+    captures runtime upload diagnostics even when stderr is not visible.
+    """
+    log_path = _log_file_path()
+    if not log_path:
+        return
+    try:
+        p = Path(log_path).expanduser()
+        p.parent.mkdir(parents=True, exist_ok=True)
+        with p.open("a", encoding="utf-8") as f:
+            f.write(f"{datetime.now().isoformat()} {message}\n")
+    except Exception:
+        pass
+
+
 def debug_log(message: str):
-    """Print debug message if debug mode is enabled."""
+    """Print debug message if debug mode is enabled; always append to hook log."""
+    hook_log(f"DEBUG {message}")
     if DEBUG:
         print(f"[COZELOOP_HOOK_DEBUG] {datetime.now().isoformat()} - {message}", file=sys.stderr)
 
@@ -281,16 +306,22 @@ def _refresh_token(refresh_token: str) -> Optional[str]:
 
 def _normalize_api_base_url(url: str) -> str:
     base = (url or "").strip().rstrip("/")
-    if base.endswith(_OTEL_SUFFIX + "/v1/traces"):
-        return base[:-len(_OTEL_SUFFIX + "/v1/traces")].rstrip("/")
-    if base.endswith("/api/v1/loop/opentelemetry/v1/traces"):
-        return base[:-len("/v1/loop/opentelemetry/v1/traces")].rstrip("/")
-    if base.endswith(_OTEL_SUFFIX):
-        return base[:-len(_OTEL_SUFFIX)].rstrip("/")
-    if base.endswith("/api/v1/loop/opentelemetry"):
-        return base[:-len("/v1/loop/opentelemetry")].rstrip("/")
-    if base.endswith("/api/v1"):
-        return base[:-len("/v1")].rstrip("/")
+    if not base:
+        return base
+    # 剥除已知 loop 路径后缀，还原纯 API base。
+    # 关键：含 /api 的变体必须连 /api 整体剥掉，否则残留 /api 会拼出 /api/v1/loop/... → 后端 400。
+    # 顺序：更长 / 带 /api 的在前，裸 /v1 最后，避免误匹配短后缀。
+    suffixes = (
+        "/api/v1/loop/opentelemetry/v1/traces",
+        _OTEL_SUFFIX + "/v1/traces",
+        "/api/v1/loop/opentelemetry",
+        _OTEL_SUFFIX,
+        "/api/v1",
+        "/v1",
+    )
+    for suffix in suffixes:
+        if base.endswith(suffix):
+            return base[:-len(suffix)].rstrip("/")
     return base
 
 def get_api_base_url() -> str:
@@ -970,6 +1001,11 @@ def send_turns_to_cozeloop(turns: List[Dict[str, Any]], session_id: str, history
     api_base_url = get_api_base_url()
     if api_base_url:
         client_kwargs["api_base_url"] = api_base_url
+    hook_log(
+        f"init client session={session_id} workspace={workspace_id} "
+        f"token={(token[:12] + '...') if token else 'none'} "
+        f"api_base_url={api_base_url or '(default)'}"
+    )
     client = cozeloop.new_client(**client_kwargs)
 
     try:

package/scripts/codex/cozeloop_hook.py

@@ -218,16 +218,22 @@ def _refresh_token(refresh_tok: str):
 
 def _normalize_api_base_url(url: str) -> str:
     base = (url or "").strip().rstrip("/")
-    if base.endswith(_OTEL_SUFFIX + "/v1/traces"):
-        return base[:-len(_OTEL_SUFFIX + "/v1/traces")].rstrip("/")
-    if base.endswith("/api/v1/loop/opentelemetry/v1/traces"):
-        return base[:-len("/v1/loop/opentelemetry/v1/traces")].rstrip("/")
-    if base.endswith(_OTEL_SUFFIX):
-        return base[:-len(_OTEL_SUFFIX)].rstrip("/")
-    if base.endswith("/api/v1/loop/opentelemetry"):
-        return base[:-len("/v1/loop/opentelemetry")].rstrip("/")
-    if base.endswith("/api/v1"):
-        return base[:-len("/v1")].rstrip("/")
+    if not base:
+        return base
+    # 剥除已知 loop 路径后缀，还原纯 API base。
+    # 关键：含 /api 的变体必须连 /api 整体剥掉，否则残留 /api 会拼出 /api/v1/loop/... → 后端 400。
+    # 顺序：更长 / 带 /api 的在前，裸 /v1 最后，避免误匹配短后缀。
+    suffixes = (
+        "/api/v1/loop/opentelemetry/v1/traces",
+        _OTEL_SUFFIX + "/v1/traces",
+        "/api/v1/loop/opentelemetry",
+        _OTEL_SUFFIX,
+        "/api/v1",
+        "/v1",
+    )
+    for suffix in suffixes:
+        if base.endswith(suffix):
+            return base[:-len(suffix)].rstrip("/")
     return base
 
 

package/scripts/openclaw/dist/cozeloop-exporter.js

@@ -5,13 +5,21 @@ import { ATTR_SERVICE_NAME, ATTR_SERVICE_INSTANCE_ID } from "@opentelemetry/sema
 import { hostname } from "os";
 import { basename, join } from "path";
 import { createRequire } from "node:module";
-import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { readFileSync, writeFileSync, mkdirSync, appendFileSync } from "fs";
 import { homedir } from "os";
 import http from "http";
 import https from "https";
 
 const require = createRequire(import.meta.url);
 const { version: PLUGIN_VERSION } = require("../package.json");
+const CLIENT_USER_AGENT = {
+    version: PLUGIN_VERSION,
+    lang: "nodejs",
+    lang_version: process.versions.node,
+    os_name: process.platform,
+    scene: "cozeloop",
+    source: "openapi",
+};
 
 // ── Token refresh helpers ─────────────────────────────────────────────────
 const _CLIENT_ID = "46371084383473718052118955183420.app.coze";
@@ -82,24 +90,41 @@ const EXPORT_SUCCESS = 0;
 const EXPORT_FAILED = 1;
 const INGEST_TRACE_PATH = "/v1/loop/traces/ingest";
 
+// 把一行诊断写入 onboard 配置的 logFile（pluginConfig.logFile）。云端 gateway 日志常拿不到
+// （无 DBUS / 无 stdout 落盘），这个文件是排查上报失败的唯一依据。无 logFile 或写失败都静默。
+function fileLog(logFile, message) {
+    if (!logFile)
+        return;
+    try {
+        appendFileSync(logFile, `${new Date().toISOString()} ${message}\n`);
+    }
+    catch {
+        /* best-effort, never throw from logging */
+    }
+}
+
 function normalizeApiBaseUrl(endpoint) {
     const base = String(endpoint || "").replace(/\/+$/, "");
     if (!base)
         return _COZE_API;
+    // 剥除已知 loop 路径后缀，还原纯 API base。
+    // 关键：cozeloop ingest 正确端点 <host>/v1/loop/traces/ingest，【不带 /api 前缀】。
+    // 含 /api 的变体必须连 /api 整体剥掉 —— 否则残留 /api → /api/v1/loop/traces/ingest → 后端 400。
+    // 顺序：更长 / 带 /api 的在前，裸 /v1 最后，避免 endsWith 误匹配短后缀。
     const suffixes = [
-        "/v1/loop/traces/ingest",
         "/api/v1/loop/traces/ingest",
-        "/v1/loop/opentelemetry/v1/traces",
+        "/v1/loop/traces/ingest",
         "/api/v1/loop/opentelemetry/v1/traces",
-        "/v1/loop/opentelemetry",
+        "/v1/loop/opentelemetry/v1/traces",
         "/api/v1/loop/opentelemetry",
+        "/v1/loop/opentelemetry",
         "/v1/traces",
         "/api/v1",
+        "/v1",
     ];
     for (const suffix of suffixes) {
         if (base.endsWith(suffix)) {
-            const trimSuffix = suffix.startsWith("/api/") ? suffix.slice("/api".length) : suffix;
-            return base.slice(0, -trimSuffix.length).replace(/\/+$/, "");
+            return base.slice(0, -suffix.length).replace(/\/+$/, "");
         }
     }
     return base;
@@ -195,7 +220,7 @@ function spanToUploadSpan(span, config) {
     const attrs = span.attributes || {};
     const { tags, systemTags } = splitAttributes(attrs);
     const resourceAttrs = span.resource?.attributes || {};
-    const serviceName = resourceAttrs["service.name"] || config.serviceName || "openclaw-agent";
+    const serviceName = resourceAttrs["service.name"] || config.serviceName || "";
     const spanType = mapSpanType(attrs["cozeloop.span_type"]);
     const input = attrs["cozeloop.input"] !== undefined ? safeStringify(attrs["cozeloop.input"]) : "";
     const output = attrs["cozeloop.output"] !== undefined ? safeStringify(attrs["cozeloop.output"]) : "";
@@ -204,7 +229,6 @@ function spanToUploadSpan(span, config) {
     return {
         started_at_micros: hrTimeToUnixMicros(span.startTime),
         log_id: "",
-        traceId: spanContext.traceId,
         trace_id: spanContext.traceId,
         span_id: spanContext.spanId,
         parent_id: span.parentSpanId || "0",
@@ -260,9 +284,11 @@ class CozeloopIngestExporter {
         this.url = normalizeIngestUrl(config.endpoint || config.url);
         this.headers = config.headers || {};
         this.logger = config.logger;
+        this.logFile = config.logFile;
         this.workspaceId = config.workspaceId;
         this.serviceName = config.serviceName;
         this.shutdownRequested = false;
+        fileLog(this.logFile, `[ingest] exporter ready url=${this.url} workspaceId=${this.workspaceId}`);
     }
     export(spans, resultCallback) {
         if (!spans || spans.length === 0 || this.shutdownRequested) {
@@ -273,6 +299,7 @@ class CozeloopIngestExporter {
             .then(() => resultCallback({ code: EXPORT_SUCCESS }))
             .catch((err) => {
                 this.logger?.error?.(`[CozeloopTrace] CozeLoop ingest export failed: ${err?.message || err}`);
+                fileLog(this.logFile, `[ingest] export FAILED url=${this.url} spans=${spans.length} err=${err?.message || err}`);
                 resultCallback({ code: EXPORT_FAILED, error: err });
             });
     }
@@ -283,15 +310,18 @@ class CozeloopIngestExporter {
                 serviceName: this.serviceName,
             })),
         };
+        fileLog(this.logFile, `[ingest] POST url=${this.url} spans=${body.spans.length}`);
         const res = await postJson(this.url, body, this.headers);
         if (res.status < 200 || res.status >= 300) {
             const snippet = String(res.body || "").slice(0, 300);
+            fileLog(this.logFile, `[ingest] HTTP ${res.status} url=${this.url}${snippet ? ` body=${snippet}` : ""}`);
             throw new Error(`HTTP ${res.status}${snippet ? `: ${snippet}` : ""}`);
         }
         if (res.body) {
             try {
                 const parsed = JSON.parse(res.body);
                 if (parsed && parsed.code !== undefined && parsed.code !== 0) {
+                    fileLog(this.logFile, `[ingest] biz-error code=${parsed.code} msg=${parsed.msg || ""} url=${this.url}`);
                     throw new Error(`code ${parsed.code}: ${parsed.msg || res.body.slice(0, 300)}`);
                 }
             }
@@ -301,6 +331,7 @@ class CozeloopIngestExporter {
                 }
             }
         }
+        fileLog(this.logFile, `[ingest] OK HTTP ${res.status} spans=${body.spans.length}`);
     }
     async forceFlush() {
         return;
@@ -405,13 +436,17 @@ export class CozeloopExporter {
         const authorization = this.config.authorization;
         const workspaceId = this.config.workspaceId;
         this.api.logger.info(`[CozeloopTrace] Using authorization, workspaceId=${workspaceId}, tokenLength=${authorization?.length}`);
+        fileLog(this.config.logFile, `[init] ingestUrl=${normalizeIngestUrl(this.config.endpoint)} workspaceId=${workspaceId} tokenLength=${authorization?.length || 0} plugin=${PLUGIN_VERSION}`);
         const exporter = new CozeloopIngestExporter({
             endpoint: this.config.endpoint,
             logger: this.api.logger,
+            logFile: this.config.logFile,
             workspaceId,
             serviceName: this.config.serviceName,
             headers: {
                 "Authorization": authorization,
+                "User-Agent": `openclaw-cozeloop-trace/${PLUGIN_VERSION} node/${process.versions.node}`,
+                "X-Coze-Client-User-Agent": JSON.stringify(CLIENT_USER_AGENT),
                 "x-tt-env": "ppe_cozelab",
                 "x-use-ppe": "1",
             },
@@ -473,10 +508,11 @@ export class CozeloopExporter {
         const runtimeTag = {
             language: "nodejs",
             library: "openclaw",
+            scene: process.env.COZELOOP_SCENE || "custom",
+            library_version: null,
+            loop_sdk_version: `v${PLUGIN_VERSION}`,
+            extra: null,
         };
-        if (process.env.COZELOOP_SCENE) {
-            runtimeTag.scene = process.env.COZELOOP_SCENE;
-        }
         const systemTagRuntime = JSON.stringify(runtimeTag);
         const span = this.tracer.startSpan(spanData.name, {
             kind: spanKind,
@@ -579,10 +615,11 @@ export class CozeloopExporter {
             const runtimeTag = {
                 language: "nodejs",
                 library: "openclaw",
+                scene: process.env.COZELOOP_SCENE || "custom",
+                library_version: null,
+                loop_sdk_version: `v${PLUGIN_VERSION}`,
+                extra: null,
             };
-            if (process.env.COZELOOP_SCENE) {
-                runtimeTag.scene = process.env.COZELOOP_SCENE;
-            }
             const systemTagRuntime = JSON.stringify(runtimeTag);
             const span = this.tracer.startSpan(spanData.name, {
                 kind: spanKind,

package/scripts/openclaw/dist/index.js

@@ -534,6 +534,7 @@ const cozeloopTracePlugin = {
             batchInterval: pluginConfig.batchInterval || 5000,
             enabledHooks: pluginConfig.enabledHooks,
             disableLocalCredentials: pluginConfig.disableLocalCredentials === true,
+            logFile: pluginConfig.logFile,
         };
         const exporter = new CozeloopExporter(api, config);
         // per-agent trace 放行：traceAgentIds 为 onboard 写入的 allowlist（小写归一）。

package/scripts/openclaw/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-cozeloop-trace",
   "name": "OpenClaw CozeLoop Trace",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Report OpenClaw execution traces to CozeLoop via OpenTelemetry",
   "type": "plugin",
   "entry": "./dist/index.js",
@@ -54,6 +54,11 @@
         "type": "boolean",
         "default": false,
         "description": "Disable ~/.cozeloop credentials refresh and use configured authorization only"
+      },
+      "logFile": {
+        "type": "string",
+        "default": "",
+        "description": "Append trace ingest diagnostics (URL, span count, HTTP status, failure body) to this file"
       }
     }
   }

package/scripts/openclaw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cozeloop/openclaw-cozeloop-trace",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "OpenClaw Plugin for reporting traces to CozeLoop via OpenTelemetry",
   "type": "module",
   "main": "dist/index.js",