大家好,最近小龙虾OpenClaw很火,先跟大家说说我的真实部署经历,全是踩过的坑,小白看完能少走90%的弯路!我是在火山ECS上部署的OpenClaw,初衷很简单:想搭几个AI机器人,连飞书收发消息,再用上联网搜索功能。第一坑:改完机器人配置,保存后发消息还是老样子,折腾了半小时才知道,忘了重启网关——相当于给机器人换了新脑子,却没让它重新开机;第二坑:配置文件手敲多了个逗号,直接报错打不开,对着飘红的代码懵圈,不知道怎么修,后来才发现有自动修复的命令;第三坑:想换Tavily搜索,加了配置却报错,以为是密钥错了,查了半天,原来是版本太旧,多写了个系统不识别的参数;第四坑:服务器重启后,机器人直接失联,以为是配置丢了,后来才知道没设置开机自启,每次重启都得手动启动网关。我把常用命令整理出来,不管是改配置、排错还是重启,敲一行命令就搞定,再也不用到处问大佬、翻晦涩文档。今天就把这些命令,全翻译成大白话,搭配我踩过的坑,小白也能一看就懂、一用就会!你可以把网关理解成 OpenClaw 的「快递小哥」:openclaw doctor --fix && openclaw gateway restart
OpenClaw 对 JSON 配置语法特别「矫情」,多打个逗号、引号没成对,直接给你飘红。这时候别慌,用这两个命令: | | |
|---|
| | JSON 语法错、少填了配置、参数无效时,一键修复 |
|---|
| | 刚装/重装 OpenClaw 后,初始化文件夹、权限,让它能正常干活 |
|---|
- 先看状态: openclaw gateway status (确认是不是挂了)
- 再看日志: openclaw logs --follow(看具体报错原因)
- 最后修复: openclaw doctor --fix(让系统自动救场)
机器人是 OpenClaw 的「大脑」,要联网搜索、用 Claude 模型,得给它配「身份证」(API Key): | | |
|---|
| | |
|---|
| openclaw agents add --auth = | | 要用到 Tavily 搜索、Anthropic Claude 模型时,添加 API Key |
|---|
| | |
|---|
openclaw agents add main --auth tavily=tvly-你在官网拿到的密钥
有时候功能用不了,是版本太旧/环境不对,这两个命令帮你查户口:如果你是在火山引擎 ECS 上跑 OpenClaw,它会被注册成系统服务,这两个命令帮你设置「开机自启」: | | |
|---|
| systemctl status openclaw-gateway | | |
|---|
| systemctl enable openclaw-gateway | | |
|---|
nano ~/.openclaw/openclaw.json
"tools": { "web": { "search": { "provider": "tavily", "apiKey": "tvly-你拿到的密钥" } } }
2、修配置 + 重启网关
openclaw doctor --fix && openclaw gateway restart
3、确认状态
07
改完配置必 重启: `openclaw gateway restart`机器人不回消息先看状态: `openclaw gateway status`出问题就看日志: `openclaw logs --follow`配置报错自动修: `openclaw doctor --fix`要联网就加密钥: `openclaw agents add`收藏这篇文章,下次遇到 OpenClaw 问题,直接翻这篇,再也不用到处搜教程、问大佬啦!评论区留个言,说说你最头疼的 OpenClaw 问题是什么?