PicoClaw 定价与 API 设置：模型、协议和密钥

PicoClaw 软件本身免费：代码仓库采用 MIT 许可证，picoclaw.io 自己的 FAQ 写道“软件是免费的。你只需支付 LLM API 使用费”——因此，“PicoClaw 定价”指的是你的模型 API 账单，加上设备本身的费用。 Sipeed 没有宣传 PicoClaw 订阅或托管层级。值得纳入预算的数字是每轮代理调用的 token 数量，而最可能让你意外的是 PicoClaw 的工具迭代上限：字段缺失时为 50，随附示例配置中为 20。

先澄清两点，因为搜索结果页将它们混在了一起。官方域名是 picoclaw.io——它列在 github.com/sipeed/picoclaw 的 homepage 字段中。外观相似的网站 pico-claw.com 在自己的页脚中声明“与 Sipeed 或 PicoClaw 没有官方关联”，其月度套餐价格属于该网站自己的托管服务模块，而不是 PicoClaw。另一个外观相似的网站 picoclaw.net 也不是官方域名。它以“95% AI 生成代码”和“支持 3 种架构”为宣传语——x86_64、ARM64 和 RISC-V——而 picoclaw.io 的 FAQ 列出了 6 种。PicoClaw 不是 OpenClaw 的分支；它是独立的 Go 实现，并将自己与 OpenClaw 和 NanoBot 进行基准比较。

PicoClaw 定价逐项说明

全部核查于 2026 年 9 月 21 日。记录版本：最新带标签的版本是 v0.3.1，发布于 2026 年 7 月 3 日，而代码仓库最后一次推送是在 2026 年 9 月 17 日——因此 main 上的代码领先于该标签，README 自己的新闻列表则更旧，其中最新的发布条目仍是 2026 年 5 月 28 日的 v0.2.9。下面的所有行为都是在 main 上读取的，而不是来自你将下载的 v0.3.1 二进制程序；使用带标签版本的读者可能会看到不同结果。核查日期当天还有一个实时状况：picoclaw.io 的 TLS 证书已过期（有效期为 2026 年 2 月 25 日至 9 月 10 日），因此浏览器会在官方下载页面显示安全警告。这种情况可能随时修复，不能据此判断项目本身的情况；GitHub Releases 不受影响。

PicoClaw API 密钥设置：model_list 和 .security.yml

picoclaw onboard 会创建 ~/.picoclaw/config.json 和工作区。模型在 model_list 数组中声明，并从 agents.defaults.model_name 按名称选择；两者必须匹配，这是 PicoClaw 故障排查文档涵盖的唯一情形。

{
  "agents": {
    "defaults": {
      "model_name": "gateway-sonnet"
    }
  },
  "model_list": [
    {
      "model_name": "gateway-sonnet",
      "provider": "openai",
      "model": "claude-sonnet-4-6",
      "api_base": "https://api.kunavo.com/v1",
      "enabled": true
    }
  ]
}

密钥存储在第二个文件中。PicoClaw 的安全文档将 config.json 称为“主要配置（可安全共享）”，将 .security.yml 称为“安全数据（绝不共享）”，并要求对其执行 chmod 600。YAML 结构是一个以 model_name 为键的 映射，而不是 config.json 使用的数组；即使只有一个密钥，api_keys 仍为复数形式并且必须是数组。

# The map key must equal the model_name in config.json.
# api_keys is plural and is an array even for one key.
model_list:
  gateway-sonnet:
    api_keys:
      - "sk-kn-..."

有四个容易被忽略的细节。provider 是可选的：设置后，model 会原样发送到上游；省略时，PicoClaw 会将 model 中第一个 / 之前的全部内容读取为提供商，这就是旧版 protocol/model 形式。配置带有架构版本，当前版本为 3；迁移会写入带日期的备份，文档警告 V3 文件无法由仅支持 V2 的旧构建安全加载。在 V1 到 V2 的迁移期间，enabled 会自动推断——没有 API 密钥且名称不是 local-model 的条目默认设为 禁用——这就是为什么上面的示例在密钥移出到 .security.yml 后显式设置了 enabled。流式传输默认关闭，并受两重条件控制：模型条目的 streaming.enabled 和通道的 settings.streaming.enabled 必须同时为 true。

