龙虾 OpenClaw 安装指南
本教程以 OpenClaw 官方安装方式为主,配置部分统一使用 Rsta。
一、官方链接教程
- OpenClaw 安装文档:https://docs.openclaw.ai/install
二、基础环境设置
建议先安装 Git 和 Node.js,再安装 OpenClaw。
安装 Git
- 官网下载:https://git-scm.com/downloads
- Windows 直达:https://git-scm.com/download/win
安装 Node.js
- 建议版本:Node.js 24
- 兼容版本:Node.js 22.16+
- 下载页:https://nodejs.org/en/download/
安装完成后,先检查环境:
bash
git --version
node -v
npm -v如果这 3 个命令都能正常显示版本号,再继续下一步。
三、安装 OpenClaw(也可以直接给 Codex 发信息,下面是提示词)
版本一:本机电脑通用版(Windows / macOS / Linux)
把下面这段直接发给 Codex,让 Codex 帮你在当前电脑上安装 OpenClaw:
text
请帮我在当前系统上部署 OpenClaw,并最终让我能通过网页打开聊天界面。
要求:
1. 不要只分析,直接执行安装和配置
2. 优先使用 OpenClaw 官方推荐安装方式,不要只停留在克隆 GitHub 仓库
3. 自动识别当前系统是 Windows、macOS 还是 Linux,并选择对应安装方式
4. 安装完成后,配置我的 Rsta 提供商
5. 模型使用 Rsta/gpt-5.5
6. 需要我输入 API key 时再停下来问我
7. 最终目标是让我可以打开本机的 OpenClaw 网页聊天界面
8. 安装完成后,帮我检查:
- openclaw --version
- openclaw gateway status
- openclaw models status
9. 如果 shell 或脚本执行受限,请自动切换为当前系统可用的等价命令
10. 如果网页打不开、缺少 token、模型未注册、API key 未导入,请继续处理,不要停在中间
11. 如果是桌面系统并且可打开浏览器,就直接帮我打开网页;如果不能自动打开,就输出可直接访问的完整地址
12. 不要把 Linux 的路径配置误写到 Windows,也不要把 Windows 的命令写到 macOS / Linux
我的模型提供商信息:
- provider: Rsta
- baseUrl: https://rsta.uk
- auth: api-key
- api: openai-responses
- model: gpt-5.5版本二:远程服务器专用版(Linux 服务器 / 云主机 / SSH 环境)
如果你是在远程服务器上安装,把下面这段发给 Codex:
text
请帮我在当前远程服务器上部署 OpenClaw,并最终让我能从本地电脑访问网页聊天界面。
要求:
1. 不要只分析,直接执行安装和配置
2. 优先使用 OpenClaw 官方推荐安装方式,不要只停留在克隆 GitHub 仓库
3. 自动识别当前系统和 shell,并选择对应安装方式
4. 安装完成后,配置我的 Rsta 提供商
5. 模型使用 Rsta/gpt-5.5
6. 需要我输入 API key 时再停下来问我
7. 远程服务器默认不要直接暴露公网端口,优先使用安全方式访问
8. 如果 OpenClaw 只监听 127.0.0.1,请继续帮我提供正确的 SSH 端口转发命令
9. 如果支持更安全的远程访问方式,也请说明可选方案
10. 安装完成后,帮我检查:
- openclaw --version
- openclaw gateway status
- openclaw models status
11. 如果网页打不开、缺少 token、模型未注册、API key 未导入,请继续处理,不要停在中间
12. 最终请明确告诉我:
- 服务是否启动成功
- 监听地址和端口
- 我在本地电脑上应该执行什么 SSH 端口转发命令
- 然后应该打开哪个网址
我的模型提供商信息:
- provider: Rsta
- baseUrl: https://rsta.uk
- auth: api-key
- api: openai-responses
- model: gpt-5.5安装 OpenClaw 时,可以先不管模型配置。安装完成后,直接编辑配置文件:
text
~/.openclaw/openclaw.json四、手动配置模型
其中模型配置部分 models 可以参考下面模板。
请把:
text
你的秘钥sk-xxxx替换成你在后台 API Keys 页面创建的 sk- 开头密钥。
json
"models": {
"providers": {
"Rsta": {
"baseUrl": "https://rsta.uk",
"apiKey": "你的秘钥sk-xxxx",
"auth": "api-key",
"api": "openai-responses",
"authHeader": true,
"models": [
{
"id": "gpt-5.5",
"name": "GPT-5.5",
"reasoning": true,
"input": [
"text",
"image"
],
"cost": {
"input": 1.75,
"output": 14,
"cacheRead": 0.175,
"cacheWrite": 0.175
},
"contextWindow": 1000000,
"maxTokens": 128000
},
{
"id": "gpt-5.4",
"name": "GPT-5.4",
"reasoning": true,
"input": [
"text",
"image"
],
"cost": {
"input": 1.75,
"output": 14,
"cacheRead": 0.175,
"cacheWrite": 0.175
},
"contextWindow": 400000,
"maxTokens": 128000
}
],
"headers": {
"User-Agent": "Mozilla/5.0 (X11; Linux x86_64) OpenClaw/2026.2.14",
"Accept": "application/json"
}
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "Rsta/gpt-5.5"
},
"models": {
"Rsta/gpt-5.5": {
"alias": "GPT-5.5"
},
"Rsta/gpt-5.4": {
"alias": "GPT-5.4"
}
},
"workspace": "/root/.openclaw/workspace",
"compaction": {
"mode": "safeguard"
},
"maxConcurrent": 4,
"subagents": {
"maxConcurrent": 8
}
}
}配置说明
| 字段 | 说明 |
|---|---|
Rsta | 供应商名称,后面选择模型时会用到 |
baseUrl | API 请求地址,这里填写 https://rsta.uk |
apiKey | 你的 sk- 开头 API 密钥 |
api | 接口类型,使用 openai-responses |
primary | 默认使用的模型 |
contextWindow | 上下文窗口配置,最终以服务端实际支持为准 |
maxTokens | 最大输出 token 配置 |
注意事项
- 供应商名称统一使用
Rsta。 primary里的模型前缀也要使用Rsta,例如Rsta/gpt-5.5。baseUrl使用https://rsta.uk。apiKey必须替换成你自己的密钥。- 修改配置后需要重启 OpenClaw。
- 如果模型不可用,请到后台确认当前账号是否支持该模型。
常见报错
401 Unauthorized
通常是 API Key 错误、没有替换密钥、密钥复制不完整或账号余额不足。
处理方式:
- 重新复制后台 API Key。
- 确认
apiKey已替换。 - 检查后台余额。
- 重启 OpenClaw。
model not found
说明模型名不可用或当前账号不支持。
可以尝试换成后台支持的模型:
text
gpt-5.5
gpt-5.4
gpt-5.4-mini
gpt-5.3-codex
gpt-5.2provider 找不到
检查供应商名称是否一致:
json
"Rsta": {
"baseUrl": "https://rsta.uk"
}以及:
json
"primary": "Rsta/gpt-5.5"