OpenClaw 接入中转 API 教程:自主智能体框架配置

OpenClaw 自主智能体框架接入教程:install.sh 一键安装、onboard 引导配置,或在 openclaw.json 中新增模型 Provider 指向本站网关。

一、OpenClaw 是什么

OpenClaw 是一个开源的 AI 智能体(Agent)框架:你把它指向一个模型(本地或云端网关),它就能在你的电脑上自动化完成任务——操作界面、运行命令、管理文件等。它的核心是「配置一个模型端点」,因此非常适合接入本站网关。

二、安装 OpenClaw

推荐一键安装脚本:

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard

也可以使用 Docker 或源码安装:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Docker:./scripts/docker/setup.sh
# 源码(pnpm):corepack enable && pnpm install && pnpm openclaw setup

三、接入本站网关(两种方式)

方式一:交互式引导(onboard)

运行 openclaw onboard,选择 Provider 时选中支持自定义地址的选项,填入:

Base URL : https://www.azztimes.com
API Key  : sk-你的密钥
Model ID : claude-sonnet-5

(openai / gemini 端点对应 https://www.azztimes.com/v1https://www.azztimes.com/v1beta

方式二:直接改配置文件

OpenClaw 读取 ~/.openclaw/openclaw.json(Linux/macOS)或 %USERPROFILE%\.openclaw\openclaw.json(Windows)。在 models.providers 中新增一个 Provider:

{
  "gateway": {
    "mode": "local"
  },
  "agents": {
    "defaults": {
      "model": {"primary": "jizhi/claude-sonnet-5"}
    }
  },
  "models": {
    "providers": {
      "jizhi": {
        "baseUrl": "https://www.azztimes.com",
        "apiKey": "sk-你的密钥",
        "api": "openai-completions"
      }
    }
  }
}

primary 换成你使用的模型 slug,即可让 OpenClaw 的所有智能体任务走本站网关。

四、启动与常用命令

openclaw gateway --port 18789

启动后访问 http://localhost:18789 进入控制台。常用命令:

openclaw doctor              # 诊断问题
openclaw security audit      # 安全检查
openclaw config set key x    # 修改配置
openclaw channels add --channel telegram  # 添加消息渠道

五、常见问题排查

现象处理
401 / 403密钥无效、未启用或余额不足;确认 sk- 正确并充值。
404 / 模型不可用模型 slug 与平台不一致,或该模型未启用;核对模型 ID。
无法连到模型确认 baseUrl 用的是本站入口。

安全建议sk- 密钥别写法进公开仓库;智能体类任务 token 消耗较大,注意余额。