OpenClaw Mobile

中文文档 | English

OpenClaw Mobile

🚨 安全警告：绝对不要设置 BIND_HOST = '0.0.0.0'

服务启动时会检测并拒绝此配置！

BIND_HOST 安全性说明

127.0.0.1 ✅ 最安全 仅本机可访问（默认值）

Tailscale IP ✅ 安全仅 VPN 网络可访问

192.168.x.x ⚠️ 中等仅局域网可访问

0.0.0.0 ❌ 禁止服务会拒绝启动！

如果设置了 BIND_HOST = '0.0.0.0'，服务将拒绝启动并提示修改配置。

如需远程访问，请使用 Tailscale 等 VPN 方案：
# 1. 安装 Tailscale
curl -fsSL https://tailscale.com/install.sh | sh

# 2. 获取 Tailscale IP
tailscale ip

# 3. 重新运行 setup.py 配置
python3 setup.py

一个现代化的 OpenClaw Gateway 移动端 Web 界面，支持实时聊天、工具调用显示、思考过程展示等功能。

✨ 功能特性

🎨 现代化 UI - 深色主题，iOS 风格设计
🌐 多语言支持 - 内置中文/英文，一键切换
💬 实时聊天 - WebSocket 连接，流式输出
🧠 思考过程 - 显示 AI 推理过程
🔧 工具调用 - 显示工具执行状态
📱 移动优化 - 触摸友好，流畅体验
🔄 自动重连 - 网络断开自动重连
🔐 安全认证 - Session Token 认证，24小时有效期
💾 登录持久化 - 本地存储登录状态
📖 文件浏览 - 内置文件浏览器（需认证）
🔄 模型切换 - 实时切换 AI 模型，状态持久化
⚡ 快捷工具 - 可展开的快捷操作面板
🔐 多环境支持 - 支持 Tailscale、云端口转发
⚙️ 可自定义 - 助手名称、界面配置
🔊 语音朗读 - TTS 语音播放 AI 回复
📎 文件发送 - 支持发送图片和文件

📸 界面预览

登录页面	侧边菜单

文件浏览器	多图片发送

思考过程

功能说明

截图	功能
登录页面	Token 认证、Session 管理、会话配置
侧边菜单	文件浏览、Dashboard、历史管理
文件浏览器	缩略图预览、排序、点击放大（需认证）
多图片发送	最多 9 张图片、工具调用状态
思考过程	AI 思考状态、执行进度
模型切换	实时切换 AI 模型，下拉选择器
快捷工具	可展开的快捷操作面板

🚀 快速开始

方式一：一键配置（推荐）

# 克隆项目
git clone https://github.com/yujuntea/openclaw-mobile.git
cd openclaw-mobile

# 运行配置工具
python3 setup.py

# 按照提示完成配置即可

配置工具会自动：

✅ 检测 Tailscale IP 和主机名
✅ 获取 Gateway Token
✅ 生成配置文件
✅ 配置 systemd 服务
✅ 更新 Gateway allowedOrigins

📖 一键配置使用向导

配置流程

┌─────────────────────────────────────────────────────────────┐
│                    一键配置工具流程                          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Step 1: 自动检测环境                                      │
│  ├─ Tailscale IP (如 100.x.x.x)                     │
│  ├─ Tailscale 主机名 (如 your-hostname)                        │
│  └─ Gateway Token                                         │
│                                                             │
│  Step 2: AI 助手名称配置                                  │
│  ├─ 助手名称（中文/英文）                                 │
│  └─ 助手描述（中文/英文）                                 │
│                                                             │
│  Step 3: Tailscale 配置（可选）                           │
│  └─ 如不需要，直接回车跳过                                │
│                                                             │
│  Step 3: 访问域名配置                                     │
│  └─ 用于显示访问地址                                      │
│                                                             │
│  Step 4: 云端口转发配置（可选）                            │
│  ├─ HTTP 访问域名                                         │
│  └─ WSS WebSocket 地址                                    │
│                                                             │
│  Step 5: Gateway Token                                    │
│  └─ 自动检测，如不正确可修改                              │
│                                                             │
│  Step 6: Dashboard 目录                                   │
│  └─ 自动检测，默认值即可                                   │
│                                                             │
└─────────────────────────────────────────────────────────────┘

