踩坑实录
装 OpenClaw 一个月，踩过的坑比你走过的桥还多（夸张了）。但这些都是真金白银换来的经验，今天全部整理给你，帮你避开 90% 新手都会踩的坑。
坑点 1：Gateway 启动失败
现象：openclaw gateway start后提示端口占用
原因：18789 端口已被占用（可能是之前的实例没关）
解决：
# 查看占用端口的进程
sudo lsof -i :18789
# 杀掉进程
sudo kill -9 <PID>
# 或者更换端口
openclaw config set gateway.port 18790坑点 2：Skill 安装后不识别
现象：安装了 Skill，但 AI 说找不到
原因：Skill 描述写得太模糊，AI 不知道什么时候用
解决：用 Skill-Creator 重新生成，或者手动编辑 SKILL.md，把description写清楚
坑点 3：记忆功能失效
现象：AI 记不住对话内容
原因：嵌入模型未配置
解决：
# 检查记忆配置
openclaw memory status
# 配置嵌入模型（可选，不用也可以）
openclaw configure --section memory其实不配置嵌入模型也能用，只是不能语义搜索而已。
坑点 4：飞书消息发不出去
现象：定时任务执行了，但没收到消息
原因：message 工具用了错误的账户（default 而不是 main）
解决：在 prompt 里明确指定accountId=main
调用 message 工具（channel=feishu, accountId=main, target=user:xxx）坑点 5：股票监控数据不准
现象：港股代码用了 A 股格式
原因：股票代码格式错误
解决：A 股用600036.SH，港股用00941.HK
坑点 6：定时任务不执行
现象：配置了 cron，但到点没反应
原因：Gateway 没运行或 cron 模块未加载
解决：
# 检查 Gateway 状态
openclaw gateway status
# 查看 cron 日志
grep cron /tmp/openclaw/openclaw-*.log坑点 7：web_search 报错
现象：missing_brave_api_key
原因：未配置 Brave Search API Key
解决：
openclaw configure --section web
# 输入 API Key（https://brave.com/search/api/）坑点 8：中文乱码
现象：输出中文是乱码
原因：系统 locale 未配置
解决：
export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8避坑建议
- 先看日志：出问题第一反应应该是看日志，不是重启
- 逐步配置：不要一次装一堆东西，出一个问题都找不到原因
- 定期备份：配置文件和数据库都要备份
- 善用搜索：大部分问题别人都遇到过
写在最后
踩坑是正常的，不踩坑才不正常。关键是踩完要记下来，下次别再踩。
如果你也遇到了什么坑，欢迎在评论区分享，让更多人少踩坑。
下一篇
《AI 自动化工作流搭建指南》—— 手把手教你让 AI 24 小时自动干活