# OpenClaw Docker 应用使用教程

> 宝塔面板（BT Panel）OpenClaw Docker 应用的完整安装与使用教程，包含镜像拉取、容器启动参数、Clawdbot 机器人接入流程，以及容器日志、端口占用与升级失败等常见问题解决方案。

原文：[OpenClaw Docker 应用使用教程](https://docs.bt.cn/practical-tutorials/openclaw-docker-usage)

文档范围：宝塔面板及相关产品（当前文档）。生成时间：2026-09-22。

本教程介绍宝塔面板 OpenClaw Docker 应用的使用方法，以及常见问题的解决方案。

## 应用使用

### 应用状态

在应用状态页面可以控制 OpenClaw 容器的启动、停止、重启等操作，也可以恢复默认设置。

![应用状态管理](https://docs.bt.cn/img/practical-tutorials/openclaw-docker/image-20260205113731662.png)

### 访问信息

插件会自动生成带 Token 的访问 URL，直接复制访问地址即可使用。

![访问地址](https://docs.bt.cn/img/practical-tutorials/openclaw-docker/image-20260205105201516.png)

### 日志查看

可以实时查看 OpenClaw 容器的运行日志，便于排查问题。

![查看日志](https://docs.bt.cn/img/practical-tutorials/openclaw-docker/image-20260205113944578.png)

### 机器人配置

OpenClaw 支持接入 QQ 机器人、飞书机器人、企业微信机器人和钉钉机器人。机器人的 ID 和密钥需要在对应平台的开放平台获取。

**相关平台：**

- **QQ 开放平台：** <https://q.qq.com>
- **飞书开放平台：** <https://open.feishu.cn/?lang=zh-CN>
- **企业微信开放平台：** <https://work.weixin.qq.com/>
- **钉钉开放平台：** <https://open.dingtalk.com/>
  ![机器人配置](https://docs.bt.cn/img/practical-tutorials/openclaw-docker/image-20260205112923176.png)

### 安装配置

#### 修改端口和存储路径

可以在安装配置中修改访问控制台端口、WebSocket 端口以及数据目录的存储路径。

> **警告：注意**
>
> 修改配置后需要重建容器才能生效。

![端口配置](https://docs.bt.cn/img/practical-tutorials/openclaw-docker/image-20260205114924863.png)

#### 修改大模型配置

OpenClaw 默认使用宝塔 AI 助手赠送的模型。

> **说明**
>
> - 每个用户提供 20 次免费使用额度
> - 免费额度可能随时调整，具体以页面显示为准，如文档与面板页面不一致，以面板页面为准

如需使用其他大模型，可以在【访问信息页面】中修改 API 配置。

![大模型配置](https://docs.bt.cn/img/practical-tutorials/openclaw-docker/image-20260206030340541.png)

**配置说明：**

- **API 地址：** 大模型的 API 端点
- **API 密钥：** 您的 API Key
- **模型名称：** 使用的模型标识

> **提示**
>
> 大模型的 API 地址、密钥及模型信息请参考各大模型服务商的接口文档。如需购买宝塔 AI 助手额度，可联系客服。

> **警告：注意**
>
> 修改配置后需要重建应用才能生效。

## 常见问题解决

### 健康状态异常

如果访问时健康状态显示不正常，可以到宝塔面板重启容器即可解决。

![健康状态异常](https://docs.bt.cn/img/practical-tutorials/openclaw-docker/image-20260205105323884.png)

### 配置域名反向代理

如需为 OpenClaw 配置域名访问，可以使用宝塔面板的反向代理功能。

#### 操作步骤

**1. 进入容器管理**

点击左侧菜单【Docker】-【容器】。

![Docker 容器](https://docs.bt.cn/img/practical-tutorials/openclaw-docker/image-20260205105519284.png)

**2. 配置反向代理**

选择 OpenClaw 容器，点击【反向代理】，即可配置域名。

![配置反向代理](https://docs.bt.cn/img/practical-tutorials/openclaw-docker/image-20260205105608645.png)

### 更新镜像

如需更新 OpenClaw 到最新版本，可以通过容器编排功能进行更新。

#### 操作步骤

点击【Docker】-【容器编排】，找到 OpenClaw 的编排配置，执行更新操作。

![更新镜像](https://docs.bt.cn/img/practical-tutorials/openclaw-docker/image-20260205112740764.png)