3 种访问方式组合

方式	场景	配置说明
方式1	仅 Tailscale	输入 Tailscale IP 和主机名，云转发直接回车跳过
方式2	仅云转发	Tailscale 直接回车跳过，输入云转发域名和WSS地址
方式3	自定义域名	Tailscale 和云转发都跳过，输入自定义域名
组合	全部开启	输入所有信息，同时支持 Tailscale + 云转发 + 自定义域名

配置决策表

┌──────────────────────────────────────────────────────────────┐
│                    BIND_HOST 决策逻辑                        │
├──────────────────────────────────────────────────────────────┤
│                                                              │
│  有 Tailscale IP？                                          │
│       │                                                     │
│       ├── 是 → BIND_HOST = Tailscale IP                    │
│       │         (仅 Tailscale 网络可访问，安全)              │
│       │                                                     │
│       └── 否 → BIND_HOST = 127.0.0.1                       │
│                 (仅本机可访问，最安全)                       │
│                                                              │
│  ⚠️ 注意：不会自动设置为 0.0.0.0                            │
│     如需远程访问，请使用 Tailscale 或手动配置               │
│                                                              │
└──────────────────────────────────────────────────────────────┘

使用示例

示例1: 仅使用 Tailscale 访问

📋 Tailscale 配置
  检测到 Tailscale IP: 100.x.x.x
  Tailscale IP [100.x.x.x]: (直接回车使用检测值)
  Tailscale 主机名 [your-hostname]: (直接回车使用检测值)

📋 访问域名配置
  访问域名（用于显示） [your-hostname.tailXXXX.ts.net]: (直接回车使用默认值)

📋 云端口转发配置（可选）
  云转发 HTTP 访问域名：(直接回车跳过)
  云转发 WSS 地址: (直接回车跳过)

📋 Gateway 配置
  Gateway Token [自动检测到]: (直接回车使用)

示例2: 仅使用云端口转发

📋 Tailscale 配置
  Tailscale IP [直接回车跳过]: (直接回车跳过)
  Tailscale 主机名 [直接回车跳过]: (直接回车跳过)

📋 访问域名配置
  访问域名（用于显示） [直接回车跳过]: (直接回车跳过)

📋 云端口转发配置
  云转发 HTTP 访问域名: demo.orcaterm.cloud.tencent.com
  云转发 WSS 地址: wss://wss-demo.orcaterm.cloud.tencent.com/

示例 3: 同时使用 Tailscale + 云转发

📋 Tailscale 配置
  检测到 Tailscale IP: 100.x.x.x
  检测到主机名：your-hostname
  
  Tailscale IP [100.x.x.x]: (直接回车使用检测值)
  Tailscale 主机名 [your-hostname]: (直接回车使用检测值)

📋 访问域名配置
  访问域名（用于显示） [your-hostname.tailXXXX.ts.net]: (直接回车使用默认值)

📋 云转发配置
  云转发 HTTP 访问域名：demo.orcaterm.cloud.tencent.com
  云转发 WSS 地址：wss://wss-demo.orcaterm.cloud.tencent.com/

📋 Gateway 配置
  Gateway Token [自动检测到]: (直接回车使用)

访问地址自动添加

配置工具会自动将以下地址添加到 Gateway 的 allowedOrigins：

访问方式	地址示例
本地	http://localhost:8080
Tailscale IP	http://100.x.x.x:8080
Tailscale 域名	http://your-hostname.tailXXXX.ts.net:8080
云转发域名	http://demo.orcaterm.cloud.tencent.com

配置文件说明

文件	说明	位置	说明
`config.js`	前端配置（Gateway Token、WebSocket 地址等）	`~/.openclaw/workspace/config.js`	用户配置文件
`server_config.py`	后端配置（端口、监听地址等）	`~/.openclaw/workspace/server_config.py`	用户配置文件
`config.example.js`	前端配置模板	工程目录	参考模板
`server_config.example.py`	后端配置模板	工程目录	参考模板

