这阵子看到大家都在玩龙虾,虽然官方也提供了文档,大部分公众号的 Docker 参差不齐,实际部署下来也遇到了很多坑。正好最近有吃土的 VPS,重装了最新的 Debian 13,虽然各大面板(BT、1Panel 等)均提供了一键部署,但我觉得要长期用还得按自己的需求来。
首先需要确定使用方式,这决定了你用什么方式部署。先通过 整体了解一下这个项目。
通过阅读文档,我们知道 OpenClaw 可以跑在本地宿主机、虚拟机、云服务器等载体上。如何和它对话呢?它支持非常多的渠道,我选择了 Telegram。
因为小龙虾的能力上限取决于模型能力,所以毋庸置疑,直接选择当前的顶级模型:Claude 或者 GPT。
结论:**配置方案 = 海外 VPS + Telegram + 顶级模型
💡 建议先花点时间阅读一下再动手,以减少后续不必要的麻烦。
运行脚本后,会在宿主机上创建两个重要文件夹,它们会被挂载到 Docker 容器中:
OpenClaw 后会自动打开配置引导:
- 先选择 Skip for now 跳过
- 消息渠道想用 Telegram,需要先做两件事:
- 在 Telegram 中搜索 ,获取自己账号的用户 ID
- 搜索 ,创建机器人:
- 先创建机器人名(昵称)
- 再创建机器人用户名
- 创建好后会给你一个 Bot API Token,记住这个 Token
- 等到 这里的时候,填上一步获取的 Bot API Token
- 一路跳过,hooks 这里选择:
- 等出现 Token 提示,说明配置完成:
大功告成。浏览器访问 ,但是这里最好用域名来访问(后面 5.2 有说明)。
在服务器上执行配对命令:
注意:
- 配对码默认 1 小时过期
- 每个渠道待处理请求默认上限 3 个
- 执行命令的时候如果过期,日志会提示:
这个需要重新在 Telegram 发送机器人 获取新配对码。
配对成功:
这里很多人都会纠结,我对比了很多家。只需要从两个角度来考虑:
Skills 推荐去 ClawHub 社区 下载,注册个账号,可以获取 API 密钥让小龙虾自己去安装。
推荐 Skills:
- find-skills
- Agent Browser DevTools
- MCP auto-updater
- Openclaw Command Center
- self-improving-agent
- MCP
💡 因为我用的是智谱的模型,所以可以用这几个专属的 MCP,应该比第三方 MCP 的效果要好。先装上再说,不好用到时候再换就行。
现象:
在 启动镜像之后,出现报错:
原因:
Docker 权限不够 — 容器用户(uid=1000)试图写入 root(或其他用户)拥有的目录。
解决方案:
修改完权限后可以直接执行以下命令重新完成初始化向导:
现象:
页面报错:
相关文档:
解决方案:
开启 HTTPS,需要到服务器上去创建一个反向代理站点。这里我直接使用 Caddy 来管理多个子域名,详细过程自行搜索。
最后可以使用域名来访问小龙虾。
原因:
控制 UI 第一次从”新浏览器/新设备”连到 Gateway 时,需要做一次性”设备配对批准”(即使同一台机器、同一个 Tailnet 也可能需要)。
如果上面的解决不了,参考以下四步排查:
Step 1 — 修复容器网络
CLI 容器无法访问 的网关,因为容器内部的 localhost 指向自己。在 中添加:
Step 2 — 设置 Gateway 绑定到局域网
内置向导默认使用回环地址,但浏览器请求是通过 Docker 的桥接网络(172.18.0.x)到达的。在 中:
Step 3 — 同步 Gateway Token
在 文件中生成一个令牌,但引导向导会将不同的令牌写入 。请确保 中的 与 文件中的 匹配。
Step 4 — 批准待匹配设备
设备卡在待处理状态,因为 CLI 无法连接到网关来批准它们:
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/227320.html