用 Docker 部署 Openclaw,原来如此简单。
Docker部署OpenClaw实战:从环境准备到应用维护
前置条件
先聊聊环境准备。选择Docker部署的核心优势之一,在于它能将运行环境与宿主机彻底隔离,用完即删,干净利落。这意味着你只需要一台内存稍大点的电脑就能跑起来。通常来说,部署OpenClaw,运行内存建议至少预留4GB。
第一步自然是安装Docker,或者它的轻量级替代工具。比如在macOS平台下,Orbstack就是个不错的选择,我们这次实操用的就是它。
一句话概括,Docker部署的最大好处就是环境隔离与清理便捷。
获取源代码
万事俱备,接下来把OpenClaw的代码拉取到本地。打开终端,执行以下命令:
git clone https://github.com/openclaw/openclaw.git
当然了,如果你配置过SSH密钥,用下面这个地址克隆起来会更顺手:
git clone git@github.com:openclaw/openclaw.git
Docker入口文件:docker-setup.sh
代码到手,部署的钥匙就在根目录的docker-setup.sh这个脚本里。
在运行之前,不妨先看一眼脚本顶部的shebang标识:
#!/usr/bin/env bash
它明确指定了需要bash环境来执行。如果你的系统里恰好没有(虽然大多数情况都有),Mac用户可以通过Homebrew快速安装一个:brew install bash。
开始运行docker-setup.sh
确认环境无误后,就可以直接运行这个脚本了,它会引导你完成初始配置。
宿主机的配置文件
脚本运行后,关键的配置文件会生成在宿主机的用户目录下:
cd ~/.openclaw
后续若需要调整任何配置,直接修改这个目录下的文件就是最直接的途径。
在运行中进入openclaw的交互界面
配置流程会引导你进入一个交互式界面,进行核心设置。
大模型选择
OpenClaw的一个亮点是支持了众多模型,其中不乏优秀的国产模型。
这里我们以选择GLM模型为例。你需要去智谱AI的后台创建一个API Token,并在此处填写。
飞书channel
如果你想将机器人接入飞书,就需要先创建一个飞书应用,获取对应的App ID和App Secret。
接着,在配置channel的环节选择“飞书”,并将上一步获取的凭据填入即可。
Skills安装
至于Skills(技能插件)的安装,则完全根据你的实际需求来,在交互界面中选择并配置对应的路径就好。
Dashboard就绪但无法访问?
配置完成后,界面可能会提示Dashboard已准备就绪。
但请注意,此时你很可能无法通过 http://localhost:18789/#token=your_token 这个地址直接访问。为什么呢?用 docker ps 命令查看一下就能发现,18789端口并没有被暴露出来。
根源在于,docker-compose.yaml 默认只启动了cli部分,而提供Web界面的 openclaw-gateway 服务需要手动启动。执行以下命令:
docker compose up -d openclaw-gateway
docker compose ps
现在,再去Orbstack(或Docker Desktop)的容器列表里看看:
没错,openclaw-gateway 容器已经跑起来了。
那么访问链接和Token在哪里?你可以在Docker容器的日志中找到。如果使用Orbstack,直接查看容器的Logs选项卡就行,里面会明确输出类似这样的访问信息:
│ http://127.0.0.1:18789/#token=YOUR_TOKEN
万一 Token 忘了,也别慌,用这个命令可以重新生成访问链接(不自动打开浏览器):
docker compose run --rm openclaw-cli dashboard --no-open
配对失败处理办法
如果按照上述步骤操作后仍然无法访问,这时候就该宿主机的配置文件 ~/.openclaw 出场了。
你需要检查并确保两点:
1. 在配置文件中正确设置了 gateway.auth.token。
2. 将 controlUi 的配置项添加到 gateway 部分,并启用它,同时为了本地开发方便,可以暂时允许非安全认证:
"controlUi": {
"enabled": true,
"allowInsecureAuth": true
},
重新连接和聊天测试
修改配置并重启服务后,再次尝试连接,通常就能成功了。别忘了,最后一步是测试一下聊天功能是否正常工作,这是检验部署成果的终极关卡。
基本维护
采用Docker部署后,日常维护的方式和直接使用CLI就有了一些区别。下面几个命令会成为你的好帮手:
# 查看网关日志
docker compose logs -f openclaw-gateway
# 查看当前compose配置
docker compose config
# 重启网关服务
docker compose restart openclaw-gateway
# 使用CLI添加频道(例如飞书)
docker compose run --rm openclaw-cli channels add
# 查看CLI所有可用命令
docker compose run --rm openclaw-cli -h
小结
总的来说,本文带你走了一遍用Docker部署OpenClaw的核心配置流程。不得不承认,在容器化环境里部署和运行OpenClaw,在效率和环境清洁度上确实优势明显。部署完成后,后期的维护工作则要求你对 openclaw-gateway 和 openclaw-cli 这两个核心组件在Docker环境下的使用方式有基本的了解。掌握了这些,你就能轻松驾驭这个强大的AI助手了。
顺带一提,除了Docker部署,社区里还有像Cloudflare Worker部署这样的热门方案,同样值得探索。
从OpenClaw火爆开始,我们已经见证了它从更名到各种部署方案的演进,无论是利用闲置算力打造私人Clawbot,还是借助Cloudflare的Moltworker方案,都体现了这个生态的活力。
参考
https://docs.openclaw.ai/install/docker
https://docs.openclaw.ai/zh-CN/install/docker
https://til.simonwillison.net/llms/openclaw-docker
想从零开始系统学习大模型(LLM)却不知如何下手?我们根据最新的技术动态和实践经验,整理了一份涵盖从理论基础到实战应用的全流程学习路线图。按图索骥,拒绝焦虑。
因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。
因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。
因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。
因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。
因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。
因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。
因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。


























