重命名 openclawai 设备有四种方法：一、修改系统主机名并重启网关服务；二、通过 cli 设置设备别名（推荐）；三、手动编辑 openclaw.json 配置文件；四、清除注册信息后重新配对。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 OpenClawAI 时发现设备在 WebUI 或设备管理列表中显示的名称与实际物理设备不符，或需统一命名规范以方便多设备协同管理，则可能是由于主机名未同步更新或设备标识未手动设定所致。以下是重命名 OpenClawAI 设备的多种操作方法：
一、修改系统主机名并触发设备同步
OpenClawAI 在启动时会读取操作系统主机名作为默认设备标识，因此修改底层系统主机名可使设备在网关服务重启后自动采用新名称。该方法适用于 Linux/macOS 及 Windows 系统，且影响全局系统标识。
1、在 Linux/macOS 终端中执行：sudo hostnamectl set-hostname your-new-device-name
2、编辑 /etc/hosts 文件，将原主机名对应行（如 127.0.0.1 old-hostname）替换为新主机名。
3、重启 OpenClaw 网关服务：bash clawdbot gateway restart
4、等待约 15 秒后，在 WebUI 的「设备管理」页面刷新查看设备名称是否已更新。
二、通过 CLI 直接设置设备别名（推荐）
OpenClaw 提供了独立于系统主机名的设备别名机制，该别名优先级高于系统主机名，且不依赖系统级权限，适合快速、安全地重命名单个设备。
1、在终端中运行命令查询当前设备 ID：openclaw devices list
2、从输出中识别目标设备的 ID（形如 dev_abc123）和当前 alias 字段值。
3、执行重命名命令：openclaw devices alias dev_abc123 "MyOfficeAI-Node1"
4、确认返回结果含 ✅ Alias updated 提示。
5、刷新 WebUI 设备列表，新别名将在「设备名称」列中立即生效。
三、手动编辑配置文件强制覆盖设备标识
当 CLI 命令不可用或设备处于离线状态时，可通过直接修改本地配置文件设定设备名称。该方法绕过运行时校验，适用于紧急修复场景，但需确保服务未运行以避免配置被覆盖。
1、停止网关服务：bash clawdbot gateway stop
2、定位并打开配置文件：~/.openclaw/openclaw.json（Linux/macOS）或 %USERPROFILE%\.openclaw\openclaw.json（Windows）。
3、在 JSON 根对象中查找或新增 "device" 字段，设置如下结构：
"device": {"name": "MyDesktopAI", "id": "dev_abc123"}
4、保存文件，确保 JSON 格式合法（无逗号遗漏、引号闭合）。
5、重新启动服务：bash clawdbot gateway start
四、重置设备注册信息并重新配对
若设备名称异常源于重复注册、ID 冲突或配对残留，可清除设备注册记录后重建唯一标识。该方法将使设备在下一次连接时生成全新 ID 并允许首次命名。
1、执行设备注销命令：openclaw devices remove dev_abc123
2、删除本地设备元数据目录：rm -rf ~/.openclaw/devices/（Linux/macOS）或 rd /s /q "%USERPROFILE%\.openclaw\devices"（Windows PowerShell）。
3、重启网关服务：bash clawdbot gateway restart
4、在 WebUI 中访问 http://[IP]:18789/?token=xxx，触发设备首次配对流程，并在配对表单中输入期望的设备名称。
