OpenClaw
OpenClaw 接入 菜ai 教程
本文将引导你通过 Custom Provider（自定义提供商）的方式，使用 OpenAI 兼容接口将 菜ai 轻松接入 OpenClaw。
1. 准备 菜ai 接入信息
开始之前，请先登录 （国际站）菜ai 控制台，创建并复制您的 API Key。建议准备好以下信息以备后续填写：
| 配置项 | 推荐填写内容 | 注意事项 |
|---|---|---|
| API Key | sk-xxxxxxxxxxxxxxxx | 请直接填写原始 Key |
| Base URL | https://cloud.ai.liandxu.cn/v1 | 包含 /v1。 |
| 模型名称 | 例如 gpt-5 | 填写 菜ai 实际支持且你账号有权限调用的模型。 |
2. 安装 OpenClaw
如果你还未安装 OpenClaw，请打开终端（Terminal）或 PowerShell 执行以下命令。OpenClaw 推荐使用 Node 24（兼容 Node 22 LTS）。你可以先运行 node --version检查当前环境。
node --version
- 如果环境没有Node 24，点击跳转下载
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（PowerShell）
iwr -useb https://openclaw.ai/install.ps1 | iex
3. 启动配置向导
安装完成后，如果没有自动化启动配置，运行以下命令开始初始化配置（此过程将配置认证、网关等基础设置）：
openclaw onboard --install-daemon
提示：如果你之前已经初始化过 OpenClaw，只需运行
openclaw onboard即可重新配置。
openclaw onboard
4. 选择并配置 Provider
在 CLI 交互界面中，注意以下特别的步骤完成 菜ai 的接入：
-
选项：I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
- 选 yes
-
选项：Onboarding mode
- 选 QuickStart
-
在Model/auth provider：选择 Custom Provider。
-
填写 Base URL：输入
https://cloud.ai.liandxu.cn/v1(注：如遇网络波动，也可替换为备用节点https://platform.ai.liandxu.cn/v1或https://cloud-hk.ai.liandxu.cn/v1) -
填写 API Key：直接粘贴原始 Key，例如
sk-xxxxxxxxxxxxxxxx。 -
选择兼容类型：选择 OpenAI-compatible。
-
填写 Model ID：输入你希望调用的模型名称，例如
gpt-5.4。 -
设置 Endpoint ID：给这个配置起个好记的名字，例如
dataeyes-main，方便未来管理多个节点。
5. 完成设置与交互测试
按照向导提示，继续完成剩余的按需配置（如是否启用 channel、安装 skills 等）。如果是首次测试，建议直接完成最小化安装。
配置完成后，最快的测试方式是启动 Dashboard 进行网页交互：
openclaw dashboard
如果需要在后台运行或查看状态，可以使用以下命令：
# 查看运行状态
openclaw gateway status
# 排查问题时，可指定端口前台运行
openclaw gateway --port 18789
此时，你可以直接在浏览器访问 http://127.0.0.1:18789/，向机器人发送第一条消息，体验 菜ai 带来的极速响应！
常见问题排查 (FAQ)
Q1：提示 API Key 认证失败怎么办？
- 检查是否误填了
Bearer sk-...，请确保只填写了sk-开头的原始字符串。 - 检查填写的 Base URL 是否正确包含了
/v1后缀。
Q2：提示模型不可用或找不到模型？
- 检查填写的 Model ID 是否拼写正确，且该模型在 菜ai 平台处于可用状态（未下架且余额充足）。
Q3：遇到连接超时或 Dashboard 打不开？
- 运行
openclaw gateway status确认本地网关服务已启动。 - 检查本地网络是否对设定的 Base URL 有访问限制。