📝 配置与代码分离的设计：

配置文件放在 ~/.openclaw/workspace/ 目录下

工程代码在 openclaw-mobile-release/ 目录

这样更新工程代码时不会覆盖用户配置

常见问题

Q: 配置文件在哪里？

A: 配置文件统一在 ~/.openclaw/workspace/ 目录下：

config.js - 前端配置

server_config.py - 后端配置

工程目录 (openclaw-mobile-release/) 只包含代码，配置文件独立管理。

Q: 配置会备份吗？

A: 是的！运行 setup.py 会自动备份现有配置文件到：

备份位置：~/.openclaw/workspace/config-backup/

文件：config.js.日期时间、server_config.py.日期时间、openclaw.json.日期时间

Q: 想修改配置怎么办？

A: 直接编辑配置文件：

vim ~/.openclaw/workspace/config.js      # 前端配置
vim ~/.openclaw/workspace/server_config.py  # 后端配置

# 修改后重启服务
systemctl --user restart openclaw-mobile

Q: BIND_HOST 绑定 Tailscale IP 有什么好处？

A: 更安全！只有 Tailscale 网络内的设备才能访问服务

方式二：手动配置

1. 复制配置模板

# 复制前端配置模板
cp openclaw-mobile-release/config.example.js ~/.openclaw/workspace/config.js

# 复制后端配置模板
cp openclaw-mobile-release/server_config.example.py ~/.openclaw/workspace/server_config.py

2. 编辑配置

# 编辑前端配置（Gateway Token、WebSocket 地址等）
vim ~/.openclaw/workspace/config.js

# 编辑后端配置（端口、监听地址等）
vim ~/.openclaw/workspace/server_config.py

3. 前端配置 (config.js)

const OPENCLAW_CONFIG = {
  // 应用自定义
  app: {
    appName: '小鱼 AI',           // 中文名称
    appNameEn: 'XiaoYu AI',   // 英文名称
    appDesc: 'AI 工作助手',
    appDescEn: 'AI Family Assistant',
  },
  
  gateway: {
    // 你的 Gateway WebSocket 地址
    defaultWsUrl: 'ws://your-gateway:18789/',
    
    // 你的 Gateway Token
    // 获取方法: cat ~/.openclaw/openclaw.json | jq -r '.gateway.auth.token'
    defaultToken: 'YOUR_GATEWAY_TOKEN_HERE',
  },
  
  // 如果使用云端口转发，配置域名映射
  cloudForward: {
    mapping: {
      'your-http-domain.example.com': 'your-wss-domain.example.com',
    }
  }
};

3. 后端配置 (server_config.py)

# 监听地址 - 请谨慎配置！
#
# ⚠️ 安全警告：
# - 127.0.0.1: 仅本机可访问（最安全，默认）
# - Tailscale IP: 仅 VPN 网络可访问（安全）
# - 0.0.0.0: 所有网络可访问（危险！暴露到公网）
#
# 除非你明确知道自己在做什么，否则不要设置为 0.0.0.0！
#
BIND_HOST = '127.0.0.1'  # 默认仅本机访问

# 域名（用于显示访问地址）
TAILSCALE_DOMAIN = 'your-gateway-host.example.com'

# Gateway HTTP 地址
GATEWAY_HTTP = 'http://127.0.0.1:18789'

# Dashboard 目录
DASHBOARD_DIR = '/path/to/openclaw/dist/control-ui'

4. 配置 Gateway

3. 启动服务

# 启动服务
python3 server.py

4. 配置 Gateway

在 openclaw.json 中添加访问域名：

{
  "gateway": {
    "controlUi": {
      "allowedOrigins": [
        "http://localhost:8080",
        "http://your-domain:8080"
      ]
    }
  }
}

5. 启动服务

前台启动（调试用）

# 直接运行（配置文件在 workspace 目录）
cd ~/.openclaw/workspace/openclaw-mobile-release
python3 server.py

后台启动（生产环境）

方式 1：nohup

cd ~/.openclaw/workspace/openclaw-mobile-release
nohup python3 server.py > ~/.openclaw/workspace/server.log 2>&1 &

