安装环境:本人主要考虑 ubuntu 虚拟机(基于 pve):
安装过程:直接参考官方文档来,注意避免第三方版本
目录说明:
- 状态目录
~/.openclaw/:配置文件、登录信息、会话记录、频道状态 - 工作空间
~/.openclaw/workspace/:记忆文件、提示词、龙虾处理过的文件
龙虾迁移
官方迁移方案
- 关闭龙虾:
openclaw gateway stop - 创建完整备份:
openclaw backup create - 只备份状态目录(可选):
openclaw backup create --only-config - 备份文件验证:
openclaw backup verify ~/openclaw-backups/openclaw_back.tar.gz - 备份文件还原(在新环境下):
tar -xzf openclaw_back.tar.gz - 启动龙虾:
openclaw gateway start - 验证龙虾状态:
openclaw status
其他技巧
(1)中转站接口验证,有的中转站默认不支持
# 带 SDK UA → 403
curl -H "User-Agent: Anthropic/JS 0.73.0" \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01" \
https://your-relay.example.com/v1/messages \
-d '{"model":"claude-sonnet-4-20250514","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'
# 普通 UA → 200
curl -H "User-Agent: Mozilla/5.0" \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01" \
https://your-relay.example.com/v1/messages \
-d '{"model":"claude-sonnet-4-20250514","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'
(2)openclaw 开启局域网访问
# 绑定到局域网
openclaw config set gateway.bind lan
# 设置访问密码(必须)
openclaw config set gateway.auth.token 你的密码
# 修改配置项(危险操作,请提前确保局域网安全)
"controlUi": {
"dangerouslyAllowHostHeaderOriginFallback": true,
"dangerouslyDisableDeviceAuth": true,
"allowedOrigins": [
"http://localhost:18789",
"http://127.0.0.1:18789",
"http://192.168.xx.xx:18789"
]
# 重启生效
openclaw gateway restart
参考: