把手机变成AI服务器：openclaw-termux SSH远程访问配置实战教程

• AI 应用
• LLM 网关
• 大模型
• 移动开发

openclaw-termux 是一款运行在 Android 上的 AI Gateway 应用，它通过内置的 proot Ubuntu 环境把 OpenClaw AI 网关装进手机，并提供内置终端、Web 控制台和一键安装向导。本文带你完整配置SSH 远程访问：从安装 OpenSSH、设置 root 密码，到启动 sshd 服务并从电脑或平板安全连入，几分钟内就能把手机变成一台支持远程 SSH 登录的轻量级手机 AI 服务器。

一、openclaw-termux 是什么，为什么需要 SSH

openclaw-termux 的核心，是在手机上零 Root 运行一个完整的 Ubuntu 环境，并在此基础上安装 Node.js 与 OpenClaw AI 网关。它同时提供两种使用方式：

默认情况下，网关只绑定到本机回环地址（127.0.0.1），只能在本机操作。当你希望在自己的电脑、平板或另一台设备上直接通过 SSH 连入手机、执行命令时，就需要开启 SSH 远程访问。这正是SshScreen管理界面要解决的问题，相关说明可参考官方文档 README.md。

打开应用后，在Dashboard 主页的 Quick Actions 区域即可看到SSH Access卡片（副标题为 "Remote terminal access via SSH"）。它就是本教程所有操作的起点，入口定义在 dashboard_screen.dart。

二、SSH 远程访问的工作原理

在动手之前，先理解它是怎么跑起来的，能帮你更好地排查问题：

• 独立的 Ubuntu 环境：sshd 运行在 proot 创建的 Ubuntu 容器中，不污染手机系统。
• 前台服务保活：sshd 由一个 Android 前台服务托管，配合通知栏与 24 小时唤醒锁，避免被系统杀后台。
• 监听所有网卡：服务会以ListenAddress 0.0.0.0启动，确保手机切换 Wi‑Fi / VPN 后仍能被访问。
• 允许 root 登录：因为 proot 本身就以伪 root 身份运行，所以配置了PermitRootLogin yes。

启动 sshd 的完整命令逻辑封装在 SshForegroundService.kt，核心是：

/usr/sbin/sshd -D -e -p 8022

其中-D表示前台运行（不 daemon 化），-e把日志输出到 stderr，-p 8022指定端口。整个 SSH 能力在应用侧由 ssh_service.dart 封装，通过原生桥接调用底层服务。

三、准备工作

在配置 SSH 前，先确保环境已就绪：

1. 已安装 openclaw-termux 应用并完成首次Begin Setup（会下载约 500MB 的 Ubuntu rootfs 与 Node.js）。
2. 手机与要连接的设备处于同一局域网（同一个 Wi‑Fi）。
3. 建议进入Settings → Battery Optimization关闭电池优化，防止后台被系统回收。

💡 首次安装环境耗时较长且需要稳定网络，请提前确认存储空间与连接。

四、步骤一：安装 OpenSSH 包

SSH 服务器依赖openssh-server。openclaw-termux 把OpenSSH作为可选开发工具之一，与 Go、Homebrew 并列，体积仅约10MB。

• 进入Dashboard → Packages，或直接在 SSH 页面点击Open Packages。
• 找到OpenSSH卡片，点击Install，应用会在 Ubuntu 内执行apt-get install -y openssh-client openssh-server。

包的安装命令与检测逻辑定义在 optional_package.dart，界面逻辑见 packages_screen.dart。安装完成后，卡片会显示绿色Installed标记。

⚠️ 如果 SSH 页面提示 "OpenSSH not installed"，就是这一步还没做，先回 Packages 安装即可。

五、步骤二：设置 root 密码

SSH 登录使用的是root用户，因此需要先为它设置密码：

1. 进入Dashboard → SSH Access。
2. 在ROOT PASSWORD区域输入新密码（密码框以掩码显示）。
3. 点击Set Password，成功后底部会提示 "Root password updated"。

🔐 密码不能为空。这里设置的密码后续就是 SSH 登录时的登录密码，请使用足够强的组合。

六、步骤三：启动 SSH 服务器

1. 在SERVICE CONTROL区域，确认Port（默认为8022，可自定义）。
2. 点击Start Server。
3. 等待约 2 秒，状态图标由灰色变为绿色，显示 "SSH server running"，此时前台服务会在通知栏常驻 "OpenClaw SSH" 以维持运行。

启动成功后，页面会自动拉取设备的 IP 地址（取自 Android 网络接口，而非 proot 内部），并渲染出可一键复制的连接信息。

七、步骤四：从另一台设备连接

在CONNECTION INFO区域，你会看到：

• User：root
• Port：当前端口
• IP Addresses：手机所有可用地址
• 每个 IP 对应一条可直接复制的连接命令

复制以下命令到你的电脑 / 平板终端执行即可（端口号以实际为准）：

ssh root@192.168.x.x -p 8022

输入第五步设置的 root 密码后，你就能直接在手机上执行命令——至此，一台SSH 远程 AI 服务器就绪。可复制命令行的渲染逻辑见 ssh_screen.dart。

八、常见问题排查

• 应用侧排查可结合Logs页面查看网关输出。
• 若用 Termux CLI 方式，可进入 Ubuntu 后手动apt install openssh-server再运行sshd。
• 更多版本演进与修复记录见 CHANGELOG.md，SSH 能力自v1.8.0起引入。

九、安全与最佳实践建议

• 仅限可信网络：ListenAddress 0.0.0.0意味着同网段设备皆可尝试连接，请勿把 SSH 直接暴露到公网。
• 强密码：root 密码即登录凭证，建议使用长且含大小写、数字、符号的组合。
• 用完即停：在 SERVICE CONTROL 点击Stop Server可立即终止 sshd，避免长时间暴露。
• 保持前台通知：通知栏的 "OpenClaw SSH" 是服务存活的关键，删除它可能导致服务被系统回收。

小结

openclaw-termux 通过 "安装 OpenSSH → 设置 root 密码 → 启动 sshd → 复制连接命令" 四步，把一台普通手机变成了可远程 SSH 登录的 AI 服务器。得益于 proot Ubuntu 隔离与前台服务保活，整个过程无需 Root、安全可控。现在打开 Dashboard 的SSH Access，跟着上面的步骤走一遍，几分钟内你就能从任意设备连入自己的手机 AI Gateway，随时随地执行命令、管理你的 AI 工作负载。

• AI 应用
• LLM 网关
• 大模型
• 移动开发