[OpenClaw 文档]参考--RPC 与 API

本文档汇总了 OpenClaw 官方文档站 参考 > RPC 与 API 子模块下的全部 2 篇内容，源自 docs.openclaw.ai/zh-CN。

📄 RPC 适配器

原文：https://docs.openclaw.ai/zh-CN/reference/rpc

OpenClaw 通过 JSON-RPC 集成外部 CLI。目前使用两种模式。

模式 A：HTTP 守护进程（signal-cli）

• signal-cli 作为守护进程运行，通过 HTTP 提供 JSON-RPC。
• 事件流是 SSE（/api/v1/events）。
• 健康探针：/api/v1/check。
• 当 channels.signal.autoStart=true 时，OpenClaw 拥有生命周期管理。

请参阅 Signal 了解设置和端点。

模式 B：标准输入/输出子进程（imsg）

• OpenClaw 为 iMessage 将 imsg rpc 作为子进程启动。
• JSON-RPC 通过 stdin/stdout 按行分隔传输（每行一个 JSON 对象）。
• 不需要 TCP 端口，也不需要守护进程。

使用的核心方法：

• watch.subscribe → 通知（method: "message"）
• watch.unsubscribe
• send
• chats.list（探针/诊断）

请参阅 iMessage 了解旧版设置和寻址（推荐使用 chat_id）。

适配器指南

• Gateway 网关拥有该进程（启动/停止绑定到提供商生命周期）。
• 保持 RPC 客户端有韧性：超时、退出时重启。
• 优先使用稳定 ID（例如 chat_id），而不是显示字符串。

相关

• Gateway 网关协议

📄 设备型号数据库

原文：https://docs.openclaw.ai/zh-CN/reference/device-models

macOS 配套应用会在 Instances UI 中显示友好的 Apple 设备型号名称，方法是将 Apple 型号标识符（例如 iPad16,6、Mac16,6）映射为人类可读的名称。

该映射以 JSON 形式内置在以下位置：

• apps/macos/Sources/OpenClaw/Resources/DeviceModels/

数据来源

我们当前从以下 MIT 许可仓库内置该映射：

• kyle-seongwoo-jun/apple-device-identifiers

为了保持构建的确定性，这些 JSON 文件被固定到特定的上游提交（记录在 apps/macos/Sources/OpenClaw/Resources/DeviceModels/NOTICE.md 中）。

更新数据库

1. 选择你要固定的上游提交（一个用于 iOS，一个用于 macOS）。
2. 更新 apps/macos/Sources/OpenClaw/Resources/DeviceModels/NOTICE.md 中的提交哈希。
3. 重新下载这些 JSON 文件，并固定到这些提交：

IOS_COMMIT="<commit sha for ios-device-identifiers.json>"
MAC_COMMIT="<commit sha for mac-device-identifiers.json>"

curl -fsSL "https://raw.githubusercontent.com/kyle-seongwoo-jun/apple-device-identifiers/${IOS_COMMIT}/ios-device-identifiers.json" \
  -o apps/macos/Sources/OpenClaw/Resources/DeviceModels/ios-device-identifiers.json

curl -fsSL "https://raw.githubusercontent.com/kyle-seongwoo-jun/apple-device-identifiers/${MAC_COMMIT}/mac-device-identifiers.json" \
  -o apps/macos/Sources/OpenClaw/Resources/DeviceModels/mac-device-identifiers.json

4. 确保 apps/macos/Sources/OpenClaw/Resources/DeviceModels/LICENSE.apple-device-identifiers.txt 仍与上游一致（如果上游许可证变更，请替换它）。
5. 验证 macOS 应用能够干净构建（无警告）：

swift build --package-path apps/macos

相关内容

• 节点
• 节点故障排除