# 查看日志
tail -f ~/.openclaw/workspace/server.log

# 停止服务
pkill -f "openclaw-mobile-release/server.py"

方式 2：Systemd 服务（推荐）

# 创建服务文件
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/openclaw-mobile.service << 'EOF'
[Unit]
Description=OpenClaw Mobile Web Server
After=network.target

[Service]
Type=simple
WorkingDirectory=/root/.openclaw/workspace/openclaw-mobile-release
ExecStart=/usr/bin/python3 /root/.openclaw/workspace/openclaw-mobile-release/server.py
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target
EOF

# 启用并启动服务
systemctl --user daemon-reload
systemctl --user enable openclaw-mobile
systemctl --user start openclaw-mobile

Systemd 服务管理命令：

命令	说明
`systemctl --user start openclaw-mobile`	启动服务
`systemctl --user stop openclaw-mobile`	停止服务
`systemctl --user restart openclaw-mobile`	重启服务
`systemctl --user status openclaw-mobile`	查看状态
`journalctl --user -u openclaw-mobile -f`	查看实时日志
`journalctl --user -u openclaw-mobile -n 50`	查看最近 50 条日志
systemctl --user stop openclaw-web

重启服务

systemctl --user restart openclaw-web


### 6. 访问界面

打开浏览器访问：
- 本地: `http://localhost:8080/`
- 内网: `http://<your-ip>:8080/`
- 完整: `http://your-domain:8080/`

> 💡 访问根路径 `/` 会自动跳转到 mobile 页面

## ⚙️ 配置

### 配置文件说明

| 文件 | 用途 | 位置 |
|------|------|------|
| `config.js` | 前端配置（Gateway Token 等） | `~/.openclaw/workspace/` |
| `server_config.py` | 后端配置（端口、地址等） | `~/.openclaw/workspace/` |
| `config.example.js` | 前端配置模板 | 工程目录 |
| `server_config.example.py` | 后端配置模板 | 工程目录 |
| `i18n.js` | 国际化配置 | 工程目录 |

> **注意**：配置文件（`config.js` 和 `server_config.py`）位于 `~/.openclaw/workspace/` 目录下，不会随工程代码更新而丢失。

## 🌐 多语言支持

OpenClaw Mobile 支持多语言，可轻松切换。

### 支持的语言

| 语言 | 代码 | 状态 |
|------|------|------|
| 中文 | `zh-CN` | ✅ 内置 |
| English | `en-US` | ✅ 内置 |

### 切换语言

- 点击顶部的语言按钮（显示 "EN" 或 "中"）
- 语言偏好保存到 localStorage
- 界面即时更新，无需刷新

### 自定义助手名称

可以在 `config.js` 中自定义不同语言的助手名称：

```javascript
const OPENCLAW_CONFIG = {
  app: {
    appName: '我的助手',         // 中文名称
    appNameEn: 'My Assistant', // 英文名称
  }
};

添加新语言

要添加新语言，编辑 i18n.js：

languages: {
  'zh-CN': { ... },
  'en-US': { ... },
  'ja-JP': {  // 日语
    appName: 'AIアシスタント',
    appDesc: 'AIアシスタント',
    // ... 添加其他翻译
  }
}

WebSocket 地址自动检测

mobile.html 通过 getWebSocketUrl() 函数自动检测访问环境并选择正确的 WebSocket 地址：

function getWebSocketUrl() {
  const currentHost = window.location.hostname;
  
  // 1. 云端口转发检测（腾讯云等）
  if (cloudForward.enabled && currentHost.includes(cloudForward.domainPattern)) {
    // 优先使用配置的 wsUrl
    if (cloudForward.wsUrl) return cloudForward.wsUrl;
    // 没有配置则使用 wss://当前域名/
    return `wss://${currentHost}/`;
  }
  
  // 2. Tailscale 检测
  if (tailscale.enabled && currentHost.includes(tailscale.domainPattern)) {
    return `ws://${currentHost}:18789/`;
  }
  
  // 3. 默认
  return gateway.defaultWsUrl;
}

