【AidLux一键安装】手机跑 OpenClaw ！15分钟搞定移动AI助手

犀友集（互动&交流）
1

本文基于 termux-install-openclaw 项目的 AidLux 安装脚本整理，原文出处：https://github.com/byteuser1977/termux-install-openclaw

:bullseye: 为什么选择 AidLux？

如果你：

  • :white_check_mark: 想快速体验 OpenClaw，不想折腾环境

  • :white_check_mark: 需要完整的 Linux 桌面环境（有图形界面）

  • :white_check_mark: 是新手，希望最简单的安装流程

  • :white_check_mark: 想用手机作为移动 AI 助手

→ AidLux 是你的最佳选择！

:package: 方案对比：AidLux vs Termux+Ubuntu

特性 AidLux Termux+Ubuntu
安装难度 :star: 最简单 :star::star: 需要多一步
耗时 15 分钟 30-60 分钟
桌面环境 :white_check_mark: 完整桌面 :cross_mark: 只有终端
稳定性 :star::star::star::star::star: :star::star::star::star::star:
资源占用 ~2GB ~1.5GB
适合人群 绝对新手、想快速上手 有一定经验、追求稳定

结论：如果你是第一次在手机上部署 OpenClaw，强烈建议从 AidLux 开始！

:rocket: 一键安装步骤

前置条件

  1. 安装 AidLux App

  2. 准备网络

    • 确保手机可以访问 GitHub

    • 国内用户建议配置代理或使用加速镜像

三步安装流程

第 1 步：运行一键脚本

打开 AidLux 的终端（Terminal），执行：

curl -fsSL https://raw.githubusercontent.com/byteuser1977/termux-install-openclaw/main/scripts/install-aidlux.sh | bash

复制

脚本会自动完成：

  • :white_check_mark: 安装 Node.js v24（通过 nvm）

  • :white_check_mark: 安装 OpenClaw-CN Termux 适配版

  • :white_check_mark: 配置国内 npm 镜像

  • :white_check_mark: 创建 openclaw 用户和目录结构

预计耗时：5-10 分钟（取决于网络速度）

第 2 步：交互式配置

脚本完成后，运行：

openclaw-termux onboard

复制

配置项说明：

配置项 建议值 说明
Gateway 端口 18789 默认，一般不用改
绑定地址 lan 允许局域网访问
Token 随机生成 用于 API 认证，务必记下！
模型 API Key 你的 OpenAI/Claude/DeepSeek key 必需
默认模型 anthropic/claude-sonnet-4-5 推荐 Claude
语言 zh-CN 中文用户体验更好

:warning: 重要：Token 和 API Key 请妥善保存，建议截图或写入笔记。

第 3 步：启动网关

配置完成后，启动 OpenClaw：

openclaw-termux gateway

复制

首次启动会：

  • 加载所有默认技能

  • 初始化数据库

  • 启动 Web UI 服务

启动成功后，你会看到类似输出：

[INFO] Gateway listening on http://0.0.0.0:18789
[INFO] Web UI available at http://localhost:18789
[INFO] API token: your-token-here

复制

:globe_with_meridians: 访问 OpenClaw Web UI

在手机上访问

打开 AidLux 内置浏览器，访问：

http://localhost:18789

复制

你会看到 OpenClaw 的 Web UI 界面，可以开始聊天和管理 Agent 了！

在局域网其他设备访问

如果你的手机和电脑在同一 WiFi：

  1. 查看手机 IP 地址（AidLux 设置 → 网络）

  2. 在电脑浏览器访问：

http://<手机IP>:18789

复制

例如：http://192.168.1.100:18789

注意：确保 gateway.bind 设置为 lan 或 0.0.0.0 才能从其他设备访问。

:gear: 后台运行与自启动

后台运行

想让 OpenClaw 在后台持续运行（关闭终端也不停止）：

nohup openclaw-termux gateway > ~/.openclaw/gateway.log 2>&1 &

复制

查看运行状态：

ps aux | grep openclaw

复制

停止服务：

pkill -f openclaw-termux

复制

开机自启动（可选）

编辑 AidLux 的启动脚本（如果支持的话），或者使用 Android 的 Tasker/Automate 应用在开机时自动运行上述命令。

:wrench: 常见问题与解决

Q1: 内存不足，进程被 kill？

症状：打开 App 或运行任务时，OpenClaw 突然退出

原因：手机 RAM 有限（通常 4-8GB），OpenClaw 默认配置占用较多内存

解决：

  1. 限制 worker 数量
    编辑 ~/.openclaw/openclaw.json：
{
  "gateway": {
    "workers": 1  // 改为 1，不要用默认值
  }
}

复制

  1. 限制内存使用
{
  "gateway": {
    "maxMemory": "512MB"  // 限制最大内存
  }
}

