OpenClaw 接入
约 1572 字大约 5 分钟
OpenClawPicoClawHermesCLI
2026-05-09
通过 ur-api CLI 工具,让 AI 智能体(OpenClaw / PicoClaw / Hermes)与联犀平台对接,实现通过自然语言管理设备、查询数据、执行操作。
产物下载
ur CLI 支持 39 个原生平台,从 GitHub 或 Gitee Release 下载。国内用户建议优先使用 Gitee。
下载地址
| 平台 | 架构 | Gitee 下载 | GitHub 下载 |
|---|---|---|---|
| Linux | x86_64 | Linux-x86_64.tar.gz | Linux-x86_64.tar.gz |
| Linux | ARM64 | Linux-aarch64.tar.gz | Linux-aarch64.tar.gz |
| macOS | Intel | macOS-x86_64.tar.gz | macOS-x86_64.tar.gz |
| macOS | Apple Silicon | macOS-arm64.tar.gz | macOS-arm64.tar.gz |
| Windows | x86_64 | Windows-x86_64.zip | Windows-x86_64.zip |
完整平台列表:Linux (13 架构)、macOS (2 架构)、Windows (3 架构)、FreeBSD (4 架构)、OpenBSD (6 架构)、NetBSD (4 架构)、AIX、DragonFly、Illumos、Plan9、Solaris 等,详见 Release 页面。
架构自动检测命令:
ARCH=$(uname -m)
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case "${OS}-${ARCH}" in
linux-x86_64) PLATFORM="Linux-x86_64" ;;
linux-aarch64) PLATFORM="Linux-aarch64" ;;
darwin-x86_64) PLATFORM="macOS-x86_64" ;;
darwin-arm64) PLATFORM="macOS-arm64" ;;
msys-x86_64|mingw-x86_64|cygwin-x86_64) PLATFORM="Windows-x86_64" ;;
*) echo "unsupported: ${OS}-${ARCH}"; exit 1 ;;
esac
echo "Selected: ${PLATFORM}"AI 自助安装流程(PicoClaw / OpenClaw / Hermes)
AI 读取本文档后,按以下 6 步自动完成安装。
Step 1: 检测环境
1.1 检测操作系统和架构:
ARCH=$(uname -m)
OS=$(uname -s | tr '[:upper:]' '[:lower:]')1.2 根据检测结果选择对应产物包(见上表)。
1.3 检测已安装的 Claw 类型:
# OpenClaw
OPENCLAW_ROOT=""
for path in "$HOME/.npm-global/lib/node_modules/openclaw" "/usr/local/lib/node_modules/openclaw"; do
if [ -d "$path/skills" ]; then OPENCLAW_ROOT="$path"; break; fi
done
# PicoClaw
PICOCLAW_ROOT="${PICOCLAW_WORKSPACE:-$HOME/.picoclaw/workspace}"
# Hermes
HERMES_ROOT="$HOME/.hermes/skills"Step 2: 下载产物
VERSION="v0.1.0"
PLATFORM="Linux-x86_64" # 根据 Step 1 检测结果替换
# 优先 Gitee 下载(国内更快)
DOWNLOAD_URL="https://gitee.com/unitedrhino/cli/releases/download/${VERSION}/ur-cli-${VERSION}-${PLATFORM}.tar.gz"
# GitHub 备用(Gitee 不可用时)
# DOWNLOAD_URL="https://github.com/unitedrhino/cli/releases/download/${VERSION}/ur-cli-${VERSION}-${PLATFORM}.tar.gz"
curl -L -o "/tmp/ur-cli-${PLATFORM}.tar.gz" "$DOWNLOAD_URL"
rm -rf "/tmp/ur-cli-${PLATFORM}"
tar -xzf "/tmp/ur-cli-${PLATFORM}.tar.gz" -C "/tmp/ur-cli-${PLATFORM}"期望输出:解压后出现 /tmp/ur-cli-${PLATFORM}/linux-amd64/bin/ 和 /tmp/ur-cli-${PLATFORM}/linux-amd64/skill/ 目录。
Step 3: 安装二进制
3.1 Linux / macOS:
BIN_DIR="$HOME/.local/bin"
mkdir -p "$BIN_DIR"
# 注意:根据实际解压目录调整,示例为 linux-amd64
cp "/tmp/ur-cli-${PLATFORM}/linux-amd64/bin/"ur-* "$BIN_DIR/"
# 验证
ls "$BIN_DIR"/ur-*3.2 Windows(Git Bash / WSL):
BIN_DIR="$HOME/bin"
mkdir -p "$BIN_DIR"
cp "/tmp/ur-cli-${PLATFORM}/windows-amd64/bin/"*.exe "$BIN_DIR/"
ls "$BIN_DIR/"*.exe期望输出:看到 ur, ur-iot, ur-console, ur-org-manage, ur-org-energy, ur-platform-manage(Linux/macOS)或对应的 .exe 文件(Windows)。
Step 4: 配置登录(AI 分步模式)
setup 命令是终端交互式的,在 AI 聊天环境中无法使用。唯一可行的配置方式是设备授权流:
4.1 第 1 步 — 获取授权 URL:
ur-iot login --no-wait --json期望输出示例:
{
"verification_url": "https://console.unitedrhino.com/user/access-tokens?setup=ABC12345",
"setup_code": "ABC12345",
"expires_in": 600,
"hint": "在浏览器中打开 verification_url 完成授权,然后执行: login --setup-code ABC12345"
}AI 解析 JSON,提取 verification_url,向用户展示并说明操作步骤。
4.2 用户浏览器操作:
- 在浏览器中打开
verification_url - 进入控制台「访问令牌」页面
- 点击「创建访问令牌」(描述已自动填入绑定码)
- 点击「完成 CLI 绑定」
- 显示「CLI 绑定成功」后关闭页面
4.3 第 2 步 — 完成授权(用户确认已完成后执行):
ur-iot login --setup-code ABC12345 --json期望输出示例:
{
"event": "authorization_complete",
"tenant_code": "t1",
"access_key": "ak_xxxxxxxx",
"access_secret": "sk_xxxxxxxx"
}配置自动保存到 ~/.ur/config.json。
Step 5: 安装 skills
根据 Step 1 检测到的 Claw 类型,复制对应文件:
5.1 OpenClaw(只需要 SKILL.md):
if [ -n "$OPENCLAW_ROOT" ]; then
TARGET="$OPENCLAW_ROOT/skills"
mkdir -p "$TARGET"
# 注意:根据实际解压目录调整,示例为 linux-amd64
cp "/tmp/ur-cli-${PLATFORM}/linux-amd64/skill/"*/SKILL.md "$TARGET/"
echo "OpenClaw skills installed"
fi5.2 PicoClaw(需要完整目录,含 invoke.sh + _meta.json):
if [ -d "$PICOCLAW_ROOT/skills" ]; then
for skill_dir in "/tmp/ur-cli-${PLATFORM}/linux-amd64/skill/"ur-*; do
if [ -d "$skill_dir" ]; then
name=$(basename "$skill_dir")
rm -rf "$PICOCLAW_ROOT/skills/$name"
cp -r "$skill_dir" "$PICOCLAW_ROOT/skills/$name"
echo "PicoClaw skill installed: $name"
fi
done
fi5.3 Hermes:
mkdir -p "$HERMES_ROOT"
for skill_dir in "/tmp/ur-cli-${PLATFORM}/linux-amd64/skill/"ur-*; do
if [ -d "$skill_dir" ]; then
name=$(basename "$skill_dir")
rm -rf "$HERMES_ROOT/$name"
cp -r "$skill_dir" "$HERMES_ROOT/$name"
echo "Hermes skill installed: $name"
fi
doneStep 6: 验证
6.1 验证 CLI 可执行:
ur-iot check期望输出:显示连接成功信息。
6.2 验证 PicoClaw 识别 skill:
picoclaw skills list 2>/dev/null | grep -E "ur-iot|ur-platform-manage" || true期望输出:包含 ur-iot、ur-platform-manage 等 skill 名称。
6.3 验证 skill 文件完整:
ls ~/.picoclaw/workspace/skills/ur-iot/ 2>/dev/null || true期望输出:SKILL.md invoke.sh _meta.json .skill-origin.json swagger-index.md 等文件。
人类手动安装(非 AI 环境)
如果您在本地终端直接操作,不需要 AI 代理,可以使用更简单的阻塞模式:
一键登录(阻塞模式)
ur-iot login流程:
- 选择平台地址(或
--base-url https://api.example.com跳过) - CLI 显示授权 URL
- 您在浏览器中完成授权
- CLI 自动轮询检测到完成,保存配置
- 验证连接
手动配置(编辑配置文件)
# 编辑 ~/.ur/config.json
cat > ~/.ur/config.json <<'EOF'
{
"currentProfile": "default",
"profiles": {
"default": {
"baseURL": "https://api.unitedrhino.com",
"appID": "77",
"tenantCode": "t1",
"accessKey": "ak_xxxxxxxxxxxxxxxx",
"accessSecret": "sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
EOF常用命令
# 查看当前用户信息
ur-iot api /api/v1/system/user/self/get-one
# 列出租户下所有设备
ur-iot api /api/v1/things/device/info/get-list --body '{"page":{"page":1,"size":10}}'
# 查看 API schema
ur-iot schema
# 查看 token
ur-iot token --decode启动 OpenClaw Gateway
配置完成后,启动 OpenClaw Gateway:
openclaw gateway --port 18789保持 Gateway 运行,即可通过 WhatsApp / Telegram / Discord 等渠道与联犀平台交互。
常见问题
Q: 绑定码过期了怎么办?
绑定码有效期为 10 分钟。如果超时,请重新运行 ur-iot login --no-wait --json 生成新的绑定码。
Q: 私有化部署的地址格式是什么?
请输入完整的 API 地址,例如 https://my-saas.company.com 或 http://192.168.1.100:7777。使用 --base-url 参数指定。
Q: 可以同时绑定多个 CLI 实例吗?
可以。每个 CLI 实例独立管理自己的配置文件,互不影响。
Q: 访问令牌过期后怎么办?
访问令牌过期后,所有使用该令牌的 API 调用将失败。请重新运行 ur-iot login 创建新令牌。
Q: 如何撤销 CLI 绑定?
在控制台「访问令牌」页面删除对应的访问令牌即可。删除后 CLI 将无法继续调用 API。
Q: 如何确认 skill 已正确安装?
# PicoClaw
picoclaw skills list
# OpenClaw
ls ~/.npm-global/lib/node_modules/openclaw/skills/ur-iot/SKILL.md
# Hermes
ls ~/.hermes/skills/ur-iot/SKILL.md更新日志
2026/5/11 22:24
查看所有更新日志
ba947-docs(openclaw): 产物下载地址从官网改为 GitHub/Gitee Release于f3ca6-docs: 提交未追踪文件于
