通过 ur CLI 让本地 AI 工具（Claude Code / Cursor / Codex / Trae / OpenClaw 等）直接操控联犀平台。

本文档原名「OpenClaw 接入」，现更名为「本地 AI 安装教程」：联犀的第三方客户端绑定（Device Flow）接入机制统称为「第三方客户端认证（CLI/Agent 接入）」，对所有本地 AI 工具通用，OpenClaw 只是首批接入方之一。

---

一键提示词

把下面这句话发给任意本地 AI（Claude Code / Cursor / Codex / Trae）：

帮我安装联犀 CLI 并接入平台：https://doc.unitedrhino.com/use/01.快速开始/09.本地AI安装教程/

AI 将按本文档自动完成安装、认证和 Skills 部署。

---

快速安装（3 步）

1. 安装 CLI

# 自动检测系统并下载最新版（release 资产命名：ur-cli-<版本>-<平台名>.tar.gz）
VERSION=$(curl -s https://api.github.com/repos/unitedrhino/cli/releases/latest | grep '"tag_name"' | cut -d'"' -f4)
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m)

# 平台名与 release 资产命名一致（大写开头的友好名称）
case "${OS}-${ARCH}" in
  linux-x86_64)  PLATFORM="Linux-x86_64";   DIR="linux-amd64" ;;
  linux-aarch64) PLATFORM="Linux-aarch64";  DIR="linux-arm64" ;;
  darwin-x86_64) PLATFORM="macOS-x86_64";   DIR="darwin-amd64" ;;
  darwin-arm64)  PLATFORM="macOS-arm64";    DIR="darwin-arm64" ;;
  *) echo "不支持的平台: ${OS}-${ARCH}"; exit 1 ;;
esac

# 下载并解压（包内为 <goos-goarch>/ 目录，含 ur 二进制与 skill/）
curl -L -o /tmp/ur-cli.tar.gz "https://github.com/unitedrhino/cli/releases/download/${VERSION}/ur-cli-${VERSION}-${PLATFORM}.tar.gz"
tar -xzf /tmp/ur-cli.tar.gz -C /tmp
mkdir -p ~/.local/bin
# skill/ 是内置 skills 源目录，必须一并保留：与 ur 二进制同级（或放到 ~/.ur/skills），
# 否则后续 ur skills install 会报「内置 skills 源目录不存在」
cp "/tmp/${DIR}/ur" ~/.local/bin/ur && chmod +x ~/.local/bin/ur
cp -r "/tmp/${DIR}/skill" ~/.local/bin/
export PATH="$HOME/.local/bin:$PATH"
ur --version

Windows：从 Release 页面 下载 ur-cli-<版本>-Windows-x86_64.zip（或 arm64），完整解压 zip，保持 ur.exe 与 skill/ 目录同级，再一起放入 PATH 目录（如 C:\Users\<你>\.local\bin）。只把 ur.exe 单独拷走会导致 ur skills install 找不到内置 skills 源目录。

国内网络受限时，可从 Gitee Release 下载同名资产。

本文档面向「用本地 AI 接入联犀」；如果是要部署联犀平台本身（Docker/源码），请先看 01. 安装教程。

2. 认证

ur 使用 Device Flow 授权，AI 环境无法使用交互式 ur setup：

# 获取授权链接（v0.4.1 起默认连接联犀公有云 https://saas.unitedrhino.com，无需传参）
ur login --no-wait --json

• 公有云接入：直接执行上面的命令即可，ur CLI v0.4.1 起内置默认平台地址 https://saas.unitedrhino.com。
• 私有化部署：显式指定自己的平台地址覆盖默认值：

ur login --base-url https://my-saas.company.com --no-wait --json

• v0.4.0 及更早版本：没有内置默认地址，无论公有云还是私有化都必须显式传 --base-url（公有云为 https://saas.unitedrhino.com）。

向用户发送返回的 verification_url，提示在浏览器打开并点击「完成第三方客户端绑定」。

# 用户确认后完成授权
ur login --setup-code <CODE> --json

配置自动保存到 ~/.ur/config.json。

3. 安装 Skills

方式 A：ur skills download 下载后自行拷贝（推荐，适用于任意 AI 工具，v0.4.1+）

CLI 负责下载最新 skills 包并解压（默认到 ~/.ur/downloads/），AI 再按命令输出的指引，把 ur-api/ 目录整体拷贝到自己工具的 skills 目录——AI 自知自身的 skills 目录位置（例如 Claude Code 为 ~/.claude/skills/，OpenClaw / WorkBuddy 为各自目录），拷贝后重启 AI 工具即可：