复制

  1. 关闭不需要的技能
    在 Web UI 的技能管理页面，禁用视频处理、大模型推理等重型技能

  2. 创建 Swap 文件（最后手段）
    如果 RAM 真的不够，可以创建 swap 交换分区：

# 创建 2GB swap 文件
dd if=/dev/zero of=/swapfile bs=1M count=2048
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile

# 开机自启（添加到 /etc/fstab）
echo '/swapfile none swap sw 0 0' >> /etc/fstab

复制

:warning: 注意：Swap 会使用存储空间，性能不如 RAM，但能避免进程被 kill。

Q2: 网络访问慢或失败？

症状：Web UI 加载慢、API 请求超时

原因：国内访问 GitHub/npm 慢，或者手机信号不好

解决：

  1. 确保 npm 镜像已配置（安装脚本已自动配置）

检查 ~/.npmrc：

registry=https://registry.npmmirror.com

复制

如果没有，手动设置：

npm config set registry https://registry.npmmirror.com

复制

  1. 使用代理（如果网络环境复杂）
# 设置 HTTP 代理
export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port

复制

  1. 使用更好的 WiFi 或 4G/5G 网络

Q3: 无法从其他设备访问？

症状：手机上可以访问 localhost:18789，但电脑上打不开

原因：网关只绑定了本地回环地址

解决：

  1. 检查配置 ~/.openclaw/openclaw.json：
{
  "gateway": {
    "bind": "lan"  // 必须是 lan 或 0.0.0.0
  }
}

复制

  1. 重启网关：
openclaw-termux gateway --restart

复制

  1. 在 AidLux 防火墙设置中允许 18789 端口（如果有）

Q4: Node.js 版本不对？

症状：openclaw-termux 命令找不到或报版本错误

解决：

确保 nvm 已加载：

# 加载 nvm
. "$HOME/.nvm/nvm.sh"

# 检查 Node 版本
node --version  # 应该显示 v24.x

# 如果版本不对
nvm install 24
nvm alias default 24

复制

如果每次打开终端都要重新加载 nvm，可以添加到 ~/.bashrc：

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "/data/data/com.termux/files/home/.nvm/nvm.sh" ] && \. "/data/data/com.termux/files/home/.nvm/nvm.sh"' >> ~/.bashrc
source ~/.bashrc

复制

Q5: 启动失败或日志报错？

查看日志：

tail -f ~/.openclaw/gateway.log

复制

常见错误：

  • 端口占用：Error: listen EADDRINUSE :::18789 解决方案：修改配置使用其他端口，或停止占用端口的进程

  • 权限不足：EACCES 解决方案：确保 openclaw 用户有权限写入 ~/.openclaw/ 目录

  • 模型 API Key 无效：检查 openclaw.json 中的 agent.apiKey

:light_bulb: 适用场景与限制

:white_check_mark: 推荐使用场景

  1. 学习与开发测试 低成本体验 OpenClaw 全功能，测试技能包，无需服务器费用

  2. 移动办公助手 外出时快速回复社区消息、处理简单任务（如定时提醒、信息查询）

  3. 备用服务器 手机 24 小时运行，作为主服务器的热备（网络恢复时自动同步）

  4. IoT 边缘计算 配合手机传感器（GPS、加速度计、麦克风），做本地自动化

:cross_mark: 不适合的场景

场景 原因
大规模数据处理（>1GB） 手机存储和 I/O 速度有限
本地大模型推理（70B） 手机算力不足，会卡顿
高并发消息处理（>1000条/天） 性能和稳定性无法保证
实时视频/语音处理 CPU/ GPU 不够，延迟高

建议：复杂任务委托给云端 API（OpenAI、Claude、DeepSeek），手机端只做协调和轻量处理。

:bar_chart: 资源消耗参考（实测数据）

配置 RAM 占用 存储占用 CPU 占用（空闲）
AidLux + OpenClaw（默认） 800MB - 1.5GB 3-5GB 2-5%
限制 workers=1 + 512MB 内存 400-600MB 3-5GB 1-3%
开启本地 LLM（7B 模型） 2-4GB 6-10GB 10-30%

:light_bulb: 建议：手机端使用云端 API，不要跑本地 LLM（除非离线场景）。

:counterclockwise_arrows_button: 更新与维护

更新 OpenClaw

# 更新到最新版本
pnpm add -g openclaw-cn-termux@latest

复制

备份配置

成功后，务必备份 ~/.openclaw/ 目录：

cd ~
tar czf openclaw-backup-$(date +%Y%m%d).tar.gz .openclaw/

复制

可以将备份文件复制到电脑或云盘。

迁移到其他手机

  1. 在新手机重复上述安装步骤

  2. 恢复备份：

cd ~
tar xzf openclaw-backup-YYYYMMDD.tar.gz
openclaw-termux onboard  # 重新配置（可选）
openclaw-termux gateway

复制

:books: 参考资料

1 个赞
2

更新了openclaw的版本

1 个赞