TOOLS

OpenClaw 配置

通过 OpenAI 兼容接口,把 OpenClaw 连接到智叶 API。

#什么是 OpenClaw?

OpenClaw 是一款开源 AI 客户端,支持配置多个模型与服务商,并兼容 OpenAI API 格式。

  • 多模型对话
  • 命令行界面
  • 跨平台支持(Windows、macOS、Linux)
  • OpenAI API 兼容格式

配置步骤

OpenClaw 的配置格式随版本变化。请在当前版本的自定义模型服务配置中设置 OpenAI 兼容 Base URL https://api.ziyelian.site/v1、智叶令牌,以及分组支持的模型 ID。

根据模型选择 Chat Completions 或 Responses 协议;媒体端点需要单独的工具或插件,不能直接把图片/视频模型设为聊天 Agent 的主模型。

只设置 OPENAI_BASE_URL / OPENAI_API_KEY 不保证 OpenClaw 会自动读取。请确认当前启用的服务配置使用本站地址与本站 Key。

OpenClaw 官方配置与认证说明

#重要提示

Base URL 必须包含 /v1
OpenClaw 使用 OpenAI 兼容接口,因此 API Base URL 应填写https://api.ziyelian.site/v1。

模型名称应与智叶模型广场中兼容分组展示的名称一致,API Key 则替换为你自己的密钥。

#支持的模型

具体可用模型以模型广场中对应分组为准:

  • 可用模型请前往智叶实时模型与定价页面查看
  • 其他可用模型请查看智叶 API 控制台

#验证配置

保存配置后,在 OpenClaw 中发送:

bash
你好,请介绍一下你自己

能够正常收到回复,即表示 Base URL、API Key 和模型配置有效。

#故障排除

#问题:连接失败

检查 Base URL 是否为 https://api.ziyelian.site/v1,并确认网络能够访问该地址。

#问题:401 错误

确认 API Key 已正确复制、以 sk- 开头且仍然有效;必要时在 智叶 API 控制台重新生成。

#问题:模型不可用

回到智叶模型广场确认模型名称,并选择 OpenAI 兼容分组中的模型。

#下一步

OpenClaw 的配置界面可能随版本更新变化,遇到差异时请参考其官方文档。

本页目录什么是 OpenClaw?