OpenClaw
在 OpenClaw(原 Clawdbot)中配置 ZeoAPI
安装 Openclaw
WARNING
由于 OpenClaw 更新较慢,若默认列表中没有可用模型,可按下方步骤手动配置 ZeoAPI 并重启网关。
WARNING
openclaw老用户,建议也先通过以下安装命令对openclaw进行更新。
在终端中运行以下命令一键安装:
curl -fsSL https://openclaw.bot/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
配置 ZeoAPI 模型
CC-Switch 是一个便捷的桌面工具,可以快速切换 OpenClaw 等 CLI 工具的 API 配置。
安装并启动 CC-Switch
参考 Claude Code 文档中的 CC-Switch 安装说明 完成安装。
添加 ZeoAPI 配置
启动 CC-Switch,点击顶部的 OpenClaw 标签页,然后点击 「添加供应商」,选择预设的 ZeoAPI 供应商,填写您的 API Key。

配置模型
将模型名称改为您要使用的模型,完成后点击 「添加」。

启用配置
回到主界面,点击 「启用」 或通过系统托盘直接切换。重启终端后生效。
选择配置选项
如果openclaw的初始配置引导没有出现模型配置,则可以通过以下命令再次进行 openclaw 配置:
openclaw configure
选择配置选项
- Where will the Gateway run? → 选择 Local (this machine)
- Select sections to configure → 选择 Model
- Model/auth provider → 选择 ZeoAPI
- ZeoAPI auth method → 选择 ZeoAPI CN — OAuth (zeoapi.com)

登录授权
自动弹出登录页,登录并授权。

确认模型选择
OAuth 登录完成后,进入模型选择。若列表中已显示可用模型,可直接按回车确认使用。

测试对话
输入 openclaw tui,若成功对话则表示配置成功:

WARNING
推荐使用「一键安装OAuth并登录」的方式进行安装。若登录失败,可尝试以下方法。
进入配置流程
初次安装时一般会直接进入配置流程。若没有自动开始,可通过以下命令手动启动:
openclaw onboard --install-daemon

基本配置选择:
- Step 1: 同意声明 → 选择 Yes
- Step 2: Onboarding Mode → 选择 QuickStart
WARNING
如果openclaw的初始配置引导没有出现模型配置,则可以通过以下命令进入 openclaw 配置:
openclaw configure
对于 "Where will the Gateway run?" 项,选择 Local (this machine);对于 "Select sections to configure" 项,选择 Model。
模型配置
- Step 1: Model/auth provider → 选择 ZeoAPI
- Step 2: ZeoAPI auth method → 选择 ZeoAPI CN — API Key (zeoapi.com),海外用户选择 ZeoAPI Global — API Key (zeoapi.com)

- Step 3: ZeoAPI API key → 填入您的 ZeoAPI API Key
- Step 4: Models in /model picker → 直接回车使用默认选项
功能配置
- Step 1: 按需选择 channel(需要在什么 App 中进行对话)
- Step 2: 按需配置 Skill
- Step 3: 按需启用 Hooks(可选):
- 💾 session-memory: 执行
/new时自动保存会话上下文 - 📝 command-logger: 记录所有命令到日志文件
- 🚀 boot-md: 网关启动时运行 BOOT.md
- 💾 session-memory: 执行
测试对话
输入 openclaw tui,若成功对话则表示配置成功:

TIP
使用 ZeoAPI 作为模型提供商时,OpenClaw 的 image 工具会自动配置为使用 ZeoAPI 图像理解 MCP 服务背后的 VLM 端点,无需额外配置即可让您的智能体具备图像理解能力。