OpenClaw 接入教程

本文档用于将 OpenClaw 接入 OpenAI-compatible 接口服务，示例地址为：

https://syapi.deeprespond.cn

请将示例中的 your-api-key 替换为你的实际 API Key。

OpenClaw安装教程

你可以在OpenClaw的开源仓库查看其原本的文档：https://github.com/openclaw/openclaw

也可以参考下述的方法进行安装：

安装OpenClaw（仅支持MacOS和Linux）

npm安装脚本

安装

开启浏览器

在浏览器可以看到界面，说明OpenClaw已经可以运行了，这个阶段OpenClaw没有回复是正常的，完成下述的配置之后，OpenClaw才会有回复，请继续。

查看配置文件是否存在

请查看自己电脑的~/.openclaw/openclaw.json文件是否存在，后续会修改此文件。

准备工作

已安装 OpenClaw

已获取可用的 API Key

macOS / Linux 修改配置

配置文件路径通常为：

~/.openclaw/openclaw.json

不存在时可手动创建。

{
  "provider": "openai",
  "model": "gpt-5.4",
  "providers": {
    "openai": {
      "apiKey": "your-api-key",
      "baseUrl": "https://syapi.deeprespond.cn"
    }
  }
}

如果你的 OpenClaw 版本使用 YAML 配置，路径可能为：

~/.openclaw/config.yml

示例：

模型示例

可按需替换 model 字段：

claude-opus-4-6
claude-opus-4-6-low
claude-opus-4-6-medium
claude-opus-4-6-high
claude-opus-4-6-max
claude-opus-4-7
claude-opus-4-7-low
claude-opus-4-7-medium
claude-opus-4-7-high
claude-opus-4-7-xhigh
claude-opus-4-7-max
gpt-5.5
gpt-5.4
gpt-5.3-codex
gpt-5.3-codex-spark
z-ai/glm4.7
deepseek-ai/deepseek-v4-flash

验证接入

配置完成后，重新打开终端或重启 OpenClaw，然后执行一次简单对话或代码生成任务。

重新启动命令：

示例提示词：

你好，请问你现在使用的是什么模型？

如果能够正常返回结果，说明接入成功。

常见问题

提示 API Key 无效

请检查：

your-api-key 是否已替换为真实密钥。

环境变量是否在当前终端会话中生效。

配置文件中的字段名是否与当前 OpenClaw 版本一致。

提示模型不存在

请确认当前接口服务支持你填写的模型名称。可以先使用：

gpt-5.4

无法连接接口

请检查：

baseUrl / base_url 是否填写为 https://loark.arkplus.top。

网络是否可以访问该地址。

是否被代理、防火墙或安全软件拦截。

配置文件不生效

请注意，不能开启代理；

不同 OpenClaw 版本的配置文件路径和字段名可能不同，请优先以当前版本官方文档为准。常见路径包括：

~/.openclaw/openclaw.json
~/.openclaw/config.yml
%USERPROFILE%\.openclaw\openclaw.json
%USERPROFILE%\.openclaw\config.yml

OpenClaw接入教程

OpenClaw 接入教程#

OpenClaw安装教程#

准备工作#

macOS / Linux 修改配置#

模型示例#

验证接入#

常见问题#

OpenClaw 接入教程

OpenClaw安装教程

准备工作

macOS / Linux 修改配置

模型示例

验证接入

常见问题