Android 伴侣优先模式:OpenClaw Shell 交互体验的 4 项关键改进

—bash

自动检测终端尺寸并优化输出

$ openclaw shell –companion-mode

输出示例:检测到 67×24 字符区域,启用紧凑布局

[INFO] Terminal size: 67×24, enabling compact layout


关键优化点
  • 超长命令自动折行,保留语法高亮
  • 目录路径智能缩写(~/projects/my-long-project-name~/.../my-long-project
  • 多列输出自动转为垂直列表

2.2 触屏优化的手势命令

新增手势快捷操作,减少虚拟键盘依赖:

| 手势 | 功能 | 传统方式 | |:---|:---|:---| | 左滑 | 快速补全历史命令 | Ctrl+R 搜索 | | 长按空白处 | 唤起命令面板 | 手动输入 --help | | 双指缩放 | 调整字体/信息密度 | 设置菜单翻找 | | 下拉 | 刷新 Agent 状态 | openclaw status |

javascript
// 在 openclaw.config.js 中启用手势
module.exports = {
android: {
companionMode: true,
gestures: {
swipeLeft: ‘history-complete’,
longPress: ‘command-palette’,
pinch: ‘font-scale’
}
}
}


2.3 上下文感知的输入辅助

AI Agent 执行复杂任务时,Shell 会预测下一步操作并提供智能建议:

bash
$ openclaw deploy –env staging
[Agent] 检测到部署操作,建议检查:
1. 运行测试套件 → 点击执行或输入 test
2. 查看最近提交 → 点击执行或输入 log -3
3. 跳过检查直接部署 → 输入 force

> _ # 光标位置,可直接点击选项或键盘输入


这种 "点击+输入"双通道 设计兼顾了效率与灵活性。

2.4 离线优先的状态同步

针对移动端网络不稳定场景,优化了本地缓存与冲突解决:

bash

查看同步状态与本地队列

$ openclaw sync –status

[本地] 3 条命令待同步
– 14:32 修改配置 (未冲突)
– 14:35 创建分支 feature/mobile-shell ✓ 已预执行
– 14:38 合并请求 #127 (检测到远程更新)

[建议] 先执行 sync resolve 处理冲突


---

三、如何启用新功能

步骤 1:更新 OpenClaw CLI

bash

更新到包含该提交的版本

npm install -g @openclaw/cli@latest

或指定版本

npm install -g @openclaw/cli@0.9.4-companion.2


步骤 2:配置 Android 伴侣模式

bash

交互式配置向导

$ openclaw config –init –platform android

? 启用 companion-first 模式? Yes
? 首选输入方式 (键盘优先/手势优先/混合) 混合
? 字体大小基准 (小/中/大) 中
? 启用离线缓存? Yes


步骤 3:验证配置

bash
$ openclaw doctor –companion-check

✓ Android SDK 已连接
✓ 终端尺寸检测正常 (67×24)
✓ 手势服务已注册
✓ 离线缓存: 256MB 可用
✓ Agent 状态同步延迟: 120ms


---

四、常见问题 (FAQ)

Q1: Companion-first 模式会影响桌面端使用吗?

不会。该模式仅在检测到 Android 终端时自动激活,桌面端保持原有交互逻辑。可通过 openclaw shell --no-companion 强制禁用。

Q2: 旧版 Android 设备是否支持手势操作?

支持。手势层基于标准触控事件实现,Android 5.0 (API 21) 及以上版本均可使用。部分高级手势(如三指操作)需要 Android 8.0+。

Q3: 离线状态下执行的命令会丢失吗?

不会。所有操作先写入本地队列,网络恢复后自动同步。冲突场景下会提示手动选择保留本地或远程版本。

Q4: 能否自定义手势映射?

可以。编辑 ~/.openclaw/keybindings.json

json
{
“android.gestures”: {
“swipeLeft”: “custom:my-script.sh”,
“twoFingerTap”: “agent:pause”
}
}


Q5: 该更新与 OpenClaw Desktop 的协同功能冲突吗?

不冲突。Companion-first 模式优化的是"以手机为主"的场景,与桌面端的远程控制功能(如 openclaw bridge)可无缝切换。

---

五、总结与下一步

本次更新标志着 OpenClaw 对移动端开发场景的深度投入。四项改进——自适应终端手势命令智能辅助离线同步——共同构建了真正适合小屏幕的 Shell 体验。

建议下一步行动: 1. 在 OpenClaw 文档 查阅完整的 Android 配置指南 2. 加入 Discord 社区 分享使用反馈 3. 关注 GitHub mobile-ux 标签获取后续更新

---

相关阅读

---

参考来源