用 Docker 部署 Openclaw,原来如此简单。

2026-05-06阅读 0热度 0
运维 docker 容器

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-gatewayopenclaw-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)却不知如何下手?我们根据最新的技术动态和实践经验,整理了一份涵盖从理论基础到实战应用的全流程学习路线图。按图索骥,拒绝焦虑。

因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。

因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。

因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。

因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。

因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。

因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。

因篇幅有限,仅展示部分资料,需要点击下方链接即可前往获取。

免责声明

本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。

相关阅读

更多
欢迎回来 登录或注册后,可保存提示词和历史记录
登录后可同步收藏、历史记录和常用模板
注册即表示同意服务条款与隐私政策