OpenClaw 安装与踩坑记录

安装环境:本人主要考虑 ubuntu 虚拟机(基于 pve):

安装过程:直接参考官方文档来,注意避免第三方版本

目录说明:

  • 状态目录 ~/.openclaw/:配置文件、登录信息、会话记录、频道状态
  • 工作空间 ~/.openclaw/workspace/:记忆文件、提示词、龙虾处理过的文件

龙虾命令速查表

龙虾迁移

官方迁移方案

  1. 关闭龙虾:openclaw gateway stop
  2. 创建完整备份:openclaw backup create
  3. 只备份状态目录(可选):openclaw backup create --only-config
  4. 备份文件验证: openclaw backup verify ~/openclaw-backups/openclaw_back.tar.gz
  5. 备份文件还原(在新环境下):tar -xzf openclaw_back.tar.gz
  6. 启动龙虾:openclaw gateway start
  7. 验证龙虾状态: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

参考:

飞牛虚拟机部署OpenClaw详细教程
OpenClaw 配置备份与迁移完全指南

往年同期文章