如何在 Docker 中部署 OpenClaw 私人助理

作者：nunumick 发布时间：31 Jan 2026 分类： AI

说明：这是一篇完全在糯米纸壳的指导下由 OpenClaw 助理代写和代发的文章。

本文将指导你如何通过 Docker 快速部署 OpenClaw，并配置 Telegram 通道以实现私人助理功能。

前置条件

在开始之前，请确保你的系统满足以下要求：

已安装 Docker 和 Docker Compose v2。
确保有足够的磁盘空间用于镜像和日志存储。

快速开始

运行以下命令即可完成 OpenClaw 的 Docker 部署：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh

详细步骤

步骤 1：克隆 OpenClaw 仓库

运行以下命令克隆 OpenClaw 仓库：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

步骤 2：运行 Docker Setup 脚本

OpenClaw 提供了一个便捷的脚本 docker-setup.sh，用于快速完成 Docker 配置和启动。你可以根据需求修改 docker-setup.sh 和 Dockerfile 模板。

运行以下命令：

./docker-setup.sh

该脚本会自动完成以下操作：

构建 Gateway 镜像。
运行初始化向导。
启动 Gateway 容器。
生成一个 Gateway Token 并保存到 .env 文件中。

步骤 3：配置 Telegram 通道

要启用 Telegram 通道，你需要提供一个 Bot Token 并完成配对配置。

获取 Telegram Bot Token

打开 Telegram，搜索 @BotFather。
使用 /newbot 命令创建一个新的 Bot，并获取其 Token。

添加 Telegram 配置

运行以下命令，将 <your-bot-token> 替换为你从 BotFather 获取的 Token：

docker compose run --rm openclaw-cli channels add --channel telegram --token "<your-bot-token>"

完成配对

在 Telegram 中搜索你的 Bot 名称并发送消息 /pair。
根据提示完成配对流程。

步骤 4：访问控制界面

启动完成后，打开浏览器访问以下 URL：

http://127.0.0.1:18789/

将生成的 Gateway Token 填入控制界面（Settings → Token）以完成配置。

步骤 5：验证 Telegram 功能

在 Telegram 中搜索你的 Bot 名称并发送消息 /status。
如果 Bot 正常响应，说明配置成功！

常见问题

端口冲突：
- 如果 18789 端口已被占用，可以在 docker-compose.yml 中修改端口映射。例如：
```
ports:
     - "9090:18789"
```

健康检查：

可以通过以下命令检查 Gateway 的健康状态：

docker compose exec openclaw-gateway node dist/index.mjs health --token "$OPENCLAW_GATEWAY_TOKEN"

日志查看：
- 如果遇到问题，可以通过以下命令查看日志：
```
docker logs openclaw-gateway
```

默尘