一、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/v1 与 https://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 消耗较大,注意余额。
