夜雨聆风哈喽，大家好！
最近不是开始玩 OpenClaw 了吗，本着"踩坑快乐"的原则，我硬是用了一个月，终于把能踩的坑都踩了个遍🤦♂️
今天含泪整理出这十个坑，希望能帮你少走弯路——
坑1：
以为装好就能用，结果卡在第一步
症状：安装完成，一运行——"command not found"
原因：没配置环境变量，或者 Node 版本太低
避坑：
# 先检查 Node 版本\nnode --version\n\n# 建议 Node 22+\n# 安装后记得 source 一下配置文件\nsource ~/.bashrc坑2：
配好了微信却收不到消息
症状：扫码配对成功，但消息石沉大海
原因：没开"允许接收消息"，或者网络不通
避坑：检查 channels.wechat.allowFrom 配置，确保自己的微信号在白名单里
坑3：
AI 回答太长，看不完
症状：一个问题换來一大段话，信息过载
原因：默认模型太"话痨"
避坑：使用 /think low 或在配置里设置 thinkingLevel
坑4：
群聊消息轰炸，AI 疯狂@你
症状：群里每条消息都回复，吵翻天
原因：没设置群聊激活模式
避坑：使用 /activation mention，只有@你时才说话
坑5：
想让它发图片，结果发了链接
症状：让发图片，结果一串文字
原因：没配置图片模型，或者用了不支持的模型
避坑：确保豆包/千问 API Key 配好了，别忘了充钱💰
坑6：
文件发过去，显示"不支持"
症状：PDF/Word 发过去，AI 说"臣妾做不到"
原因：不是所有格式都支持
避坑：目前支持 txt、md、jpg、png、mp3 等，复杂格式先转成 PDF
坑7：
群聊隐私泄露，信息被其他群看到
症状：A群说的话，B群也知道了
原因：没配置会话隔离
避坑：每个群对应独立会话，关键信息用 /new 开启新会话
坑8：API Key 配错了，报错到心态崩
症状：一运行就报错，提示 "invalid api key"
原因：Key 复制粘贴少了一位，或者用了错误的模型名称
避坑：建议用环境变量文件 .env 管理，别直接写死在配置里
坑9：
想让它定时任务，结果忘了配置
症状：说好的"每天早上叫我起床"，结果没动静
原因：没启用 cron 功能
避坑：配置 tools.cron.enabled: true，并设置正确的时区
坑10：
升级后不兼容，之前配置全挂了
症状：更新版本后，AI 完全不工作了
原因：大版本升级有 breaking changes
避坑：
每次升级前看 changelog 重要配置记得备份 敢用 openclaw update --channel stable
总结
OpenClaw 确实香，但有些坑真的是"不踩不知道，一踩吓一跳"😅
希望这份小白避雷攻略能帮你少走弯路，快速上手这个强大的 AI 助手。
如果你也有踩坑经历，欢迎评论区说出来，让大家一起乐一乐🤝
本文由 OpenClaw 自动生成，封面配图由豆包 AI 赞助播出 😎