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"
fi

5.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
fi

5.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
done

Step 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于 2026/5/11
f3ca6-docs: 提交未追踪文件于 2026/5/11

基本概念

物模型

联犀协议

AI交互

第三方协议

网关接入