Skip to content

OpenClaw 配置​

OpenClaw 是可在终端中运行的 Agent 工具,支持通过初始化向导配置模型和消息渠道。完成客户端安装后,可以使用 QuickStart 将其连接到 yuyuflow。

本页省略安装脚本

请先按照 OpenClaw 官方文档完成安装。本页只保留初始化、模型选择和验证步骤,不复制安装命令或脚本。

前置条件​

  • 建议使用 OpenClaw v2026.4.24 或更高版本。
  • 已在控制台创建专用 API Key。
  • 已确认目标模型在当前账号和令牌分组中可用。

如果遇到包含 reasoning_content 的 400 错误,先升级 OpenClaw,再重新运行初始化向导。

运行初始化向导​

首次启动或需要重新配置时,在终端运行:

bash
openclaw onboard --install-daemon

按向导完成以下配置:

  1. 确认个人使用和安全提示。
  2. 选择 QuickStart。
  3. 在 Authentication provider 中选择与 yuyuflow 对应的 provider;如果列表中没有该 provider,按客户端当前版本支持的自定义 provider 流程操作。
  4. 输入控制台创建的 API Key。
  5. 选择 Enter model,填写控制台中可用的完整模型 ID。
  6. Message channels 和 Skills 暂时可以跳过,后续按业务需要启用。

参考页面没有公开 OpenClaw 当前版本的配置文件路径、JSON 字段、完整 endpoint 或环境变量名,因此不要把 WorkBuddy 的 models.json 直接复制到 OpenClaw。

地址和模型​

如果初始化向导要求填写地址,请使用当前平台控制台提供的 API 基础地址:

配置项填写内容
Provideryuyuflow 或客户端支持的自定义 provider
API Key控制台创建的专用 API Key
Model控制台显示的完整模型 ID
Base URLhttps://art-api.yuyuflow.com(仅在向导要求时填写)

OpenClaw 的具体协议和 endpoint 可能随版本变化,请以向导和官方文档为准。不要将 Responses API、Chat Completions 或 Claude 兼容地址混用。

验证 OpenClaw​

初始化完成后,可以使用以下入口检查客户端是否能够正常工作:

bash
openclaw dashboard
openclaw tui
openclaw terminal

先发送一条简单消息,确认鉴权、模型和网络连接正常,再启用渠道或 Skills。

常见问题​

初始化后仍然使用旧模型

重新运行 openclaw onboard --install-daemon,确认 provider 和 model 已更新,并完全退出旧的 OpenClaw 进程后再启动。

返回 `401` 或 Authentication 错误

确认 API Key 属于当前平台和工作区,没有过期或多余空格;同时检查向导中的 provider 没有选错。

返回 `400` 且包含 `reasoning_content`

先升级到建议版本,再重新初始化。旧版本可能无法处理模型返回的字段。

返回 `404` 或模型不存在

使用控制台显示的完整模型 ID,确认模型已开通并且当前令牌分组有权限。

找不到配置文件或想手动修改

参考页面未确认 OpenClaw 当前版本的配置文件 schema。优先使用 onboarding 向导,不要照搬其他 Agent 的配置文件字段。

下一步可阅读 Agent 工具总览、LLM 配置、OpenCode 配置 或 Hermes 配置。