# 下载并解压最新 skills 包，按输出指引完成拷贝（--json 可获取结构化输出，便于 AI 解析）
ur skills download --json

方式 B：ur skills install 自动部署（便捷，v0.4.0+）

自动探测 Claude Code / Codex 的用户级与项目级 skills 目录并安装：

ur skills install

# 只安装到指定目录（可多次指定，ur-api 装到 <目录>/ur-api/）
ur skills install --dir /path/to/skills

方式 C：从 Release 手动下载（兜底）

从 Release 页面 下载 ur-api-skills-<版本>.zip，解压后把 ur-api/ 目录自行拷贝到 AI 工具的 skills 目录。

无论用哪种方式，安装完成后都要重启 AI 工具，Skills 才会被加载。

AI 自助安装验证清单

AI 执行完上述 3 步后，应逐项自查，全部通过才算接入成功：

• ur --version 输出版本号（非 dev）
• ur login --no-wait --json 返回 verification_url，用户完成绑定后 ur login --setup-code <CODE> --json 成功
• ur check 通过（无 403/权限错误）
• ur api /api/v1/system/user/self/get-one 返回当前用户信息
• Skills 已就位（方式 A 拷贝的 ur-api/ 或方式 B ur skills install 的部署结果均可），AI 重启后能识别 ur 命令
• 让 AI 执行一条真实操作（如「列出当前租户下的设备」）并确认返回真实数据

供 AI 使用：以上清单可直接作为 prompt 让 AI 自检；任一步失败时，按「常见问题」排查或重新执行对应步骤。

---

升级与维护

# 检查是否有新版本（不安装）
ur upgrade --dry-run

# 升级到最新版（升级后内置 skills 自动随安装包同步；
# 每次运行命令时自动低频检查版本，发现新版本或版本过旧会在终端提醒）
ur upgrade

# 升级后自动把 skills 部署到本机各 AI 工具
ur upgrade --install-skills

# 跳过自动版本检查（环境变量）
export UR_NO_UPDATE_CHECK=1

从旧版本（v0.3.x 及更早）升级时，首次升级由旧版程序执行、不会同步 skills；升级完成后运行一次 ur skills update 或 ur skills install 即可补齐。

---

开始使用

安装完成后直接用自然语言操作：

示例指令	说明
帮我列出当前租户下的所有设备	设备列表查询
查询设备 dev123 的最新属性	单设备数据查询
创建一个新产品，叫智能温湿度传感器	产品创建
查看今天的设备告警	告警查询
导出项目 A 的设备在线状态报表	报表导出

---

应用上下文

ur 通过 --app 切换应用域：

应用	--app	覆盖域
物联网	iot	设备、产品、项目、OTA
平台管理	platform-manage	租户、用户、应用、授权
组织管理	org-manage	组织用户、角色、AI
能源管理	org-energy	能耗分析、电力集抄
控制台	console	个人信息、访问令牌

环境变量：export UR_APP=iot

---

常见问题

绑定码过期？ 绑定码自生成起 10 分钟内有效（v0.4.1 起，超时后端将拒绝完成绑定）。过期后重新运行 ur login --no-wait --json 生成新的即可。

私有化部署？ 登录时用 --base-url 指定自己的平台地址：ur login --base-url https://my-saas.company.com --no-wait --json。v0.4.1 起默认连接 https://saas.unitedrhino.com，私有化需覆盖；v0.4.0 及更早版本无论公有云还是私有化都必须显式传 --base-url。

Skills 安装后 AI 不识别命令？ 必须重启 AI 工具才能加载。

怎么卸载？ 删除 ~/.local/bin/ur、~/.ur/ 与各 AI skills 目录下的 ur-api 即可。

---

• CLI 仓库：https://github.com/unitedrhino/cli
• Skill 仓库：https://github.com/unitedrhino/skills

更新日志

2026/9/4 09:42

查看所有更新日志

• bba36-docs(use): 绑定描述文案统一为第三方客户端绑定口径于 2026/9/4
• 2fdf5-docs(use): 接入机制正名为第三方客户端认证，OpenClaw 降为接入方举例于 2026/9/3
• 6f380-docs(use): 本地AI安装教程修正安装/认证踩坑点并新增 skills 下载自装指引于 2026/9/3
• af804-Merge #17 into master from feat/docs-local-ai-v2于 2026/8/4
• ace53-Merge #16 into master from feat/docs-local-ai于 2026/8/4

贡献者: 杨磊, godLei6

上一页Node-RED MQTT接入

下一页urops 工具使用指南