dhso/openclaw

openclaw-docker

镜像概述和主要用途

openclaw-docker是一个个人AI助手Docker镜像，支持在任何操作系统和平台上部署。通过简单配置，用户可快速搭建个性化AI助手，实现模型选择、API密钥配置及聊天通道设置等功能。

核心功能和特性

• 跨平台兼容性：支持任何操作系统和平台部署
• 交互式配置：通过向导完成AI模型选择、API密钥配置及聊天通道设置
• 灵活网关模式：支持本地网关配置，包括绑定地址、可信代理及认证令牌设置
• 数据持久化：通过卷挂载保存配置数据，确保服务重启后配置不丢失
• 后台运行支持：支持守护进程模式，确保服务持续稳定运行

使用场景和适用范围

适用于需要个人AI助手的用户，可部署在个人电脑、服务器等环境，满足日常对话、信息查询、任务辅助等个性化AI需求。

使用方法和配置说明

1. 初始化（首次运行）

首次运行需通过交互式命令完成基础配置：

bash
docker run --rm -it \
  -e TZ=Asia/Shanghai \
  -v openclaw_data:/root/.openclaw \
  dhso/openclaw:latest \
  openclaw onboard

按向导完成以下步骤：

• 选择AI模型
• 配置API密钥
• 设置聊天通道

2. 配置网关模式

执行以下命令配置网关参数：

bash
# 设置网关模式为本地
docker run --rm \
  -e TZ=Asia/Shanghai \
  -v openclaw_data:/root/.openclaw \
  dhso/openclaw:latest \
  openclaw config set gateway.mode local

# 设置网关绑定地址为局域网
docker run --rm \
  -e TZ=Asia/Shanghai \
  -v openclaw_data:/root/.openclaw \
  dhso/openclaw:latest \
  openclaw config set gateway.bind lan

# 配置可信代理
docker run --rm \
  -e TZ=Asia/Shanghai \
  -v openclaw_data:/root/.openclaw \
  dhso/openclaw:latest \
  openclaw config set gateway.trustedProxies '["127.0.0.1", "::1", "10.0.0.0/8"]'

# 设置认证令牌（替换your_token为实际令牌）
docker run --rm \
  -e TZ=Asia/Shanghai \
  -v openclaw_data:/root/.openclaw \
  dhso/openclaw:latest \
  openclaw config set gateway.auth.token your_token

# 2026.2.17以上版本需配置Host头来源回退（避免启动失败）
docker run --rm \
  -e TZ=Asia/Shanghai \
  -v openclaw_data:/root/.openclaw \
  -v openclaw_cache:/root/.cache \
  dhso/openclaw:latest \
  openclaw config set gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback true

# 检查并修复配置问题
docker run --rm \
  -e TZ=Asia/Shanghai \
  -v openclaw_data:/root/.openclaw \
  dhso/openclaw:latest \
  openclaw doctor --fix

3. 启动服务（守护进程模式）

以后台模式启动容器，确保服务持续运行：

bash
docker run -d \
  --name claw \
  -e TZ=Asia/Shanghai \
  -v openclaw_data:/root/.openclaw \
  -p 18789:18789 \
  --restart=unless-stopped \
  dhso/openclaw:latest \
  openclaw gateway run

4. 访问服务

启动后通过以下地址访问AI助手界面：
[***]

详细说明

更多详细信息请参考项目GitHub仓库：
https://github.com/dhso/openclaw-docker