在编写条目之前，必须说明一个边界：PicoClaw 的提供商表将 Groq 列为“LLM + 语音转录（Whisper）”，而 Kunavo 不提供语音转文本、文本转语音或 embeddings——转录或 embedding 条目必须指向其他提供商，只有聊天条目可以使用 Kunavo 密钥。

协议名称是反的，这就是整个陷阱

在 PicoClaw 中，anthropic 表示通过 OpenAI 线路格式传输的 Claude 形状模型，而 anthropic-messages 表示 Anthropic 原生 Messages API。文档明确写道：“anthropic 协议使用 OpenAI 兼容格式（/v1/chat/completions），而 anthropic-messages 使用 Anthropic 原生格式（/v1/messages）。”源代码也一致——factory_provider.go 为 anthropic 构建共享的 OpenAI 兼容 HTTP 提供商，并为 anthropic-messages 构建独立的原生提供商。PicoClaw 自己的“All Supported Vendors”表却与两者矛盾，将 anthropic 行的协议列标为“Anthropic”；只阅读该表的读者会配置错误的协议。

读取自 openai_compat/provider.go、common/anthropic_common.go、anthropic_messages/provider.go 和 factory_provider.go，位于 main，日期为 2026 年 9 月 21 日——结论来自代码，而不是线路上的实际观测。具体后果是：不能将 anthropic 或 anthropic-messages 指向路径不能以 /v1 结尾的网关，因为 PicoClaw 无论如何都会追加它。https://gw.example.com/anthropic 会变成 https://gw.example.com/anthropic/v1/messages。对于此类端点，尊重路径原样的 openai 协议是唯一能够表达该 URL 的协议。本文仅审计了这三个协议；不要将该规则推广到 gemini、azure 或其他协议。

原生路径还有两个限制，两者都可从同一个文件中读出。anthropic-messages 必须提供 API 密钥，缺少密钥时会直接报错，因此无法通过它进入 OAuth 分支；factory_provider.go 将该分支接入 anthropic 和 openai，同时还接入了 CLI 桥接和 antigravity。另外，虽然 factory_provider.go 中有五个分支会转发 cfg.CustomHeaders，但 anthropic-messages 分支不在其中：它的构造函数只接收密钥、基础 URL、用户代理和超时参数。因此，文档中用于应对采用非标准身份验证的网关的 custom_headers 变通方案，似乎适用于 OpenAI 兼容协议，而不适用于原生 Messages 协议。这是阅读源代码得出的判断，并非运行时测试。原生路径不会让你失去工具调用能力：它使用 input_schema 构建原生 tools，并处理 tool_use 和 tool_result 块。

对于 Kunavo，文档中记录的两个基础 URL 分别是用于聊天补全的 https://api.kunavo.com/v1 和用于 Messages 路由的 https://api.kunavo.com/v1/messages；Kunavo 的 Messages 处理程序也会从 x-api-key 以及 Authorization: Bearer 读取密钥。理论上，这两个 URL 从两个方向都符合 PicoClaw 的 URL 算术。这里仅是对两组文档进行算术推导——本文未向 Kunavo 发起任何 PicoClaw 请求，也不声称任何 PicoClaw 协议已针对 Kunavo 进行测试。请参阅Anthropic 基础 URL 文档和聊天端点文档，了解确切格式，然后自行发送一个有界请求。

PicoClaw API 成本估算示例

这些是用于示例说明的 token 用量计算，并非实测任务成本，也不是账单上限。假设一个智能体回合经过 8 轮工具调用完成，每轮重新发送的对话记录平均包含 12,000 个输入 token，并返回 700 个输出 token。这些比例是为举例说明而作的假设。第二列按相同的用量模式计算，直到达到 pkg/config/defaults.go 中编译内置的 max_tool_iterations 默认值 50；该默认值在字段缺失时生效，而随附的 config/config.example.json 将其设为 20，因此在将 50 视为你的上限之前，请先查看自己的文件。费率采用实时的 Kunavo 目录价格，按每百万 token 计价。

