你好,我是郭震。
近期收到大量读者反馈:在国内本地安装龙虾(OpenClaw)失败,只能依赖云端版本,但无法访问本地文件。
经反复测试与环境还原,我梳理出一套适配国内网络环境、成功率近100%的本地部署方案。该方案支持 Windows、macOS 和 Linux 全平台,操作简洁、容错性强。
1 龙虾本地安装常见问题
国内用户本地部署常因依赖环境异常而失败,典型问题包括:
- Node.js 依赖安装报错;
- 构建过程依赖 GitHub 资源,频繁超时。
为彻底解决上述问题,我制作了 OpenClaw 官方 Docker 镜像,开箱即用,无需手动配置复杂运行环境。
2 Docker 通俗解析
Docker 的核心价值在于解决“在我电脑上能跑,到你电脑就报错”的经典兼容性难题。
可类比为“搬家”:
- 传统方式:提供一份“装修图纸”(安装教程),需用户自行采购材料、布线施工——环境差异极易导致失败;
- Docker 方式:交付一个封装完整的“样板间集装箱”,含代码、运行环境、配置及预设参数,用户仅需“拆箱即用”。
因此,Docker 是新手部署 OpenClaw 最可靠、最高效的方式。
3 Docker 部署龙虾完整步骤
以下流程已全平台实测验证,确保可复现。
注意事项:所有命令请手动输入终端(PowerShell / Terminal),避免直接复制公众号文本——易混入不可见字符导致执行失败。
第一步:启动 Docker
确认 Docker Desktop 已安装并运行。
第二步:拉取镜像
docker pull sgccr.ccs.tencentyun.com/openclaw/openclaw:latest
第三步:清理旧容器与数据卷,创建新实例
docker rm -f openclaw
docker volume rm openclaw-data
docker volume create openclaw-data
docker run --name openclaw -p 18789:18789 -v openclaw-data:/data sgccr.ccs.tencentyun.com/openclaw/openclaw:latest openclaw gateway run --port 18789 --bind lan --allow-unconfigured
第四步:启动 Dashboard 并获取访问地址
docker exec -it openclaw openclaw dashboard
第五步:设备配对
docker exec -it openclaw sh -lc "openclaw devices list --json"
paired 列表中,找到对应设备的 deviceId(一长串字符串):
docker exec -it openclaw openclaw devices approve <requestId>
成功后显示如下提示:
网页端同步显示 “OK”,配对完成。
4 龙虾智能体功能概览
完成部署后,配置 API 即可开始对话交互:
龙虾智能体具备以下核心能力:
- 内置身份记忆机制;
- 预置 51 个实用 Skills,支持按需扩展;
- 模块化架构设计,便于二次开发与集成。
本教程为全链路实测验证版,兼顾易用性与稳定性,适用于零基础用户快速落地 OpenClaw 本地部署。

