理想汽车 · Plugin Docs

livis-pc-kit 安装指南

openclaw · livis 消息接入插件

本文档面向使用理想同学 App 以及眼镜的用户,介绍个人 Agent 连接功能的使用方式,包括连接步骤、眼镜端与 App 端的调用方法、优先响应设置,以及常见问题的处理建议。如在使用过程中遇到文档未覆盖的问题,可通过 App 内设置 → 反馈联系我们。

功能介绍

个人 Agent 是你自己配置的 AI 助手。连接后,你可以在理想同学 App 以及眼镜上直接调用它,让它按照你的偏好和设置来响应你的需求。

如何连接个人 Agent?

1打开 App,进入设置,点击连接与服务
2点击连接我的 Agent
3按照页面引导完成授权
4看到"连接成功"提示即完成
连接成功后,同一个账号下,眼镜和 App 共享同一个 Agent 连接,无需重复连接

如何使用个人 Agent?

理想同学 App

从首页点击"我的Agent"进入,在对话界面直接发送消息即可调用你的个人 Agent。

眼镜端唤醒词

通过以下唤醒词在眼镜端调用,唤醒后直接说出你的需求,Agent 的回复将通过眼镜播报给你:

让我的个人Agent 让我的个人终端 让我的open claw 让我的小龙虾

优先响应

开启优先响应后,你在眼镜上发起的所有对话都将优先由个人 Agent 来处理,无需固定词指定。

1确保已连接个人 Agent
2进入 我的 → 连接与服务 → 我的Agent → 优先响应
3打开开关即可生效
优先响应仅在眼镜端生效,App 端不受影响

版本兼容性

OpenClaw 版本插件版本要求
> v2026.3.23v2.0.0+

安装

Mac / Linux

安装(最新版)

bash <(curl -fsSL https://li-center.lixiang.com/livis-pc-kit/openclaw/mac-linux/latest/setup.sh) --openclaw

安装指定版本

bash <(curl -fsSL https://li-center.lixiang.com/livis-pc-kit/openclaw/mac-linux/latest/setup.sh) --openclaw install --version v2.0.0

更新

bash <(curl -fsSL https://li-center.lixiang.com/livis-pc-kit/openclaw/mac-linux/latest/setup.sh) --openclaw update

Windows(PowerShell)

安装(最新版)

& ([scriptblock]::Create((irm "https://li-center.lixiang.com/livis-pc-kit/openclaw/windows/latest/setup.ps1"))) --openclaw

安装指定版本

& ([scriptblock]::Create((irm "https://li-center.lixiang.com/livis-pc-kit/openclaw/windows/latest/setup.ps1"))) --openclaw install --version v2.0.0

更新

& ([scriptblock]::Create((irm "https://li-center.lixiang.com/livis-pc-kit/openclaw/windows/latest/setup.ps1"))) --openclaw update

卸载

Mac / Linux

bash <(curl -fsSL https://li-center.lixiang.com/livis-pc-kit/openclaw/mac-linux/latest/setup.sh) --openclaw uninstall

Windows(PowerShell)

& ([scriptblock]::Create((irm "https://li-center.lixiang.com/livis-pc-kit/openclaw/windows/latest/setup.ps1"))) --openclaw uninstall

检查 & 诊断

openclaw plugins list     # 检查插件是否已加载
openclaw plugins doctor   # 诊断问题

登录认证

快速登录

openclaw livis-pc-kit login

切换账号

openclaw livis-pc-kit login --switch
⚠️ 切换账号后需重启 gateway,否则 WebSocket 连接不会更新:
openclaw gateway restart

退出登录

基本登出

openclaw livis-pc-kit logout

完全登出

openclaw livis-pc-kit logout --clear

上传日志

openclaw livis-pc-kit uploadlog

上传本地日志文件,用于问题排查。

查看 Agent ID

openclaw livis-pc-kit agent-id

打印当前登录账号的 Agent ID,用于在移动端 App 完成设备绑定。

常见问题

Q:我想要我的 Agent 发文件到理想同学 App 上,为什么发不过来?

我们支持 Word、PDF、HTML 以及 MD 文件在理想同学 App 的展示,如果你的文件格式符合以上要求,可以:

  1. 确认已经打开 message 工具
  2. 尝试这样告诉 Agent:"请调用message工具,把xxx文件发我"

Q:可以连接多个 Agent 吗?

目前每个账号仅支持连接一个个人 Agent。如需切换,请先断开当前连接,再连接新的 Agent。

Q:我可以语音给我的个人Agent改名字吗?

暂不支持通过语音修改理想同学App上显示的bot名称,你可以前往「我的」-「连接与服务」-「我的Agent」页面手动更改。

Release Notes

v2.0.0