Skip to main content

​
常见问题

不是。 密钥始终留在本地 WDK 钱包和你所指向的 RGB Lightning Node 中。交易以闪电网络上的原子 HTLC 交换结算，因此做市商只是交易的对手方，从不持有你的资金。引入 AI 改变的不是托管方式，而是由谁发起花费。这正是确认机制和风险上限存在的意义。
助记词以环境变量（WDK_SEED）的形式传给服务器进程，或从 agent.config.json 中读取。签名发生在该进程内部。模型只是调用工具并接收结果，因此种子不会成为提示词或工具输出的一部分。但这并不等于种子是安全的。任何能读取配置文件或进程环境的东西都能拿到你的助记词，所以主网种子绝不该出现在你会提交或分享的文件里。
取决于你调用哪些工具。
  • 行情数据（l402_*）和 Spark 钱包（spark_*）不需要节点，后者只需要一份种子。
  • RGB Lightning Node 工具（wdk_*）和原子交换需要节点，因为 HTLC 的接单方一侧跑在你的节点上。
KaleidoCLI 可以为你部署一个基于 Docker 的节点，kaleido-mcp 也提供了 kaleido_node_* 工具来替你驱动这套生命周期。
因接入方式而异：
  • KaleidoAgent 用托管模型推理，Claude 或 OpenAI，通过 AGENT_PROVIDER 选择。
  • KaleidoMind 通过 QVAC SDK 让模型在设备上运行，可以在本地，也可以在你显式配对过的桌面端。它的分层漏斗设计意味着大多数请求根本不会到达模型。
  • MCP 服务器 与模型无关。调用工具的就是你的 MCP 宿主所运行的那个模型。
这些工具能够访问主网，但请把它当作最后一步而不是第一步。先用一次性种子在 regtest 或 signet 上起步，在 KaleidoAgent 上保持 dry_run 开启，直到 dry-run 的决策看起来都正确，然后再切换网络。另外要注意，不同接入方式的成熟度并不相同：KaleidoAgent 和 MCP 服务器会直接动用真实资金，而 LLM 调错一个工具是真实存在的失败模式。
三条相互独立的成本线：
  • 托管模型的 LLM token。KaleidoAgent 会在 GET /status 中报告每轮运行的 token 开销。
  • KaleidoMind 没有推理成本，因为模型跑在你自己的硬件上。
  • 每种情况下都有 比特币费用：闪电网络上的路由费、通道开通或关闭时的链上费用，以及交换中做市商的价差。
有几种相互独立的控制手段，而且值得同时用上多个：在 KaleidoMind 上，等价机制是结构性的而非配置出来的：会动用资金的工具被标记为 requiresConfirmation，并暂停等待宿主的确认面板。
可以，这正是 Machine Payments Protocol 工具覆盖的场景。代理探测一个受门控的 URL，收到带闪电发票的 HTTP 402 挑战，支付它，然后提交凭据以拿到数据和一张收据。无需注册，也无需 API 密钥。完整流程见 MCP 服务器页面。
MCP 服务器提供工具：针对钱包、DEX 或节点的类型化、可调用操作。skill 是一份 SKILL.md 操作手册，限定模型可以调用其中哪些工具，并承载执行计划。改动 skill 就能改变行为，无需触碰运行时代码。一个是能力，另一个是策略加计划。
是的。所有仓库都公开在 github.com/kaleidoswap 下：MCP 服务器、KaleidoAgent、KaleidoMind，以及 skill 本身。直达链接见更多资源。
桌面应用直接把 KaleidoMind 作为应用内聊天来承载，其工具以 stdio 边车方式接入 kaleido-mcp，可在**「设置 > 能力」**(Settings > Capabilities) 中切换。浏览器扩展自带一个内置的对话式代理来执行钱包操作。独立的 MCP 服务器则面向 Claude Desktop 或你自己的客户端这类外部宿主。

​
获取帮助

如果遇到的是报错而不是疑问，请查看故障排查。其他情况请通过下面任一渠道反馈问题，并附上：
  1. 使用的接入方式与版本（MCP 服务器名称、KaleidoAgent 提交号，或桌面应用版本）
  2. 你所在的网络（regtest、signet 或主网）
  3. 失败的工具名称和报错文本
  4. 宿主与运行时版本（MCP 客户端、Node.js）
  5. 你的配置，并移除其中的种子和所有密钥

Telegram 社区

向社区提问。

GitHub Issues

在相关仓库提交缺陷报告。

邮件支持

紧急问题的直接支持渠道。