返回指南
定价·2026年9月21日·更新于 2026年9月24日·阅读约 9 分钟

NanoClaw API 费用与提供商:Claude、OpenCode 和本地路由

NanoClaw 免费且采用 MIT 许可证,因此费用来自你连接的提供商——而默认运行时并不是提供商列表。

最后审核于 。

NanoClaw 的成本是 $0。它采用 MIT 许可证、由用户自行托管、没有用户账户和付费层级,其文档网站也完全没有发布定价页面——因此“NanoClaw 定价”指的是你接入的提供商收取的模型账单,外加如果你的公司超出 Docker 免费使用阈值则需要支付的 Docker Desktop 订阅费用。真正值得规划的是默认运行时产生的账单,因为 NanoClaw 发布时默认指向 Claude;Codex 是设置流程可以内联安装的唯一替代方案,其余方案都需要之后自行安装。

先澄清两点,因为结果页面把它们混在了一起。Clawland-AI/nanoclaw 是一个无关的、面向单板计算机的 Python 代理,其硬件成本不属于本产品。一个广泛传播的第三方标题还将一个美元数字与“NanoClaw PR 工厂”联系起来;无论该数字衡量的是什么,都不是 NanoClaw 收取的价格,因为 NanoClaw 不收费。本页讨论的是 nanocoai/nanoclaw——MIT 许可、未归档、拥有 30,814 个 star,创建于 2026 年 1 月 31 日,最后一次推送于 2026 年 9 月 19 日(GitHub API,2026 年 9 月 21 日)。较旧的 qwibitai/nanoclaw 地址现在会返回 301,指向同一个仓库,因此仍指向该地址的文章或目录条目并不是在描述第二个项目。NanoClaw 文档记录的安装方式是从该检出版本运行 bash nanoclaw.sh,因此应将 SourceForge 列表视为镜像,而不是项目自己的渠道。

软件本身的成本,以及实际向你收费的内容

NanoClaw 的主页 FAQ用一句话回答了费用问题:它在 MIT 许可证下免费且开源,并且“你的代理提供商可能会对模型使用收费”。文档索引列出 56 个页面,其中没有任何定价、计费或套餐页面。账单完全产生在容器的另一侧。

项目费用来源
NanoClaw 本身$0、MIT、无账户仓库许可证,以及 README 中的“NanoClaw 没有用户账户”
免费的 NanoClaw 账户$0 且可选——只有两项额外权益默认使用本地镜像构建,无需账户,详见加固镜像文档
OneCLI 凭证保管库$0 自托管(Apache-2.0);其 ee/ 功能在生产环境中需要订阅OneCLI 仓库;NanoClaw 默认安装本地实例
DockerDocker Desktop Personal 0 美元;Pro 每用户每月 11 美元,Team 每用户每月 16 美元,Business 每用户每月 24 美元,按月计费;按年计费时 Pro 每月 9 美元,Team 每月 15 美元Docker 定价;免费使用受许可条款限制,适用于个人、教育、非商业开源项目,以及员工少于 250 人且营收低于 1000 万美元的企业
模型令牌你的提供商按 token 收取的费率你的提供商自己的账单

所有信息核查于 2026 年 9 月 21 日。Docker 这一条最容易被忽略:Linux 上的 Docker Engine 不会触发该条款,但超过这些门槛的商业 macOS 或 Windows 安装会触发。在此之前,README 要求包括 macOS 或 Linux(Windows 通过 WSL2)、Node.js 22+ 和 pnpm 10+、Docker,以及 Claude Code 本身——它是 /customize、/debug、设置错误恢复和每个 /add-<channel> 技能的前置条件,而不仅仅是默认提供商的前置条件。当前版本为 v2.4.0,发布于 2026 年 9 月 23 日,main 分支上的 package.json 也与此一致。

默认运行时是 Claude,有三种付费方式

这是大多数提供商列表都会模糊处理的区别。NanoClaw 开箱即用地通过 Anthropic 的 Claude Agent SDK,在代理容器内运行 Claude Code——container/cli-tools.json 将 @anthropic-ai/claude-code 固定为 2.1.280。NanoClaw 的凭据指南说明,向导有三种连接 Claude 的方式——Claude 订阅、你已经持有的 API 密钥或 OAuth 令牌,或者兼容 Anthropic 的端点——并说明这三种方式最终都会成为保管库机密,而不是环境变量;订阅路径会运行 claude setup-token 并存储生成的 OAuth 令牌。以下供应商价格是相应页面在所注明日期显示的金额;在承诺使用前,请在供应商自己的结账页面中确认价格。

对于订阅选项,两份官方声明并列存在,本页面不会替你调和它们之间的差异。NanoClaw 的向导将订阅登录标记为“如果你有 Pro 或 Max,则推荐”,而Claude 定价页面列出 Pro 按月计费时每月 20 美元,按年计划时每月 17 美元(预付 200 美元),Max 则每月起价 100 美元。Anthropic 的Agent SDK 概览另行说明,除非事先获批,否则不允许第三方开发者为其产品提供 claude.ai 登录或速率限制,包括基于 Agent SDK 构建的代理。任何公开来源都无法确定 NanoClaw 是否获得了此类批准,同样也无法确定订阅为代理提供的使用配额——Anthropic 没有公布 Pro 或 Max 的令牌数量。

NanoClaw 自定义 API:唯一有文档说明的路径

兼容 Anthropic 的端点是一条正式的设置路径,而且它比 README 所暗示的范围更窄。同时设置以下两个变量后,设置过程会创建一个带有按主机名注入请求头的 OneCLI 机密,仅将基础 URL 写入 only .env,并注册自定义端点提供商配置。

设置之前
# NanoClaw's credentials guide: set BOTH before running setup.
# Only one of the two is not enough — setup takes this branch only when
# no Anthropic secret exists yet, and the URL is an origin with no /v1.
export NANOCLAW_ANTHROPIC_BASE_URL=https://api.kunavo.com
export NANOCLAW_ANTHROPIC_AUTH_TOKEN=<your key>

# The same two values exist as setup flags:
#   --anthropic-base-url   --anthropic-auth-token

由此构成方式可知,有四项限制。两个变量都是必需的——设置分支会检查这两个变量是否同时存在。该分支仅在尚不存在 Anthropic 机密时运行,因此这是首次安装路径,而不是重新指向已经连接 Claude 的机器的方法。机密会绑定到从 URL 中解析出的主机名,因此更换域名意味着需要重新构建机密。此外,URL 必须是 origin:Kunavo 自己的ANTHROPIC_BASE_URL 参考说明了为什么 https://api.kunavo.com 可以工作,而 https://api.kunavo.com/v1 会向 /v1/v1/messages 发送请求。

同时固定模型。没有自行指定模型的组会运行 Claude Code 的默认模型,而默认模型会跟随最新的 Opus——根据 NanoClaw 的变更日志,自 v2.4.0 起为 Opus 5.5——而 Kunavo 尚未提供的模型会返回 404。该安装的 .env 文件中的 NANOCLAW_DEFAULT_MODEL 会为所有尚未设置模型的组指定默认模型;环境变量参考说明,变更需要重启主机,然后重启受影响的会话。

NanoClaw 主机上的 .env
# NanoClaw 2.4.0+: the model for every agent group that has not set its
# own (a group's own model wins). Install-wide, so Codex and OpenCode groups
# without one get it too; on a mixed install set each Claude group instead:
#   ncl groups config update --id <group> --model <model>
NANOCLAW_DEFAULT_MODEL=claude-sonnet-5

