简介:本文讲清OpenClaw如何接入大模型API,包括怎样核实Token额度规则、填写API Key、Base URL和模型名,怎样安全地远程访问,以及常见报错如何排查,帮你用较低成本搭出可用的私人AI助手。
很多人想找一个低成本的大模型API,再把它接入OpenClaw,搭出自己的AI助手。真正需要解决的问题通常不是某个固定模型,而是怎样拿到可用的接口、正确填写配置,并在出问题时快速定位。本文按这条路线展开。
结论先放在前面:优先选择提供试用额度、免费额度或OpenAI兼容接口的模型服务。拿到API Key、接口地址和模型名后,在OpenClaw中填写即可测试。额度用完,或对成本有更高要求时,再考虑切换模型或自建开源模型服务。
OpenClaw常被称为“小龙虾AI机器人”,本质上是运行在电脑或服务器上的AI助手(Agent)。它需要理解自然语言指令、拆解任务并调用工具,这些能力都依赖大语言模型。没有模型API,OpenClaw只能执行固定脚本,无法处理“整理文件夹”“总结网页内容”这类开放式任务。
大模型API通常提供类似/chat/completions的接口。客户端把用户输入、上下文和参数发送过去,模型返回结果。接入时需要三项信息:
Token是大模型计费的基本单位,可以粗略理解为文本的计量单位。输入内容、输出内容、系统提示词和历史对话都会消耗Token。
一些平台会推出几千万Token之类的赠送或试用活动。这类额度通常有条件限制,不应被理解为无限、永久或无条件可用。本文不承诺任何平台一定提供某个数量的额度。遇到类似活动,使用前至少确认以下四点:
活动名称、领取入口和截止时间都应以官方页面为准,核对后再操作。如果准备长期运行OpenClaw,除了免费额度,还要考虑稳定性、响应速度和后续扩容的成本。
如果你不想自己管理显卡和服务器,优先选择云平台提供的API。以百度智能云千帆等平台为例,一般步骤如下:
平台提供OpenAI兼容接口时,可以用下面的命令测试连通性。示例中的占位符需要替换为控制台中的真实内容:
curl https://你的API域名/v1/chat/completions \-H "Authorization: Bearer 你的API_KEY" \-H "Content-Type: application/json" \-d '{"model": "控制台中的模型名称","messages": [{"role": "user", "content": "你好,请回复连接成功"}]}'
如果返回正常的回复内容,说明网络、密钥和模型名基本正确。不同平台的路径可能不同,部分平台使用自定义路径,请以其文档为准。
API Key不要写进代码、截图或聊天记录,也不要提交到Git仓库。更稳妥的做法是把它放在环境变量中,由程序读取。
OpenClaw的安装步骤和配置文件位置会随版本变化,请以所用版本的官方文档为准。安装完成后,在其模型配置项中填写以下内容:
保存后重启OpenClaw服务,让配置生效。然后发送一条简单消息测试。如果没有回复,先查看OpenClaw日志,再对照第八节排查。
如果希望数据更可控,或想长期使用某个开源模型,可以自建推理服务。以DeepSeek等开源大模型为例,在平台部署后,通常会给出调用地址和令牌。访问地址往往需要自行补上/v1。
vLLM是常见的推理框架,可以提供OpenAI兼容接口。启动后,一般通过/v1/chat/completions调用,具体路径取决于启动参数和模型类型。
这条路线的门槛明显更高:
纯新手建议先用云平台API跑通流程,确认实际需求后再考虑自建。
如果OpenClaw部署在开发机或服务器上,可以通过SSH端口转发,把远端服务映射到本地电脑:
ssh -L 18789:127.0.0.1:18789 用户名@服务器公网IP -p 服务器SSH端口
这条命令会把本地18789端口转发到服务器上的同名端口。连接后,在本地浏览器访问127.0.0.1:18789,并按页面提示使用Token登录。这种方式适合临时调试。
不建议把没有鉴权的OpenClaw直接暴露到公网。如果需要从手机等设备长期访问,至少要做到以下几点:
从能跑到好用,可以从以下几方面优化。
1. 按任务路由模型
可以用简单规则决定调用哪个模型,例如:
规则不必复杂,先按任务类型分两档即可。
2. 裁剪上下文
每次都携带完整历史,Token消耗会迅速增长。可以只保留最近几轮对话,或把较早的内容压缩成摘要后再传给模型。
3. 设置重试与退避
遇到429或网络超时,等待后再重试,并逐次延长等待时间。重试次数要设上限,避免无限请求耗尽额度。
4. 记录调用日志
记录每次请求的模型名、耗时、Token用量和错误码。长期运行后,可以据此比较不同模型的成本和稳定性。
如果有多个模型渠道,One API等统一网关工具可以把它们整理成一套接口,便于切换和备份。