← 返回 Skills 市场
OpenClaw Logfire
作者
Nick Amabile
· GitHub ↗
· v0.1.2
672
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install openclaw-logfire
功能描述
Pydantic Logfire observability — OTEL GenAI traces, tool call spans, token metrics, distributed tracing
安全使用建议
This package appears to do exactly what it claims: export OpenClaw spans/metrics to Pydantic Logfire. Before installing, consider: 1) Trust the destination — traces (even redacted) leave your host to logfire-api.pydantic.dev/eu. 2) Review or test the redaction logic (src/util.ts) if you have high-sensitivity data; pattern-based redaction can miss custom secrets. If unsure, disable captureToolInput or enable stricter redaction in config. 3) Use the EU region option if you need data residency. 4) Treat LOGFIRE_TOKEN like any write key: create a token with minimum scope, rotate it, and avoid embedding it in repos. 5) Deploy to a staging instance first to confirm no unexpected data is emitted. If you want, I can scan the specific util.ts and otel.ts functions for the exact redaction patterns and any other data-exfil patterns.
功能分析
Type: OpenClaw Skill
Name: openclaw-logfire
Version: 0.1.2
The skill bundle is an OpenTelemetry (OTEL) plugin for Logfire observability, designed to trace agent lifecycle, tool calls, and metrics. It reads `LOGFIRE_TOKEN` and sends data to legitimate Logfire endpoints (`logfire-us.pydantic.dev`, `logfire-eu.pydantic.dev`). The `src/util.ts` file includes a `redactSecrets` function, which is a positive security feature. However, the `src/context/propagation.ts` file contains `injectTraceContext` which modifies shell commands (e.g., `curl`, `wget`) by appending `traceparent` headers to their arguments. While intended for legitimate distributed tracing, modifying shell command arguments programmatically introduces a vulnerability risk (e.g., shell injection) if the original command or the injected headers are not perfectly sanitized or handled by the shell, even if the headers themselves are structured OTEL data. This capability, despite its benign intent, elevates the classification to 'suspicious' due to the inherent risk of command modification.
能力评估
Purpose & Capability
Name/description, openclaw.plugin.json schema, SKILL.md, and the TypeScript sources (hooks, otel.ts, metrics, propagation, util) all align: the plugin initializes OTEL export to Pydantic Logfire and instruments OpenClaw hooks. Requiring LOGFIRE_TOKEN as the primary credential is appropriate for a write-only tracing/metrics exporter.
Instruction Scope
Runtime instructions and code indicate the plugin records tool call spans, agent lifecycle spans, and token/latency metrics. By default 'captureToolInput' is true (captures tool arguments) while 'captureToolOutput' and 'captureMessageContent' are false; 'redactSecrets' defaults to true. This is coherent, but capturing tool arguments can inadvertently include sensitive values (file paths, CLI args, inline secrets) — reliance on pattern-based redaction is not a guarantee. Distributed-tracing injection exists but is disabled by default (enabled only if distributedTracing.enabled = true).
Install Mechanism
No arbitrary remote download/install step is embedded in the SKILL.md or plugin manifest; package.json and package-lock are included (npm package), and installation is via OpenClaw plugin mechanism/npm. There are no URLs to strange servers or shorteners for code pulls. The absence of an automated 'install' script in the registry metadata is fine here because the package contains source and an npm package reference.
Credentials
Only LOGFIRE_TOKEN is required as a credential. Optional fallback env vars (LOGFIRE_ENVIRONMENT, LOGFIRE_PROJECT_URL, LOGFIRE_PROVIDER_NAME) are reasonable for configuration. There are no unrelated secrets or numerous credentials requested.
Persistence & Privilege
always:false and no indication the plugin force-enables itself across agents. SKILL.md claims 'no local persistence' (streams traces to OTLP HTTP). The plugin registers OpenClaw hooks (normal for a plugin) and does not appear to modify other plugins' configs or request elevated system privileges.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install openclaw-logfire - 安装完成后,直接呼叫该 Skill 的名称或使用
/openclaw-logfire触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.2
Fix config passthrough (api.pluginConfig), Ajv draft-07 compat, corrected manifest id
元数据
常见问题
OpenClaw Logfire 是什么?
Pydantic Logfire observability — OTEL GenAI traces, tool call spans, token metrics, distributed tracing. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 672 次。
如何安装 OpenClaw Logfire?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install openclaw-logfire」即可一键安装,无需额外配置。
OpenClaw Logfire 是免费的吗?
是的,OpenClaw Logfire 完全免费(开源免费),可自由下载、安装和使用。
OpenClaw Logfire 支持哪些平台?
OpenClaw Logfire 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 OpenClaw Logfire?
由 Nick Amabile(@namabile)开发并维护,当前版本 v0.1.2。
推荐 Skills