OpenClaw 踩坑记录

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

# 1.设定网络访问模式为 LAN，不然web可能无法访问

openclaw config set gateway.bind lan

# 2. 设定HTTP访问降级为 true，允许不安全的HTTP访问（如果不设置这个参数，默认是禁止HTTP访问的）

openclaw config set gateway.controlUi.allowInsecureAuth true

openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true

openclaw config set gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback true

# 3. 重启 OpenClaw gateway 使配置生效

openclaw gateway restart 

创建 systemd 服务失败：

    首先运行这个命令，启用用户 linger (确保退出登录后进程不被杀掉)

sudo loginctl enable-linger $(whoami)

    因为需要 sudo ，所以视操作系统不同可能会需要你输入ssh密码，我这里使用Debian是不需要输入密码的 然后运行下列命令，如果输出了类似 /run/user/* 的路径，说明成功了

# 1. 将 XDG_RUNTIME_DIR 写入 ~/.bashrc (如果已存在则跳过，避免重复)

grep -q "XDG_RUNTIME_DIR" ~/.bashrc || echo 'export XDG_RUNTIME_DIR=/run/user/$(id -u)' >> ~/.bashrc

# 2. 立即在当前窗口生效

source ~/.bashrc

# 3. 验证检查

echo $XDG_RUNTIME_DIR

重新安装网关 ：

openclaw gateway install --force

 来源via

上下文字数不足：

打开 /root/.openclaw/openclaw.json，找到 models ，修改 contextWindow 128000和 maxTokens 8196

403 Your request was blocked. API 渠道错误

在 provider 配置里加 headers 字段覆盖 UA：

    "headers": {

      "User-Agent": "Mozilla/5.0"

    },

来源 via

origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins) 的错误提示：

 /root/.openclaw/openclaw.json文件的allowedOrigins错误，

openclaw devices list

openclaw devices approve requestId（换成第一条命令之后后看到的requestid）

来源 via

发送消息403错误：同上

需要添加headers字段覆盖UA：

{

  "my-relay": {

    "baseUrl": "https://your-relay.example.com",

    "apiKey": "sk-your-api-key",

    "api": "anthropic-messages",

    "headers": {

      "User-Agent": "Mozilla/5.0"

    },

    "models": [...]

  }

}

另外需明确配置API的性质，比如Anthropic Messages API，并调整上下文大小值与最大TOKEN值

来源  via