在容器内部,你的令牌永远不会出现。NanoClaw 的Claude 提供商会注入基础 URL 和 ANTHROPIC_AUTH_TOKEN=placeholder,保管库网关则在网络传输时重写 bearer——这也意味着注入依赖于容器使用其配置的 HTTPS_PROXY。任何绕过该代理的操作也会绕过凭据。在 v2.3.0 中,驱动程序会拒绝任何在贡献的环境变量中携带凭据值的容器规范,因此将真实密钥手动编辑到生成的 container.json 中,会因策略而被拒绝,而不仅仅是不被建议。

两个官方来源对普通 .env 版本的说法并不一致,但两者都值得了解。README 在 .env 中将 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 标注为“用于一次性实验”,而环境变量参考则说明,只有在设置过程注册了自定义端点提供商配置后,ANTHROPIC_BASE_URL 才会生效。在当前 main 分支上,令牌部分永远不会到达请求:上文链接的 Claude 提供商文件只会向 .env 请求 ANTHROPIC_BASE_URL,并将 ANTHROPIC_AUTH_TOKEN 设置为字面字符串 placeholder。应将 README 片段严格视为其标注的实验内容,并将上面的设置路径视为你实际会运行的配置。

默认与扩展:每条路径实际安装了什么

方式如何获取凭据存放位置增加了什么或产生什么费用
Claude(默认)开箱即用OneCLI 保管库,主机模式 api.anthropic.comAnthropic API 密钥,或 Pro/Max 订阅令牌
兼容 Anthropic 的端点两个设置变量,仅限首次安装保管库,按你的主机名关联你的网关按令牌计费的费率;NanoClaw 不收取费用
OpenCode/add-opencode保管库,带匹配的主机模式——从不使用 .env通过 OpenCode 自己的配置路由:OpenRouter、DeepSeek、OpenAI、Google、Anthropic 或 OpenCode Zen。在固定的强化运行时安装中,它会编辑 agent-runner 锁文件,因此重建时会降级为本地构建
Codex设置过程的运行时选择器会直接安装它,之后也可以运行 /add-codex保管库,主机模式为 api.openai.com / chatgpt.com;主机会去除 OPENAI_API_KEYChatGPT 订阅或 OpenAI API 密钥;ChatGPT 列出 Go 每月 8 美元、Plus 每月 20 美元、Pro 每月起价 100 美元、Business 按年计费时每用户每月 20 美元
Ollama(本地)/add-ollama-provider——请参见注意事项不适用;根据NanoClaw 的 Ollama 说明,该路径会设置 NO_PROXY,使请求跳过注入凭据的代理没有托管模型账单;费用转为硬件和运营成本

核查来源日期为 2026 年 9 月 21 日:NanoClaw 的提供商指南、其 /add-opencode 和 /add-codex 技能文件、docs/ollama.md,以及ChatGPT 定价页面(旧 Codex 定价 URL 现在会重定向到该页面)。第一列遵循同一份提供商指南,其中说明设置过程的运行时选择器提供在设置过程中直接安装 Codex 的选项,而 OpenCode 则通过 /add-opencode 在设置后添加。Ollama 的注意事项来自供应商自身:提供商指南说明该技能仍保留在仓库中,但针对的是较旧的配置路径,这些旧版编辑“不是当前 main 分支上受支持的即插即用切换”,集成需要先移植和测试——而 README 仍将其列为受支持路径。两者不一致时,以更新且更具体的提供商指南为准。OpenRouter 通过 OpenCode 后端到达 NanoClaw,而不是通过 Anthropic 基础 URL;OpenRouter 常见问题说明,使用银行卡购买额度时收取 5.5% 且最低 0.80 美元,使用加密货币时收取 5%,推理本身不加价。

一个 NanoClaw API 成本估算示例

这是基于所述假设的令牌算术,不是实测任务成本,也不是账单上限。假设一个代理组每天处理40 轮,每轮发送30,000 个输入令牌并返回1,500 个输出令牌,且没有任何内容来自缓存。费率采用实时的Kunavo 目录价格,按每百万令牌计费。

