# openclaw+clash

**Repository Path**: WayneFlash/openclaw-clash

## Basic Information

- **Project Name**: openclaw+clash
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-05
- **Last Updated**: 2026-04-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClaw + mihomo Docker 部署

> 一键部署 OpenClaw 对接 Telegram + 硅基流动 AI

## ⚠️ 重要：代理影响范围

**代理环境变量只影响 OpenClaw 容器内的进程，不会影响宿主机和其他容器！**

- OpenClaw 容器内：`HTTPS_PROXY=http://mihomo:7890`
- 宿主机：无代理环境变量
- 其他容器：无代理环境变量

这样确保部署后不影响服务器上的其他软件。

## 前置条件

部署前需要确保服务器已安装 Docker：

```bash
# 检查 Docker 是否安装
docker --version
docker-compose --version

# 如果未安装，请先安装 Docker
# Ubuntu: https://docs.docker.com/engine/install/ubuntu/
```

**注意**：**不需要在服务器上安装 Node.js**，因为容器内已经包含了 Node.js 22 环境。

## 部署流程（4步）

### 第1步：克隆项目
```bash
git clone https://gitee.com/WayneFlash/openclaw-clash.git
cd openclaw-clash
```

### 第2步：配置环境变量
```bash
# 复制环境变量模板
cp .env.example .env

# 编辑 .env，填入配置
nano .env
```

**.env 文件内容**：
```bash
# Telegram Bot Token（必填）
TELEGRAM_BOT_TOKEN=你的机器人Token

# 硅基流动 API Key（必填）
SILICONFLOW_API_KEY=你的APIKey

# 代理配置（必填，完整 YAML）
# 从机场获取订阅，用 https://sub.v1.mk 转 Clash 格式
CLASH_CONFIG=|完整的clash配置|
```

### 第3步：执行部署
```bash
chmod +x deploy.sh
./deploy.sh
```

**部署过程**：
1. 生成 openclaw.json 配置文件
2. 生成 clash.yaml 代理配置
3. 构建 mihomo 镜像
4. 构建 OpenClaw 镜像
5. 启动 mihomo 容器
6. 等待 mihomo 健康检查通过
7. 启动 OpenClaw 容器

### 第4步：首次配对

部署完成后，系统会自动通过 Telegram 推送配对请求通知给你：

```bash
# 步骤1：等待 Telegram 推送配对请求通知
# （Telegram 官方会推送，不是机器人发的）

# 步骤2：在通知中获取配对码，复制下来

# 步骤3：在服务器上执行批准（输入配对码）
# 命令格式：openclaw pairing approve --channel telegram 配对码
docker exec openclaw-gateway openclaw pairing approve --channel telegram 你复制的配对码
```

**配对成功后，就可以正常聊天了！**

### 验证
```bash
# 检查容器状态
docker-compose ps

# 检查 Telegram 连接
docker exec openclaw-gateway openclaw channels status --probe
```

## 项目结构

```
.
├── deploy.sh                   # 一键部署脚本
├── .env.example                # 环境变量模板
├── docker-compose.yml          # 容器编排
├── mihomo/
│   └── Dockerfile             # mihomo 代理容器
├── openclaw/
│   └── Dockerfile             # OpenClaw 容器
├── config/
│   ├── openclaw.example.json  # OpenClaw 配置模板
│   └── clash.example.yaml     # mihomo 配置模板
└── README.md
```

## 配置说明

### .env 环境变量

| 变量 | 说明 | 示例 |
|------|------|------|
| `TELEGRAM_BOT_TOKEN` | Telegram机器人Token | `123456789:ABCdefGHIjklMNOpqrsTUVwxyz` |
| `SILICONFLOW_API_KEY` | 硅基流动API Key | `sk-xxxxxxxxxxxxxxxx` |
| `CLASH_CONFIG` | 代理节点配置（完整YAML） | 从机场订阅转换的clash配置 |

**获取方式**：
- Telegram Bot Token：Telegram 搜索 `@BotFather`，创建机器人获取
- 硅基流动 API Key：https://cloud.siliconflow.cn → API密钥
- 代理配置：从机场获取订阅链接，用 https://sub.v1.mk 转换为 Clash 格式

## 常用命令

```bash
# 启动
docker-compose up -d

# 停止
docker-compose down

# 查看日志
docker-compose logs -f mihomo
docker-compose logs -f openclaw

# 重启
docker-compose restart

# 进入容器
docker exec -it openclaw-gateway /bin/sh
```

## 环境变量

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `HTTPS_PROXY` | 代理地址 | http://mihomo:7890 |
| `OPENCLAW_PORT` | Gateway 端口 | 18789 |

## 注意事项

- OpenClaw 容器的代理环境变量已配置为指向 mihomo 容器
- 其他服务不受影响，不会走代理
- 数据持久化：配置挂载到 config 目录
- **自动重启**：容器配置了 `restart: always`，服务器重启后会自动启动

## 自动重启说明

配置了 `restart: always`，以下情况会自动重启：

- 服务器重启/关机后恢复
- 容器意外退出
- Docker 服务重启

```bash
# 验证自动重启已启用
docker inspect openclaw-mihomo | grep RestartPolicy
docker inspect openclaw-gateway | grep RestartPolicy
```

## 问题排查

```bash
# 检查容器状态
docker-compose ps

# 检查日志
docker-compose logs

# 检查 Telegram 连接
docker exec openclaw-openclaw-1 openclaw channels status --probe

# 重置 OpenClaw
docker-compose restart openclaw
```