配置示例

// config.js
const OPENCLAW_CONFIG = {
  gateway: {
    defaultWsUrl: 'ws://your-hostname.tailXXXX.ts.net:18789/',
    // ...
  },
  cloudForward: {
    enabled: true,
    domainPattern: '.orcaterm.cloud.tencent.com',
    wsUrl: 'wss://forward-wss-xxx.orcaterm.cloud.tencent.com/'
  },
  tailscale: {
    enabled: true,
    domainPattern: '.tailXXXX.ts.net',
    wsPort: 18789
  }
};

判断逻辑流程

访问域名检测
    │
    ├─ 包含云端口转发域名（如 .orcaterm.cloud.tencent.com）？
    │       │
    │       ├─ cloudForward.wsUrl 已配置？
    │       │       └─ YES → 使用 cloudForward.wsUrl
    │       │                例：wss://forward-wss-xxx.orcaterm.cloud.tencent.com/
    │       │
    │       └─ NO → 使用 wss://当前域名/
    │
    ├─ 包含 Tailscale 域名（如 .tailXXXX.ts.net）？
    │       └─ YES → 使用 ws://当前域名:18789/
    │
    └─ 其他环境
            └─ 使用 gateway.defaultWsUrl

不同环境的配置方式

访问方式	HTTP 地址	WebSocket 地址	配置项
Tailscale	`http://host.tailXXX.ts.net:8080`	`ws://host.tailXXX.ts.net:18789/`	`tailscale.wsPort`
腾讯云转发	`https://forward-xxx.orcaterm...`	`wss://forward-wss-...`	`cloudForward.wsUrl`
本地开发	`http://localhost:8080`	`ws://localhost:18789/`	`gateway.defaultWsUrl`

Tailscale 配置

如果使用 Tailscale 进行内网穿透，需要配置以下内容：

1. 前端配置 (config.js)

tailscale: {
  enabled: true,
  domainPattern: '.tailXXXX.ts.net',  // 你的 Tailscale 域名后缀
  wsPort: 18789  // Gateway WebSocket 端口
}

2. 后端配置 (server_config.py)

# 绑定到 Tailscale IP（推荐）
BIND_HOST = '100.x.x.x'  # 你的 Tailscale IP

# 或者仅本机访问（最安全，默认）
# BIND_HOST = '127.0.0.1'

# ⚠️ 不要设置为 0.0.0.0，会暴露到公网！

TAILSCALE_DOMAIN = 'your-hostname.tailXXXX.ts.net'

3. Gateway 配置 (openclaw.json)

{
  "gateway": {
    "controlUi": {
      "allowedOrigins": [
        "http://your-hostname.tailXXXX.ts.net:8080",
        "http://your-hostname.tailXXXX.ts.net"
      ]
    }
  }
}

4. 获取 Tailscale 信息

# 查看 Tailscale IP
tailscale ip

# 查看 Tailscale 域名
tailscale status

Gateway allowedOrigins

在 openclaw.json 中添加所有访问域名：

{
  "gateway": {
    "controlUi": {
      "allowedOrigins": [
        "http://localhost:8080",
        "http://localhost:18789",
        "http://your-hostname.tailXXXX.ts.net:8080",
        "http://your-hostname.tailXXXX.ts.net",
        "https://your-https-domain.example.com"
      ]
    }
  }
}

📖 文档

🏗️ 技术架构

整体架构

┌──────────────┐     WebSocket      ┌──────────────────┐
│  mobile.html │ ◄─────────────────► │  OpenClaw Gateway │
│  (前端)      │                     │  (WebSocket 服务) │
└──────┬───────┘                     └──────────────────┘
       │
       │ HTTP (图片上传)
       ▼
┌──────────────┐     HTTP 代理      ┌──────────────────┐
│  server.py   │ ──────────────────► │  OpenClaw Gateway │
│  (后端)      │                     │  (HTTP API)       │
└──────────────┘                     └──────────────────┘

核心功能