模型每 1M 个令牌的输入 / 输出估算单日估算的 30 天月份
Claude Haiku 4.5$0.70 / $3.50$1.05$31.50
Claude Sonnet 4.6$2.10 / $10.50$3.15$94.50
Claude Sonnet 5$1.40 / $7.00$2.10$63.00
Claude Opus 5$3.50 / $17.50$5.25$157.50

有三点需要解读。第一,Claude Sonnet 5 和 Claude Opus 5 不再采用相同的目录费率,因此选择前请直接比较这两行——按照Anthropic 发布的同一 Opus 5 模型 ID 的费率,即每百万令牌输入 $5.00、输出 $25.00,同样一个月的估算费用为 $225.00。第二,缓存对费用的影响比选择模型条目更大,因为同一页面将缓存读取定为基础输入价格的 0.1 倍、五分钟缓存写入定为 1.25 倍:如果上述输入的 70% 为缓存读取,按目录中每百万令牌 $0.35 的缓存输入费率计费,则使用同一 Claude Opus 5 模型时,同样一个月的估算费用为 $78.12,而不是 $157.50。第三,在把这些数字当作预算前,先根据你自己的渠道调整轮数——连接到繁忙群聊的 NanoClaw 代理,与连接到单个人的代理,工作负载并不相同。

Kunavo 的目录金额是计费下限,而不是上限:上游报告费用后,账单取目录成本与上游成本乘以适用加价之间的较大值。预付额度的最低充值金额为$10——这是资金充值最低额,不是任务费用或订阅费用。请参阅账单详情和使用量报告。

最低验证,以及之后扩展会产生的成本

最便宜且有用的检查很简单:setup/index.ts会注册一个 verify 步骤,而 /add-opencode 技能自身的验收方式是发送一条消息、确认回复,然后再发送第二条消息以确认会话仍在继续。对于自定义端点,docker exec <container> env | grep ANTHROPIC 应在占位令牌旁显示你的基础 URL——如果那里显示的是真实密钥,说明路径存在问题,而不是运行正常。

然后计算维护成本,因为扩展提供商是固定版本的软件。NanoClaw 的变更日志记录称,之前的 Codex 固定版本默认使用了一个 OpenAI 于 2026 年 8 月 31 日从 Codex 中退役的模型,并且重新运行 /add-codex 不会重新固定已有安装——当前固定版本是 @openai/codex 0.155.1,自 v2.4.0 起生效。OpenCode 的固定版本本身也存在实时来源冲突:仓库的技能文件说两个固定版本都必须准确为 1.18.25,而已发布的提供商指南仍写着 1.4.17。仓库是更具体的来源;此外,OpenCode 已迁移组织——sst/opencode 现在会 301 重定向到 anomalyco/opencode,最新版本为 v1.18.31,发布于 2026 年 9 月 14 日。使用 OneCLI 1.41.0 的安装在 OpenCode ChatGPT 登录过期时,也需要手动重新认证。

根据提供商指南,离开 Claude 提供商后,能力会发生变化:OpenCode 和 Codex 都声明没有原生斜杠命令,都会将后续消息排队,而不是接受轮次中途的输入;Codex 读取 AGENTS.md 时上限为 32 KiB,而 Claude 为 4 MiB;只有 Claude 提供商会轮换会话记录。切换组会保留 memory/ 树,但不会保留进行中的对话上下文,并且更改只有在下一次生成容器时才会生效。

将 NanoClaw 指向 Kunavo

Kunavo 为此类客户端发布了配置参考——Claude Agent SDK和Claude Code指南涵盖默认运行时,OpenCode和Codex CLI指南涵盖两个扩展运行时。这些是已发布的设置参考,而不是兼容性测试:这里没有对 NanoClaw 进行运行时测试,上述内容都是对其仓库和文档的解读。尝试时请保留一条可用路径,运行一个范围受限的任务,然后查看你的账户记录了什么。准备为密钥充值时,请创建 Kunavo 账户。

你是在代理之间而不是提供商之间做选择吗?NanoClaw 与 OpenClaw比较了隔离性和提供商自由度,OpenCode 定价、Codex 定价和OpenRouter 替代方案介绍了本页面作为附加项处理的三条路径。Claude Code 定价更详细地介绍了默认运行时自身的计费。

常见问题

NanoClaw 的成本是多少?

NanoClaw 本身的价格是 $0。其主页 FAQ 称它在 MIT 许可证下免费且开源,并且你的代理提供商可能会对模型使用收费;nanocoai/nanoclaw 仓库采用 MIT 许可证;文档网站自身的页面索引列出 56 个页面,其中没有定价、计费或套餐页面(截至 2026 年 9 月 21 日核查)。没有用户账户,也没有付费层级。你实际需要预算三项:你接入的提供商收取的模型 API 账单、如果你的公司超出 Docker 的免费使用阈值则需要支付的 Docker Desktop 订阅费用,以及在本地运行模型时所需的硬件费用。另一个项目 Clawland-AI/nanoclaw 是面向单板计算机的 Python 代理,其硬件成本不属于本产品。

NanoClaw 可以使用自定义 API 端点吗?

可以,通过一条有文档记录的路径:在运行设置之前设置 NANOCLAW_ANTHROPIC_BASE_URL 和 NANOCLAW_ANTHROPIC_AUTH_TOKEN(或对应的 --anthropic-base-url 和 --anthropic-auth-token 标志)。两者必须同时设置;只有在尚不存在 Anthropic 密钥时,该分支才会运行;基础 URL 必须是没有 /v1 路径的源站,因为 Anthropic SDK 会自行追加 /v1/messages——Kunavo 自己的 ANTHROPIC_BASE_URL 参考说明了这一陷阱。然后,设置流程会将令牌存储在以该主机名为键的 OneCLI 保管库中,只将基础 URL 写入 .env,并注册自定义端点提供商。NanoClaw README 中的两行 .env 代码片段在其中被描述为用于一次性实验;而在当前 main 中,没有任何代码会从 .env 中读取 ANTHROPIC_AUTH_TOKEN 值并发送到上游——Claude 提供商只从 .env 请求 ANTHROPIC_BASE_URL,并将令牌硬编码为 placeholder——因此该片段不是生产路径。Kunavo 未对这条路径进行运行时测试;这是对 NanoClaw 自己的文档和源代码的阅读结论。

NanoClaw 能与 OpenRouter 配合使用吗?

NanoClaw 自己的文档支持的路径是 /add-opencode,并选择 OpenRouter 作为 OpenCode 后端,而不是覆盖 Anthropic 基础 URL——OpenCode 读取 OPENCODE_PROVIDER、OPENCODE_MODEL 和 OPENCODE_BASE_URL,其密钥存储在 OneCLI 保管库中,而不是 .env 中。OpenRouter 自己关于 NanoClaw 的 works-with 页面(openrouter.ai/works-with-openrouter/nanoclaw,截至 2026 年 9 月 21 日核查)只是一个三步目录占位页——创建账户、添加余额并创建密钥,然后在 NanoClaw 中配置——没有列出环境变量、配置文件或模型 ID,而且仍然链接到旧的 qwibitai 地址,因此不能作为经过测试的集成证据。费用方面,OpenRouter FAQ 称其不对推理加价;使用银行卡购买充值额度时收取 5.5% 的手续费,最低为 $0.80;使用加密货币充值时收取 5%;自带密钥的使用量超过每月免费额度的部分收取 5%(截至 2026 年 9 月 21 日核查)。

NanoClaw 最好的 API 是什么?

