Authenticate — 财务区钱包认证
v0.1.0通过 Finance District (FDX) CLI 实现钱包认证。用于登录、连接、设置或配置钱包,或者解决钱包操作中的认证错误。该技能是使用钱包进行其他操作(如发送令牌、交换、检查余额)的必备前置步骤。
0· 238·0 当前·0 累计
安全扫描
OpenClaw
安全
high confidence该技能的指令和执行路径与其声明的目的相符(帮助用户通过 FDX CLI 认证钱包);虽然 SKILL.md 文档中提到了环境变量,但注册元数据未声明这些变量,然而这并没有引起功能上的不匹配。
评估建议
该技能在其声明的目的上是连贯的:它简单地指导用户运行 `fdx` CLI 执行 OAuth 并管理存储在 `~/.fdx/auth.json` 的令牌。在安装或使用之前,请验证 `fdx` CLI 来自可信源,并确认 MCP 服务器 URL(默认为 `https://mcp.fd.xyz`)对于您的部署是正确的。在多用户或不可信任的机器上谨慎运行,因为令牌文件包含凭据;在无头/远程主机上更好地使用设备流。另外,注意到 SKILL.md 公告环境变量,但注册元数据没有声明它们——这无害但建议技能作者为清晰度而更正。...详细分析 ▾
ℹ 用途与能力
该技能仅提供指令,帮助通过本地 `fdx` CLI 认证 Finance District 钱包。所有描述的必要操作(fdx setup、status、logout)与声明的目的一致。注意:SKILL.md 文档中列出了 FDX 相关的环境变量(FDX_MCP_SERVER、FDX_REDIRECT_URI、FDX_STORE_PATH),但注册元数据未列出任何必需的环境变量——这是一个小的元数据遗漏,但不是功能上的不匹配。
✓ 指令范围
指令范围狭窄,仅涵盖运行 `fdx status`、`fdx setup`(浏览器或设备 OAuth 流)和 `fdx logout`。指令指导用户完成浏览器/设备授权。该技能引用了本地令牌存储(`~/.fdx/auth.json`)和本地回调服务器(端口 6260),这些是 OAuth 流的预期组成部分。
✓ 安装机制
无安装规范或代码文件——这是仅指令的技能。这样可以最小化风险,因为除了调用主机上的现有 `fdx` CLI 之外,什么也不写入或执行。
ℹ 凭证需求
该技能在元数据中未请求秘密或凭据。SKILL.md 列出了非秘密环境变量(MCP 服务器 URL、重定向 URI、令牌存储路径),这些对于配置是合理的。然而,元数据未声明这些环境变量为必需的;另外,注意到 `fdx status` / `fdx setup` 将读取/写入包含令牌的本地令牌存储(例如 `~/.fdx/auth.json`)。
✓ 持久化与权限
始终为 false 且该技能是用户可调用;它不请求永久存在或修改其他技能/系统设置。默认情况下保持启用自治调用,但这在这里不被提及,因为该技能的操作仅限于通过 `fdx` CLI 指导人工驱动的 OAuth。
安全有层次,运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv0.1.02026/3/9
● 无害
安装命令 点击复制
官方npx clawhub@latest install authenticate
镜像加速npx clawhub@latest install authenticate --registry https://cn.clawhub-mirror.com
技能文档
当钱包未登录(通过 fdx status 检测或钱包操作失败时显示认证错误)时,使用 fdx CLI 通过 OAuth 2.1 进行认证。认证需要浏览器——代理指导用户完成流程,但用户必须完成基于浏览器的授权步骤。
检查认证状态
cdx 状态
显示 MCP 服务器 URL、令牌状态、过期时间以及是否有可用的刷新令牌。认证流程
FDX 支持两种 OAuth 流,取决于环境:浏览器流(默认)
当用户在同一机器上有可用的浏览器时使用:cdx 设置
这将:
- 向 MCP 服务器注册客户端
- 打印授权 URL
- 启动本地回调服务器(端口 6260)
- 等待用户完成浏览器授权
- 将授权代码交换为令牌
设备流
当用户无法在同一机器上打开浏览器(例如远程服务器、无头环境)时使用:cdx 设置 --device
这将:
- 向 MCP 服务器注册设备客户端
- 显示验证 URL 和用户代码
- 轮询授权完成
退出登录
cdx 退出
删除存储的凭据。用户将需要再次运行 fdx 设置 以重新认证。示例会话
# 检查当前状态
cdx 状态
# 如果未认证,开始登录
cdx 设置
# 用户完成浏览器授权...
# 确认认证成功
cdx 状态
令牌生命周期
- 令牌在后续
fdx 调用命令中自动刷新,如果有刷新令牌。 - 如果令牌过期且没有刷新令牌,用户必须再次运行
fdx 设置。 - 令牌状态存储在本地(默认:
~/.fdx/auth.json)
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
FDX_MCP_SERVER | MCP 服务器 URL | https://mcp.fd.xyz |
FDX_REDIRECT_URI | OAuth 回调 URI | http://localhost:6260/oauth/callback |
FDX_STORE_PATH | 令牌存储文件路径 | ~/.fdx/auth.json |
错误处理
- "未认证" — 运行
fdx 设置以认证。 - "令牌过期" 带有刷新令牌 — 下一次调用时将自动刷新;无需操作。
- "令牌过期" 无刷新令牌 — 再次运行
fdx 设置。 - "OAuth 状态不匹配" — 可能的 CSRF;使用
fdx 设置重启。 - "回调服务器错误" — 端口 6260 可能被占用;尝试使用
--device流式处理。
数据来源:ClawHub ↗ · 中文优化:龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制
免费技能或插件可能存在安全风险,如需更匹配、更安全的方案,建议联系付费定制