将两列作为一个事实来理解。从 8 轮增加到 50 轮上限，会将每一行都乘以相同的 6.25x，因为循环长度与费率无关：一次 Claude Sonnet 4.6 调用在 8 轮时为 $0.260，在上限时为 $1.627；而同一上限下的 Claude Haiku 4.5 为 $0.542。因此，在寻找更低费率之前，应将 max_tool_iterations 限制在你实际观察过的数字上——它位于 agents.defaults 下，并可由 PICOCLAW_AGENTS_DEFAULTS_MAX_TOOL_ITERATIONS 环境变量覆盖。然后按每天的调用轮数进行扩展。

Kunavo 的目录金额是计费下限，而不是上限：上游报告费用时，账单取目录成本与上游成本乘以适用加价率两者中的较高值。缓存读取和写入按各自费率计费，本文未在任何方向上建模；外部工具调用也不包含在示例中。最低充值额是预付余额 $10，这是资金充值最低额，而不是任务费用或订阅费用——测量方法请参阅计费详情和AI 成本优化。

PicoClaw 最佳 API：何时选择哪条路径

提供商数量在这里不是比较维度：PicoClaw 自己的文件集合对于哪些提供商存在这一点都彼此不一致，因此最稳妥的复述是其 README 中“30+ 个 LLM 提供商”的说法。至于 PicoClaw 在其他单二进制代理中的位置，AI 代理 API 目录将其配置界面与其他代理并列，OpenRouter 替代方案则按资金条款而非集成深度比较网关路径。

第一个请求、第一轮工具调用和 404

执行一个有界任务，并按顺序读取三项内容。model_list 中找不到模型是文档记录的情况，原因是命名不匹配：agents.defaults.model_name 必须等于某个 model_name 条目；如果未设置 provider，不带前缀的 id 不会选择你想要的提供商——它会回退到 openai 协议，这正是文档记录的 "model": "free" 情况：OpenRouter 会收到字面量 id free 并拒绝它。第一次请求返回 404是选择了错误 Anthropic 协议的文档信号——PicoClaw 自己的指导建议在“现有的 anthropic 协议返回 404 错误（表示端点不支持 OpenAI 兼容格式）”时切换到 anthropic-messages。在更改其他内容前，先将拼接出的 URL 与上表核对；官方没有针对这一点的故障排查条目，因此该诊断来自提供商说明和源代码，而不是支持页面。第三，如果纯聊天正常，但第一轮工具调用失败，应怀疑 schema 严格性而不是身份验证：PicoClaw 默认原样转发工具 schema，而 tool_schema_transform: "simple" 是针对拒绝 $ref、$defs、anyOf、oneOf、allOf 或 pattern 的端点提供的按模型禁用选项。

Kunavo 未发布 PicoClaw 设置页面，也未进行任何 PicoClaw 兼容性测试；尝试使用时请保留一条可用的备用路径，然后读取账户针对该任务实际记录的费用，不要根据此页面估算。创建 Kunavo 账户，准备为密钥充值时即可；如果你已经确定使用 Claude 系列，请在最便宜的 Claude API上比较模型费率。

常见问题

于 2026 年 9 月 21 日检查：GitHub 仓库和 releases API、picoclaw.io（由于其证书已过期，读取时禁用了证书验证）、README、docs/guides/providers.md、docs/security/security_configuration.md、docs/reference/config-versioning.md、docs/guides/configuration.md、docs/operations/troubleshooting.md、config/config.example.json，以及分支 main 上的七个源文件——factory_provider.go、openai_compat/provider.go、common/anthropic_common.go、anthropic_messages/provider.go、provider_metadata.go、pkg/config/defaults.go 和 pkg/config/config.go——另加两个相似域名。未检查：PicoClaw 自有对比表中的第三方配额、零售硬件价格以及 v0.3.1 发布说明。未安装或运行任何内容：未向任何端点发送 PicoClaw 请求。Kunavo 的 token 费率来自实时目录，本文中的所有美元示例都是用于说明的 token 费用计算，而不是实测任务成本。