文档SDK

快速上手

参考手册

Nexting 开发者文档 | 2026 年 8 月

iPhone 应用

配对夹子

步骤操作
1打开 Nexting 夹子电源。LED 灯会依次闪烁红色 → 绿色 → 蓝色，然后进入红色慢闪状态（等待连接）。
2打开 Nexting 应用。应用会自动扫描附近的设备。
3点击你的设备进行配对。连接成功后 LED 灯变为蓝色常亮。
4按住 PTT（按键对讲）按钮并说话。

语音处理流程

当你按下夹子上的 PTT 按钮时：

步骤发生了什么
1夹子采集音频并通过 BLE 将其传输到 iPhone。
2iPhone 在本地录制音频，然后发送到 Nexting 云端 STT 服务（Whisper）进行转录。
3转录后的文字通过统一 WebSocket 发送到 AI 模型。录音会保留在你的 iPhone 本地，用于回放和历史记录。
4AI 处理消息并返回回复。
5回复显示在屏幕上，并通过 TTS 语音播报。
音频被发送到 Nexting 云端转写（火山流式与 Whisper 文件兜底）。定稿有字的录音会进入语音 History，最多保留 30 天，可回放或删除。空识别不保存。详见隐私政策。

应用标签页

标签页说明
首页与 AI 助手语音交互，以及你的 Claude Code / Codex / Grok / Cursor 会话收件箱。
对话对话：当前模式下的文字与语音聊天（Nexting AI、Claude Code、Codex、Grok、Cursor、MyOpenClaw、MyHermes）。
设置连接模式、技能、设备、账户和偏好设置。

身份认证

系统使用三层身份认证，每层在连接时验证一次：

层级谁 → 哪里方式用途
1iPhone → 云端服务器Supabase JWT识别用户账户。
2插件 → 云端服务器Relay 令牌（/relay/connect）识别 OpenClaw 实例。
3Relay → 本地插件Auth 令牌（WS auth 消息）认证本地插件连接。
Auth Message (Layer 3)
{ "type": "auth", "deviceId": "relay-client", "token": "<authToken>" }

云端服务器返回 auth_ok，其中包含当前插件的连接状态：

auth_ok Response
{ "type": "auth_ok", "deviceId": "relay-client", "pluginConnected": true }

CLI 登录

如果你运行自己的 OpenClaw 实例，openclaw pinclaw login 命令可以自动完成整个设置流程。它会打开浏览器登录 nexting.ai（也可以用 --email/--password 在终端登录），写入 Relay 配置，并提示你用 openclaw gateway run 重启网关。

Terminal
openclaw pinclaw login    # sign in, auto-configure relay, restart gateway
openclaw pinclaw status   # check current relay config
openclaw pinclaw logout   # remove relay config

你的 iPhone（使用同一账户登录）将自动连接。

插件状态

云端服务器跟踪插件的连接状态，并实时将状态变化推送到已连接的 iPhone：

Plugin Status Push
{ "type": "plugin_status", "connected": true }

当插件断开连接时，iPhone 应用会显示离线横幅。

定时提醒

让你的 AI 助手设置提醒。通过 OpenClaw 定时任务系统管理。

你说的话会发生什么
"30 分钟后提醒我喝水"一次性提醒，30 分钟后触发，通过 TTS 语音播报。
"每小时提醒我做拉伸"周期性任务，每 60 分钟触发一次，直到取消为止。
"明天早上 7 点叫我起床"指定绝对时间的一次性提醒。

如果设备离线，消息会在云端排队，并在重新连接时发送（排队消息 24 小时后过期）。

开发者指南

本地开发

Terminal
# Clone the repo
git clone https://github.com/Nexting-ai/nexting.git
cd nexting

# Install dependencies
cd plugin && npm install

# Start the standalone dev server (no OpenClaw needed)
npx tsx standalone.ts

独立服务器在端口 18790 上运行插件 WebSocket，并直接连接 AI 后端——适合在没有完整 OpenClaw 环境的情况下进行测试。

环境变量

变量默认值说明
WS_PORT18790插件 WebSocket 服务器端口。
AUTH_TOKENpinclaw-dev-token-2026开发用设备认证令牌。
FALLBACK_AI_KEY(none)独立模式的 AI API 密钥（绕过 Gateway）。

项目结构

Repository Layout20 lines
nexting/
├── plugin/                    # OpenClaw channel plugin
│   ├── index.ts               # Plugin entry point
│   ├── openclaw.plugin.json   # Plugin manifest
│   ├── standalone.ts          # Dev server (no OpenClaw)
│   └── src/
│       ├── channel.ts         # Channel adapters
│       ├── types.ts           # TypeScript types

从本地路径加载插件

开发过程中，可以直接从你的克隆目录加载插件：

~/.openclaw/openclaw.json
{
  "plugins": {
    "load": {
      "paths": ["/path/to/pinclaw/plugin"]
    },
    "entries": {
      "pinclaw": { "enabled": true }
    }
  }
}

然后正常启动网关：openclaw gateway run。插件将从你的本地目录加载，重启后即可生效。