功能	实现方式	说明
实时通信	WebSocket	与 Gateway 双向通信
流式输出	Event 流	打字机效果，实时显示
思考过程	自定义渲染	紫色背景 + 左边框
工具调用	状态渲染	橙色(运行)、绿色(完成)、红色(失败)
图片上传	HTTP POST → Gateway	支持压缩、base64
自动重连	setTimeout(3s)	断线自动重连
登录持久化	LocalStorage	1小时免登录
域名检测	JS 自动判断	支持 Tailscale、云端口转发

技术栈

层级	技术
前端	原生 JavaScript + WebSocket API + CSS3
后端	Python http.server + urllib
通信	WebSocket (实时) + HTTP (文件)
存储	LocalStorage (登录状态)

核心模块

模块	职责
`GwClient`	WebSocket 客户端，管理连接、认证、消息
`handleMessage`	消息处理器，处理 res/event 消息
`renderMessage`	消息渲染，支持文本、思考、工具调用
`renderThinking`	思考过程渲染，流式显示
`renderToolCall`	工具调用渲染，状态动画
`uploadImage`	图片上传，压缩 + base64 编码

与 Gateway 的交互

WebSocket API：

方法	说明
`connect`	认证连接
`chat.send`	发送消息
`chat.history`	获取历史
`chat.abort`	中止生成

认证流程：

WebSocket 连接 → connect.challenge → 发送 token → hello-ok → 认证成功

消息格式：

{
  type: 'event',
  event: 'chat.message',
  payload: {
    content: [
      { type: 'text', text: '...' },
      { type: 'thinking', thinking: '...' },
      { type: 'tool_call', name: '...', input: {...} }
    ]
  }
}

详细架构文档请参阅技术架构。

🔒 安全注意事项

敏感文件保护

项目严格隔离敏感配置，确保不会泄露到 Git：

文件	内容	Git 状态
`config.js`	Gateway Token、WebSocket 地址	✅ 被 .gitignore 忽略
`server_config.py`	绑定地址、Gateway HTTP 地址	✅ 被 .gitignore 忽略
`.env`	API Key 等环境变量	✅ 被 .gitignore 忽略
`*.local`	本地覆盖配置	✅ 被 .gitignore 忽略

模板文件（可提交）：

config.example.js - 前端配置模板（不含敏感信息）
server_config.example.py - 后端配置模板（不含敏感信息）

🚨 BIND_HOST 配置（服务会强制检查！）

服务启动时会检测 BIND_HOST 配置，如果设置为 0.0.0.0 将拒绝启动！

╔════════════════════════════════════════════════════════════════╗
║                    ⛔ 安全错误：BIND_HOST = '0.0.0.0'           ║
╚════════════════════════════════════════════════════════════════╝

🚨 拒绝启动！BIND_HOST = '0.0.0.0' 会使服务暴露到公网！

✅ 请修改 server_config.py 中的 BIND_HOST：
   
   推荐配置：
   ─────────────────────────────────────────────────────────────
   │ BIND_HOST = '127.0.0.1'    # 仅本机访问（最安全，默认）
   │ BIND_HOST = '100.x.x.x'    # Tailscale IP（VPN 访问，安全）
   ─────────────────────────────────────────────────────────────

BIND_HOST	谁能访问	安全级别	服务行为
`127.0.0.1`	只有本机	✅ 最安全（默认）	正常启动
`Tailscale IP`	Tailscale VPN 内的设备	✅ 安全	正常启动
`192.168.x.x`	局域网内的设备	⚠️ 中等	正常启动
`0.0.0.0`	所有人	❌ 禁止	拒绝启动

推荐做法：

默认配置：127.0.0.1（仅本机访问）
远程访问：配置 Tailscale，然后设置 BIND_HOST 为 Tailscale IP

其他安全注意事项

在公开分享或部署前，请确保：

移除敏感信息
- Token 令牌
- 内网 IP 地址
- 域名信息
- 端口转发配置
配置 Gateway 安全
- 设置 allowedOrigins 白名单
- 使用 HTTPS 加密
- 定期更换 Token
网络安全
- 不要暴露到公网
- 使用内网或 VPN 访问
- 配置防火墙规则

📝 更新日志

2026.03.15

新功能

