API Usage and Costs

这页说明书主要讲两件事：第一，钱花在哪里能看见；第二，哪些功能可能会花钱。

第一，在哪里能看到花了多少钱？ 这就像你做完游戏后，看看计分板一样。

1. 在聊天时输入 /status 命令，它会告诉你刚才那条回复大概花了多少钱（前提是你用了需要付钱的“魔法钥匙”）。
2. 输入 /usage full 命令，它会在每条回复后面都加上一个小纸条，告诉你花了多少钱和用了多少“词块”（Token）。
3. 在电脑的命令行窗口里，输入 openclaw status --usage 或 openclaw channels list，可以看到你的“魔法钥匙”还剩下多少使用额度，就像看看你的游戏点卡还剩多少点。

第二，哪些功能可能会用到“魔法钥匙”并花钱呢？ 机器人有很多本领，其中一些本领需要借用外面的“魔法工厂”才能完成，借用就要花钱。主要的本领有这些：

1. 核心聊天和工具：每次机器人回答你的问题或者使用工具（比如计算），都会用到当前的“思考模型”（比如 OpenAI、Anthropic），这是花钱最多的地方。
2. 理解图片、声音和视频：如果你发给机器人一张照片、一段录音或视频让它描述，它会请外面的“理解专家”（如 OpenAI、Google）帮忙，这也会花钱。
3. 记忆和搜索：机器人可以把你说过的话变成“记忆种子”存起来。如果设置成使用远程服务（如 OpenAI、Gemini）来制作“记忆种子”，就会花钱。你可以设置成 memorySearch.provider = "local" 来只用自己电脑的力量，这样就不花钱。
4. 网页搜索工具：当你让机器人帮你搜索网页时，它可能会使用 Perplexity、Brave、Google 等搜索服务，这需要对应的“魔法钥匙”并可能产生费用。
5. 抓取网页内容工具：机器人可以用一个叫 Firecrawl 的工具更好地读取网页。如果配置了 FIRECRAWL_API_KEY，用它就会花钱。如果没配置，机器人会用免费的方法抓取。
6. 检查状态：一些检查机器人状态的命令（如 openclaw status --usage）会去问“魔法工厂”你的额度还剩多少，这种询问次数很少，但也会产生一点点网络调用。
7. 整理聊天记录：如果聊天太长了，机器人可以自动帮你把之前的对话总结变短，这个总结过程会用当前的“思考模型”，所以也可能花钱。
8. 扫描可用模型：openclaw models scan 这个命令可以帮你看看有哪些模型可用，如果开启了探测功能，会用到 OPENROUTER_API_KEY。
9. 语音对话：如果开启“对话模式”（Talk），让机器人说话，它可能会使用 ElevenLabs 的服务来生成语音，这需要对应的钥匙并可能花钱。
10. 技能插件：一些额外的技能插件（Skills）可能会使用它们自己的“魔法钥匙”去调用其他服务，费用取决于那个插件的提供商。

需要小心的地方：

• 你的“魔法钥匙”可能藏在好几个地方：机器人的设置文件、电脑的环境变量，或者技能插件的配置里。机器人会自动从这些地方找到它们。
• 记住，只有当你使用了需要外面“魔法工厂”帮忙的功能时，才可能花钱。很多功能也可以设置成用本地电脑免费运行。