本地AI安装教程
约 1343 字大约 4 分钟
本地AIClaude CodeCursorCodex
2026-05-09
通过 ur CLI 让本地 AI 工具（Claude Code / Cursor / Codex / Trae / OpenClaw 等）直接操控联犀平台。
本文档原名「OpenClaw 接入」，现更名为「本地 AI 安装教程」：接入能力对所有本地 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
cp "/tmp/${DIR}/ur" ~/.local/bin/ur && chmod +x ~/.local/bin/ur
export PATH="$HOME/.local/bin:$PATH"
ur --versionWindows：从 Release 页面 下载
ur-cli-<版本>-Windows-x86_64.zip（或 arm64），解压后将ur.exe放入~/.local/bin并加入 PATH。国内网络受限时，可从 Gitee Release 下载同名资产。
本文档面向「用本地 AI 接入联犀」；如果是要部署联犀平台本身（Docker/源码），请先看 01. 安装教程。
2. 认证
ur 使用 Device Flow 授权，AI 环境无法使用交互式 ur setup：
# 获取授权链接
ur login --no-wait --json向用户发送返回的 verification_url，提示在浏览器打开并点击「完成 CLI 绑定」。
# 用户确认后完成授权
ur login --setup-code <CODE> --json配置自动保存到 ~/.ur/config.json。
3. 安装 Skills
# 方式 A：ur skills install —— 自动把 ur-api skill 部署到本机各 AI 工具
# （Claude Code / Codex 的用户级与项目级 skills 目录，v0.4.0+ 支持）
ur skills install
# 只安装到指定目录（可多次指定，ur-api 装到 <目录>/ur-api/）
ur skills install --dir /path/to/skills安装完成后重启 AI 工具，Skills 才会被加载。
AI 自助安装验证清单
AI 执行完上述 3 步后，应逐项自查，全部通过才算接入成功：
供 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
常见问题
绑定码过期？ 重新运行 ur login --no-wait --json 生成新的（有效期 10 分钟）。
私有化部署？ ur login --base-url https://my-saas.company.com --no-wait --json
Skills 安装后 AI 不识别命令？ 必须重启 AI 工具才能加载。
怎么卸载？ 删除 ~/.local/bin/ur、~/.ur/ 与各 AI skills 目录下的 ur-api 即可。
- CLI 仓库：https://github.com/unitedrhino/cli
- Skill 仓库：https://github.com/unitedrhino/skills
更新日志
2026/8/4 22:17
查看所有更新日志
af804-Merge #17 into master from feat/docs-local-ai-v2于ace53-Merge #16 into master from feat/docs-local-ai于
