OpenClaw 新手避坑指南：高频错误全解析

dctc_青龙

用 OpenClaw 一年多，见过太多人踩坑了。今天把最常见的几个问题整理出来，新来的朋友可以对照着看看自己有没有中招。

## 一、代理配置为什么总是不生效

这个问题问的人最多。

系统代理配好了，浏览器出国没问题，Telegram Bot 也能正常跑，但 OpenClaw 就是不走代理。很多人第一反应是软件有问题，其实是你没有搞懂 OpenClaw 的进程模型。

OpenClaw Gateway 运行在独立的进程树里，有自己独立的环境变量。在 Linux 上，你桌面环境设的代理或者 `/etc/environment` 里的配置跟它没关系。它是从 systemd 服务启动的，走的是 init 的环境变量，跟你的桌面会话八竿子打不着。

最直接的例子：本地电脑测试好好的，部署到 VPS 就不通了。查了半天，最后发现是代理根本没生效。

解决办法很简单，在配置文件里直接指定代理地址：

```json
{
  "network": {
    "proxy": "http://192.168.0.66:7890"
  }
}
```

或者在环境变量里加一行：

```bash
export OPENCLAW_PROXY=http://192.168.0.66:7890
```

内网机器走代理出国的，还要注意 DNS 污染的问题。有些域名国内解析到错误的 IP，走代理反而正常了。如果配了代理网络还是不通，先跑一下 `curl --proxy http://IPORT https://www.google.com` 看看能不能返回 200，确认通了再查 OpenClaw 这边的配置。

## 二、磁盘空间从来不看

OpenClaw 会一直写日志和会话记录。磁盘用到 80% 以上就开始写入失败，撑到 90% 直接罢工。

大部分人都是服务挂了才想起来去查磁盘，结果发现早就满了。建议加个 cron 任务定期检查：

```bash
df -h / | awk 'NR==2 {print $5}' | sed 's/%//'
```

数值超过 80 就该动手清理了，别等到真出事。

## 三、版本更新别太积极

OpenClaw 更新速度挺快，但不是什么版本都值得追。尤其是 major version 跳跃的时候，breaking change 一堆，升级完可能直接原地爆炸。

官方 release notes 里会标注「Requires migration」或者「Breaking change」，这两个词看到了就悠着点。我的做法是：大版本更新必看 release notes，小版本的话等个三五天，看看社区有没有人反馈问题再决定要不要升。

## 四、只配一个模型等于裸奔

现在几家模型的 API 都有 rate limit 问题，minimax 官方标的限制实际上更严格，触发的时候你是完全没有备选方案的。

配个 fallback 不难，但真的能救命：

```json
{
  "model": "minimax/m2.7-highspeed",
  "fallbacks": ["minimax/m2.7", "openai/gpt-4o-mini"]
}
```

主模型挂了自动切到备用，体验上会好很多。

## 五、日志疯狂写入从来不管

OpenClaw 默认日志级别是 info，高频会话下一小时能写出几百兆。一个活跃系统跑一天，日志轻轻松松上几个 G。

改一下日志级别就行，不用那么详细：

```json
{
  "logging": {
    "level": "warn"
  }
```

再配个日志轮转，保留个七八天够用了，没必要留那么久。

## 六、从来不跑 health check

装了系统就跑起来，再也不管，这是大多数人的状态。`openclaw status` 和 `openclaw gateway status` 这两个命令说实话用到的人不多，一般都是服务挂了才想起来跑一下。

建议配个定时检查，僵尸进程、API 异常、磁盘告警这些早点发现比晚发现强太多了。

## 七、插件能装的都装上

OpenClaw 插件生态挺丰富的，但每个插件都要吃内存，还要考虑跟其他插件的兼容性。全装上的结果就是内存占用起飞，说不定哪天两个插件打架你还不知道问题出在哪。

按需启用，用不到的就别装。隔段时间跑一下 `openclaw plugins list`，把不用的清理掉。

## 八、定时任务排得太密

定时任务是方便，但设得太密就是给自己找麻烦。OpenClaw 的 cron 任务共享同一个 executor，三十个任务全都配置成每分钟执行，资源竞争能让你怀疑人生。

优先级高的任务给它单独的资源，低优先级的错开时间跑，别都挤在一起。

## 九、配置文件从来不备份

`openclaw.json` 是整个系统的心脏，改坏了没有备份只能重头配。建议修改之前先备份：

```bash
cp /root/.openclaw/openclaw.json /root/.openclaw/openclaw.json.bak.$(date +%Y%m%d)
```

有条件的话用 git 管理配置目录，版本控制的好处谁用谁知道。

## 十、会话历史从来不清理

OpenClaw 会保存会话历史，时间久了查询变慢，磁盘也扛不住。

配置个自动过期策略省心很多：

```json
{
  "sessions": {
    "maxAgeDays": 30,
    "autoCleanup": true
  }
}
```

三十天以上的自动清掉，别让历史数据一直堆着。

---

这些问题覆盖了配置、运维、监控三个最容易踩坑的方向。核心原则就三句话：盯紧系统状态，修改配置前想清楚，定时清理不要偷懒。OpenClaw 确实是好工具，但再好的工具也得会用才行。

你们还遇到过什么奇葩问题？评论区聊聊，看见过有意思的再补充进来。