跳转到主要内容

​
常见问题

不是。 密钥始终留在本地 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 让模型在设备上运行。推荐使用 Qwen3.5 2B，桌面端和手机都适用。它的分层漏斗设计意味着大多数请求根本不会到达模型。推理始终在你正在使用的设备上运行，暂不支持把推理转移到其他设备。
  • MCP 服务器 与模型无关。调用工具的就是你的 MCP 宿主所运行的那个模型。
这些工具能够访问主网，但请把它当作最后一步而不是第一步。先用一次性种子在 signet 上起步，在 KaleidoAgent 上保持 dry_run 开启，直到 dry-run 的决策看起来都正确，然后再切换网络。另外要注意，不同接入方式的成熟度并不相同：KaleidoAgent 和 MCP 服务器会直接动用真实资金，而 LLM 调错一个工具是真实存在的失败模式。
本文档中的一切都运行在 signet 上。用 KALEIDO_NETWORK=signet 把 kaleido-mcp 指向它，这会选用位于 https://api.signet.kaleidoswap.com 的 signet KaleidoSwap API。
  • RGB 资产： KaleidoSwap RGB 水龙头会把测试资产发送到你节点生成的 RGB 发票。使用 GitHub 登录。
  • 节点： KaleidoCLI 通过 kaleido setup 在本地运行一个 signet RGB Lightning Node。
构建本地 RGB 代理会完整演示这两步。
三条相互独立的成本线：
  • 托管模型的 LLM token。KaleidoAgent 会在 GET /status 中报告每轮运行的 token 开销。
  • KaleidoMind 没有推理成本，因为模型跑在你自己的硬件上。
  • 每种情况下都有 比特币费用：闪电网络上的路由费、通道开通或关闭时的链上费用，以及交换中做市商的价差。
在 KaleidoAgent 上，只有一项控制在代码层面强制生效：其余各项是作为运行规则传递给模型的，并不会被独立强制执行，因此请当作指引而非支出上限：无论模型做出什么决策都能守住的控制，是 dry_run 以及把账户余额保持在很小的金额。在 KaleidoMind 上，等价机制是结构性的而非配置出来的：会动用资金的工具被标记为 requiresConfirmation，并暂停等待宿主的确认面板。
可以，这正是 Machine Payments Protocol 工具覆盖的场景。代理探测一个受门控的 URL，收到带闪电发票的 HTTP 402 挑战，支付它，然后提交凭据以拿到数据和一张收据。无需注册，也无需 API 密钥。完整流程见 MCP 服务器页面。
MCP 服务器提供工具：针对钱包、DEX 或节点的类型化、可调用操作。skill 是一份 SKILL.md 操作手册，限定模型可以调用其中哪些工具，并承载执行计划。改动 skill 就能改变行为，无需触碰运行时代码。一个是能力，另一个是策略加计划。
是的，但有一点需要说明。网关、各个钱包 MCP 服务器、KaleidoAgent、KaleidoMind 和 skill 都公开在 github.com/kaleidoswap 下。kaleido-mcp、KaleidoAgent 和 KaleidoMind 采用 Apache 2.0。三个钱包服务器虽然公开，但尚未附带许可证文件，在许可证落地之前请按 source-available 对待。直达链接见更多资源。
桌面应用直接把 KaleidoMind 作为应用内聊天来承载，其工具以 stdio 边车方式接入 kaleido-mcp，可在**「设置 > 能力」**(Settings > Capabilities) 中切换。浏览器扩展自带一个内置的对话式代理来执行钱包操作。统一的 kaleido-mcp 服务器则面向 Claude Desktop 或你自己的客户端这类外部宿主。

​
获取帮助

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

Telegram 社区

向社区提问。

GitHub Issues

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

邮件支持

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