这取决于你要为哪个运行时付费,因为 NanoClaw 的默认配置不是通用提供商列表。开箱即用时,它通过 Anthropic Claude Agent SDK 在容器内运行 Claude Code,因此可选的是 Anthropic API 密钥、Claude 订阅令牌,或通过设置流程注册的 Anthropic 兼容端点。除此之外,providers 指南称,设置流程的运行时选择器可以内联安装 Codex,而 OpenCode 则在设置后通过 /add-opencode 添加,Ollama 工作流被标记为 legacy——每种替代方案都有自己的凭证入口、固定的 CLI 版本和维护工作。想使用供应商自己的缓存和批处理折扣时,直接供应商密钥更合适;想在多个模型系列之间共用一个密钥和一个余额时,网关更合适;重度日常使用且希望固定费率时,订阅更合适;需要隐私或处理少量工作且不想按请求付费时,本地模型更合适,但 NanoClaw 当前文档将其 Ollama 技能标记为 legacy,并且不支持在当前 main 中直接切换。

NanoClaw 最便宜的 API 是什么?

列出的最低费率和完成工作的最低成本是两个不同的问题;对于长期运行的消息代理,它们之间的差距主要来自缓存。Anthropic 的定价页面将缓存读取定为基础输入价格的 0.1 倍,将五分钟缓存写入定为 1.25 倍,适用于本页定价的 Claude 模型。因此,对于每轮都重新发送大型稳定提示词的代理,缓存行为对账单的影响大于模型层级的一步变化。一条有文档记录的路径会失去这种缓存优势:NanoClaw 自己的 Ollama 说明(docs/ollama.md)称,Claude Agent SDK 会在每个请求前加上一个哈希,从而使 Ollama 的提示词缓存失效,除非在其前面运行过滤代理——同一说明还称 Codex 和 OpenCode 从不发送该哈希。请选择能够在无需重试的情况下完成回合的最低价模型,然后查看提供商账户实际记录的费用。

NanoClaw 最好的模型是什么?

在默认 Claude 提供商中,一个组的模型可以接受别名 sonnet、opus 或 haiku,也可以接受完整模型 ID;effort 可设置为 low、medium、high、xhigh 或 max;未设置模型时,会回退到 NANOCLAW_DEFAULT_MODEL,然后再回退到 SDK 默认值。因此,模型选择是按组设置的,你可以针对每个代理进行调整,而不必做出一个全局决定。关于费用,有两点实用说明。Kunavo 的目录列出 Claude Sonnet 5 的每百万 token 价格为 $1.40 / $7.00,Claude Opus 5 的价格为 $3.50 / $17.50,因此在假定费用变化方向之前,请先比较两者。此外,NANOCLAW_FAST_MODE 的文档说明,当其值为 1 或 true 时,会启用 Claude 的快速服务层级,并明确指出这可能改变提供商计费——Anthropic 对该层级收费;其价格页面称该层级处于研究预览阶段,在仅限第一方 Claude API 上,Claude Opus 5 和 Claude Opus 4.8 的价格为每百万输入 $10、每百万输出 $50(检查于 2026 年 9 月 21 日)。NANOCLAW_DEFAULT_MODEL 和 NANOCLAW_FAST_MODE 均随 2026 年 9 月 23 日发布的 v2.4.0 提供(检查于 2026 年 9 月 24 日),且默认模型作用于整个安装,因此没有自行指定模型的 Codex 和 OpenCode 组也会使用它。

撰写本页时,于 2026 年 9 月 21 日直接获取了以下资料:nanocoai/nanoclaw 仓库记录和发布列表、package.json、container/cli-tools.json、README、加固镜像文档、nanoclaw.dev、文档索引、凭据、环境变量和提供商页面、docs/ollama.md、更新日志、/add-opencode 和 /add-codex 技能文件、OneCLI 仓库以及 Anthropic 的定价页面。Docker、Claude 订阅、ChatGPT 和 OpenRouter 的金额引用自同日记录的各供应商官方定价页面,并未在此重新获取,因此请在供应商的结账页面确认这些金额。Kunavo 的 token 费率来自实时目录。添加模型版本锁定时,于 2026 年 9 月 24 日重新核查了 v2.4.0 版本、其更新日志、container/cli-tools.json 和环境变量参考文档。本页所有内容均未在 NanoClaw 安装实例上进行运行时测试,所有美元金额均为用于说明的 token 费用计算结果。