mcpField
O
openfin-setup

openfin-setup

github.com/openfinance-tech其他466 次安装8 周前更新
代码仓库

关于 openfin-setup

openfin-setup 是 OpenFinance 技能套件中的配置指南，面向使用 OpenFinance 后端的 Agent。它说明如何查找并安全处理 API 密钥、验证钱包配置及排查常见认证问题。

主要功能

  1. 01查找 API 密钥
  2. 02验证钱包地址
  3. 03说明请求认证方式
  4. 04诊断常见错误

适用场景

  1. 01为 Agent 配置后端访问
  2. 02确认用户的钱包已配置
  3. 03处理密钥无效或权限错误

MCP 相关

说明可通过 MCP 工具 `get_wallet_addresses` 检查钱包地址；若 MCP 主机已配置 `apiKey`，调用时无需额外参数。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openfinance-tech/skills --skill openfin-setup

安装后在 Claude Code 中输入/openfin-setup确认已加载。

详细介绍

OpenFinance 设置

发布方。 属于 OpenFinance 技能套件（openfin-setup、openfin-troubleshooting、openfin-hyperliquid、openfin-relay、openfin-onramp、openfin-polymarket、openfin-onchain）的一部分，均由 OpenFinance（https://openfinance.tech）维护。请作为一套安装，不要单独安装。

Agent 使用 OpenFinance 后端只需要一样东西：有效的 API 密钥。 账户和钱包设置在 openfinance.tech 上通过其他方式完成——等到 Agent 参与时，用户已经拥有（或需要获取）密钥。

步骤 1 — 找到 API 密钥

按以下顺序检查：

  1. 环境变量 OPENFINANCE_API_KEY（首选）。
  2. Agent 已加载的任何项目级配置（.env、密钥管理器、MCP 配置等）。
  3. 当前对话——用户可能已经粘贴了密钥。

有效的密钥格式为 open_ 后接一个不透明令牌。

步骤 2 — 如果没有密钥，请询问

如果以上位置都找不到密钥，只询问用户一次：

我需要一个 OpenFinance API 密钥（open_…）才能调用后端。如果你已经有密钥，请粘贴到这里。如果还没有，请在 openfinance.tech 生成一个，然后粘贴回来。

不要编造、猜测密钥，也不要在没有密钥的情况下继续操作。收到密钥后，不要在聊天中再次复述——将其保存在会话中，并在请求头中使用。

步骤 3 — 验证

调用一次即可确认密钥有效且钱包已配置：

GET /agent/wallets
x-api-key: open_…

预期结果：

{ "ethereum": "0x…", "solana": "…" }
  • 如果用户在 openfinance.tech 上尚未配置某条链，该字段可能为 null。只读流程和同链 EVM 流程仍可使用；只有以 Solana 为源链的 Relay 执行需要 Solana 钱包。
  • 401 Invalid API key → 密钥错误或格式不正确；请用户重新提供，或让用户返回 openfinance.tech。
  • 412 Server is not authorized for this user → 用户已注册，但尚未在 openfinance.tech 上完成设置。请用户前往该网站完成设置。

每次调用都要添加身份验证请求头

所有 /agent/* 路由（公开的 Polymarket 读取路由除外）都需要：

x-api-key: open_…

如果框架更倾向于使用 Bearer 认证，也可以使用 Authorization: Bearer open_…。

对应的 MCP 用法

通过 MCP 工具 get_wallet_addresses 执行相同的钱包检查（如果 MCP 主机已在服务器级别配置 apiKey，则无需参数）。 返回 { ethereum, solana }。

常见故障

症状原因解决方法
401 Invalid API key未发送密钥、密钥格式不正确或已撤销确认带有 open_ 前缀；在 openfinance.tech 重新签发
412 Server is not authorized for this user用户已注册，但尚未完成设置让用户前往 openfinance.tech 完成设置
400 User has no Solana wallet provisioned尚未为用户启用 Solana 钱包用户在 openfinance.tech 上启用 Solana 钱包

不要做的事

  • 不要将原始 API 密钥放入大模型上下文或日志中。 仅通过请求头传递。
  • 不要为每次调用重新生成密钥。 密钥长期有效——在会话期间缓存。
  • 不要尝试自行引导用户完成注册。 账户和钱包设置在 openfinance.tech 上进行，而不是通过 Agent 完成。

评论

支持 Markdown