logo

OpenClaw一键安装后,如何接入大模型

作者:暴富20212026.11.17 03:31浏览量:0

简介:360团队据报道将推出OpenClaw一键安装。装完之后,关键是接入大模型。本文说明OpenAI兼容接口的配置要点,给出curl与Python示例、流式输出和错误处理方法,并介绍Token成本的估算方式,帮助开发者和企业少走弯路。

据周鸿祎公开透露,360团队计划推出“一键安装 OpenClaw”。这类工具的价值不只在于装得快。安装完成后,能否顺利接入大模型,并完成对话测试和自动化流程,才决定实际使用体验。本文不对该产品的发布时间做确认,具体进展请以360官方公告和OpenClaw官方文档为准。

先确认 OpenClaw 是否支持自定义模型接入

很多一键安装工具会预置默认模型。若要接入自己选择的模型,需要先确认所用版本或插件是否支持 OpenAI Compatible(OpenAI 兼容)模式。

  • 支持:在模型提供方中选择 OpenAI Compatible,填写 Base URL、API Key 和 Model ID 即可。
  • 不支持:可以走两条替代路径。一是使用 One API 等中转网关,由网关对外提供统一的 OpenAI 兼容接口。二是改用 OpenClaw 已支持的其他提供方类型,或通过插件扩展。

OpenAI 兼容接口的配置项

支持 OpenAI 兼容模式的工具,通常需要填写以下四项。

配置项 示例 说明
API 域名 / Base URL https://qianfan.baidubce.com/v2 模型服务入口
API 路径 /chat/completions 对话补全接口,与 Base URL 拼接成完整地址
API Key YOUR_API_KEY 建议使用环境变量管理,不要明文填入公开配置
Model ID deepseek-r1 必须与平台模型列表中的名称一致

注意 Base URL 与路径的拼接关系。以千帆为例,完整请求地址是 https://qianfan.baidubce.com/v2/chat/completions。如果漏写 /v2,或路径被重复拼接,请求可能返回 404 错误。示例中的 deepseek-r1 来自原文,实际可用模型以平台列表为准。

用 curl 先验证接口

建议先用 curl 确认接口能通,再去配置 OpenClaw。这样出现问题时,可以快速判断是接口侧还是工具侧的原因。

  1. export QIANFAN_API_KEY="你的密钥"
  2. curl https://qianfan.baidubce.com/v2/chat/completions \
  3. -H "Authorization: Bearer $QIANFAN_API_KEY" \
  4. -H "Content-Type: application/json" \
  5. -d '{
  6. "model": "deepseek-r1",
  7. "messages": [
  8. {"role": "user", "content": "请用三句话介绍 OpenClaw 一键安装的价值"}
  9. ],
  10. "stream": false
  11. }'

用 Python 调用并处理异常

先安装 OpenAI Python SDK,版本需不低于 1.0。

  1. pip install --upgrade "openai>=1.0"

下面的代码从环境变量读取密钥,设置了超时和自动重试,并对常见错误给出明确提示。

  1. import os
  2. from openai import (
  3. OpenAI,
  4. APIError,
  5. APITimeoutError,
  6. AuthenticationError,
  7. RateLimitError,
  8. )
  9. client = OpenAI(
  10. api_key=os.environ["QIANFAN_API_KEY"],
  11. base_url="https://qianfan.baidubce.com/v2",
  12. timeout=60.0,
  13. max_retries=2,
  14. )
  15. def ask(prompt: str) -> str:
  16. try:
  17. resp = client.chat.completions.create(
  18. model="deepseek-r1",
  19. messages=[{"role": "user", "content": prompt}],
  20. )
  21. # choices 是列表,需要用 [0] 取出第一条回复
  22. return resp.choices[0].message.content
  23. except AuthenticationError:
  24. raise RuntimeError("API Key 无效或权限不足,请检查密钥和权限范围。")
  25. except RateLimitError:
  26. raise RuntimeError("触发限流,请降低并发或稍后重试。")
  27. except APITimeoutError:
  28. raise RuntimeError("请求超时,请检查网络,或适当调大 timeout。")
  29. except APIError as e:
  30. raise RuntimeError(f"模型服务返回错误:{e}")
  31. if __name__ == "__main__":
  32. print(ask("请生成一份 OpenClaw 安装后的模型接入检查清单"))

max_retries 会在部分失败时自动重试。重试会产生额外调用费用,因此成本估算时要把重试率计算在内。

流式输出的处理方式

如果业务需要边生成边展示,可以开启流式输出。流式返回的是增量内容

发表评论

活动