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。
#重要提示
Base URL 必须包含 /v1
OpenClaw 使用 OpenAI 兼容接口,因此 API Base URL 应填写
https://api.ziyelian.site/v1。模型名称应与智叶模型广场中兼容分组展示的名称一致,API Key 则替换为你自己的密钥。
#支持的模型
具体可用模型以模型广场中对应分组为准:
- 可用模型请前往智叶实时模型与定价页面查看
- 其他可用模型请查看智叶 API 控制台
#验证配置
保存配置后,在 OpenClaw 中发送:
你好,请介绍一下你自己能够正常收到回复,即表示 Base URL、API Key 和模型配置有效。
#故障排除
#问题:连接失败
检查 Base URL 是否为 https://api.ziyelian.site/v1,并确认网络能够访问该地址。
#问题:401 错误
确认 API Key 已正确复制、以 sk- 开头且仍然有效;必要时在 智叶 API 控制台重新生成。
#问题:模型不可用
回到智叶模型广场确认模型名称,并选择 OpenAI 兼容分组中的模型。
#下一步
- 查看 API 端点说明。
- 查看 常见问题。
- 查看 Claude Code 配置。
- 查看 CodeX 配置。
OpenClaw 的配置界面可能随版本更新变化,遇到差异时请参考其官方文档。