快速上手

参考手册

Nexting 开发者文档 | 2026 年 8 月

iPhone 应用

配对夹子

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

语音处理流程

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

步骤	发生了什么
1	夹子采集音频并通过 BLE 将其传输到 iPhone。
2	iPhone 在本地录制音频，然后发送到 Nexting 云端 STT 服务（Whisper）进行转录。
3	转录后的文字通过统一 WebSocket 发送到 AI 模型。录音会保留在你的 iPhone 本地，用于回放和历史记录。
4	AI 处理消息并返回回复。
5	回复显示在屏幕上，并通过 TTS 语音播报。

音频被发送到 Nexting 云端转写（火山流式与 Whisper 文件兜底）。定稿有字的录音会进入语音 History，最多保留 30 天，可回放或删除。空识别不保存。详见隐私政策。

应用标签页

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

身份认证

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

层级	谁 → 哪里	方式	用途
1	iPhone → 云端服务器	Supabase JWT	识别用户账户。
2	插件 → 云端服务器	Relay 令牌（`/relay/connect`）	识别 OpenClaw 实例。
3	Relay → 本地插件	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 }

如果你运行自己的 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_PORT`	18790	插件 WebSocket 服务器端口。
`AUTH_TOKEN`	pinclaw-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。插件将从你的本地目录加载，重启后即可生效。