系统环境

• 设备：安卓手机

• 环境：Termux + proot-distro (Ubuntu)

• OpenClaw版本：2026.3.7

• AI模型：智谱AI GLM系列

一、环境准备与安装

1.1、安装Termux

• 从F-Droid下载Termux（Google Play版本已停止维护）

• 访问：https://f-droid.org/en/packages/com.termux/

1.2、基础环境配置

• 更新软件包
  pkg update && pkg upgrade -y

• 安装必要工具
  pkg install -y proot-distro git curl wget

• 授予存储权限
  termux-setup-storage

1.3、安装Ubuntu环境

• 安装Ubuntu
  proot-distro install ubuntu

• 登录Ubuntu
  proot-distro login ubuntu

1.4、Ubuntu内安装依赖

• 更新系统
  apt update && apt upgrade -y

• 安装基础工具
  apt install -y curl git build-essential nano

• 安装Node.js 22

  • curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
  • apt install -y nodejs

• 验证版本

  • node -v # 应显示v22.x.x
  • npm -v

1.5 修复网络接口问题

• 创建网络修复补丁

cat > /root/fix-net.js << 'EOF'
const os = require('os');
os.networkInterfaces = () => ({
  'lo': [{
    address: '127.0.0.1',
    netmask: '255.0.0.0',
    family: 'IPv4',
    mac: '00:00:00:00:00:00',
    internal: true,
    cidr: '127.0.0.1/8'
  }]
});
console.log('✅ Android/PRoot 网络修复补丁已加载');
EOF

• 永久生效

echo 'export NODE_OPTIONS="--require /root/fix-net.js"' >> ~/.bashrc
source ~/.bashrc

1.6 安装OpenClaw

• 安装OpenClaw
  npm install -g openclaw@latest

• 验证安装
  openclaw --version

二、基础配置向导

• 运行配置向导：openclaw onboard

2.1 配置步骤与选择

1. 选择智谱AI,Model/auth provider Z.AI

2. 选择针对Coding平台API Key，Z.AI auth method Coding-Plan-CN

3. 输入APIkey，在智谱AI开发者平台注册创建

4. Channel（外部渠道）选择，Select channel Skip for now 跳过外部渠道，先测试核心功能

5. 跳过搜索，Search provider Skip for now 后续可添加Tavily或百度搜索

6. 启用基础技能Configure skills now?选 Yes ，启用基础技能：weather, calendar-read, reminders

7. 选择地理搜索（goplaces）， 选No 地理搜索，国内网络可能受限

8. 选择图像生成（nano-banana-pro）选 No ，非核心功能

9. 选择Notion（文本相关） 按需选择 如需Notion集成可启用

10. 选择语音合成（sag）选No ，国内网络可能受限

11. 选择启用会话记忆功能
    （Enable hooks）选择·session-memory

12. 选择Install missing skill dependencies选Skip for now 跳过，后续按需安装

2.2 技能配置建议

后续可安装的实用技能

• clawhub install summarize # 文本摘要
• clawhub install baidu-search # 百度搜索（国内可用）
• clawhub install github # GitHub集成（如需）

三、智谱模型选择建议

模型	免费额度	稳定性	推荐度
glm-4.7-flash	✅ 永久免费	⭐⭐⭐⭐	⭐⭐⭐⭐⭐
glm-4.7	✅ 永久免费	⭐⭐⭐⭐	⭐⭐⭐⭐
glm-5	⚠️ 需申请	⭐⭐	⭐⭐
glm-4.7-flashx	✅ 永久免费	⭐⭐⭐	⭐⭐⭐

四、网关启动与访问

• 启动网关openclaw gateway run
• 在手机浏览器打开：http://127.0.0.1:18789/?token=$TOKEN",启动时候有，或者到~/.openclaw/openclaw.json中获取

五、手机系统优化（可不看）

设置项 操作路径 目的

• 关闭电池优化 设置 → 应用 → Termux → 电池 → 无限制 防止系统休眠杀进程

• 允许后台运行 设置 → 应用 → Termux → 电池 → 允许后台活动 保持服务常驻

• 开启自启动 设置 → 应用 → Termux → 自启动 → 允许 开机自动启动

六、常见错误与解决方案

6.1 “unauthorized: gateway token missing”

问题：访问Web UI时缺少认证令牌
原因：在浏览器中访问http://127.0.0.1:18789未带token
解决：必须使用带token的URL访问

6.2、 “systemd user services are unavailable”

• 原因没有正确配置模型的api-key

6.3 “500 内部服务器错误”

问题：API调用失败
原因：key配置失败
解决：

1. 检查API Key是否有效
2. 切换模型到稳定版本（glm-4.7-flash）
3. 检查baseUrl是否正确

总结

5. 安装环境：Termux → Ubuntu → Node.js
6. 安装OpenClaw：npm install -g openclaw@latest
7. 运行向导：openclaw onboard
8. 配置API Key：创建auth-profiles.json文件
9. 启动网关：使用tmux启动openclaw gateway
10. 访问Web UI：通过带token的URL访问