🔄 模型实时切换 - 下拉选择器实时切换 AI 模型，无需刷新页面
⚡ 快捷工具面板 - 可展开的快捷操作面板，快速访问常用功能
🔐 Session 认证管理 - 新增 SessionManager 类，Token 认证，24小时有效期
🛡️ 路径保护 - 敏感 API 路径（/browse/、/api/upload、/api/command）需要认证

Bug 修复

🐛 修复模型选择下拉框显示双对号问题（移除文本中对号，依赖浏览器 selected 属性）
🐛 修复清理 localStorage 后模型状态重置问题（API 不再返回 current 字段）

代码优化

🧹 删除 server.py 重复代码（重复的方法定义、重复的 import）
🧹 删除 mobile.html 重复标签和重复事件监听器
🧹 优化代码结构，减少约 100 行重复代码

安全增强

🔒 完善 .gitignore，确保敏感文件不会被提交
🔒 敏感配置文件（config.js、server_config.py、.env）与代码分离

2026.03.06

新功能

🔊 TTS 语音朗读 - 支持朗读 AI 回复，可自动朗读最后一条消息
📎 文件上传 - 支持发送任意文件类型（PDF、Office 文档等）
🔧 诊断页面 - 新增 /debug-config.html 用于排查配置问题

Bug 修复

🐛 修复 GatewayClient 类缺少 constructor 关键字导致 JS 语法错误
🐛 修复 config.js 从错误目录读取的问题，现在从 WORKSPACE_DIR 读取

改进

⚡ 增强调试日志，便于排查配置加载问题
⚡ 添加备用 token 获取机制
🧹 清理敏感文件，移除 config.js 和 server_config.py（使用上级目录配置）

2026.03.01

新功能

🌐 多语言支持（中文/英文）
💬 实时聊天，流式输出
🧠 思考过程展示
🔧 工具调用状态显示
📱 移动端优化

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 License

GNU General Public License v3.0

🙏 致谢

OpenClaw - AI Agent Framework
所有贡献者

Name		Name	Last commit message	Last commit date
docs		docs
screenshots		screenshots
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
README_EN.md		README_EN.md
check-sensitive.sh		check-sensitive.sh
config.example.js		config.example.js
i18n.js		i18n.js
mobile.html		mobile.html
server.py		server.py
server_config.example.py		server_config.example.py

BIND_HOST	安全性	说明
`127.0.0.1`	✅ 最安全	仅本机可访问（默认值）
`Tailscale IP`	✅ 安全	仅 VPN 网络可访问
`192.168.x.x`	⚠️ 中等	仅局域网可访问
`0.0.0.0`	❌ 禁止	服务会拒绝启动！

Latest commit

History

Folders and files

Repository files navigation

OpenClaw Mobile

🚨 安全警告：绝对不要设置 BIND_HOST = '0.0.0.0'

✨ 功能特性

📸 界面预览

功能说明

🚀 快速开始

方式一：一键配置（推荐）

📖 一键配置使用向导

配置流程

3 种访问方式组合

配置决策表

使用示例

访问地址自动添加

配置文件说明

常见问题

方式二：手动配置

1. 复制配置模板

2. 编辑配置

3. 前端配置 (config.js)

3. 后端配置 (server_config.py)

4. 配置 Gateway

3. 启动服务

4. 配置 Gateway

5. 启动服务

前台启动（调试用）

后台启动（生产环境）

重启服务

添加新语言

WebSocket 地址自动检测

配置示例

判断逻辑流程

不同环境的配置方式

Tailscale 配置

1. 前端配置 (config.js)

2. 后端配置 (server_config.py)

3. Gateway 配置 (openclaw.json)

4. 获取 Tailscale 信息

Gateway allowedOrigins

📖 文档

🏗️ 技术架构

整体架构

核心功能

技术栈

核心模块

与 Gateway 的交互

🔒 安全注意事项

敏感文件保护

🚨 BIND_HOST 配置（服务会强制检查！）

其他安全注意事项

📝 更新日志

2026.03.15

2026.03.06

2026.03.01

🤝 贡献

📄 License

🙏 致谢

About

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages