Ani2の
Ani2の
发布于 2026-02-05 / 6 阅读
0
0

🦞 OpenClaw 域名访问配置指南 (基于 1Panel)

本文档将指导你如何通过 1Panel 面板配置反向代理,为 OpenClaw 绑定独立域名,并完成首次连接的安全配对。

📋 1. 准备工作

在开始之前,请确保:

  • OpenClaw 已启动:在服务器上运行正常,默认端口通常为 18789。

  • 域名解析:你的域名(例如 www.aaaa.com)的 A 记录已指向服务器 IP。

  • 1Panel 面板:已安装并在运行中。


🛠️ 2. 配置反向代理 (1Panel)

我们需要让 Nginx 接管域名的流量,并转发给本地的 OpenClaw 服务。

  1. 登录 1Panel 面板。

  2. 点击左侧菜单 「网站」 -> 点击蓝色按钮 「创建网站」。

  3. 关键设置(请严格按照下图配置):

    • 类型:点击顶部的 「反向代理」 标签(不要选默认的"运行环境")。

    • 主域名:填写你的域名,如 www.aaaa.com。

    • 代理地址:填写 127.0.0.1:18789 (确保端口与 OpenClaw 实际端口一致)。

  4. 点击 「确认」 创建。

💡 原理:此时访问你的域名,Nginx 会悄悄把请求递给本机的 OpenClaw,用户感觉不到中间发生了跳转。


🔒 3. 开启 HTTPS (强烈建议)

OpenClaw 使用 WebSocket 通信,为了连接稳定和安全,强烈建议开启 HTTPS。

  1. 在网站列表中找到刚创建的网站,点击 「配置」。

  2. 选择顶部菜单 「HTTPS」。

  3. 勾选 「启用 HTTPS」。

  4. 证书申请:

    选择 ACME 账户*(如果没有就新建一个)。

    SSL 服务商推荐选择 Let's Encrypt* 或 ZeroSSL。

  5. 点击 「申请并保存」。

等待几秒钟,看到“证书申请成功”后,你的网站就带上了一把安全的小锁头 🔒。


🛡️ 4. 关键步骤:设备安全配对 (必读!)

⚠️ 注意:这一步最重要!很多人配置完域名打不开,都是因为卡在这里。

现象

当你第一次在浏览器访问 https://www.aaaa.com 时,你会发现:

  • 网页能打开,能看到 OpenClaw 的 Logo。

但是右上角显示红色 *Disconnected (未连接)**。

或者提示 *"Pairing Required" (需要配对)**。

为什么会这样?

OpenClaw 采用 零信任安全架构 (Zero Trust)。

即使通过了 Nginx 反代,OpenClaw 核心服务依然不信任任何陌生的浏览器或设备。为了防止未授权的控制,每一个新的连接设备(浏览器)都必须经过管理员的显式批准

✅ 解决步骤

保持浏览器页面打开(不要关闭),回到 服务器终端(SSH),执行以下命令:

第一步:查看等待批准的请求


openclaw devices list

输出示例:


Pending (1)

┌──────────────────────────────────────┬──────────┐

│ Request                              │ Role     │

├──────────────────────────────────────┼──────────┤

│ 01b2cbb2-87f9-44a2... (这里是ID)     │ operator │

└──────────────────────────────────────┴──────────┘

你会看到一个 Pending (待定) 的请求,这就是你刚才那个浏览器发起的。

第二步:批准请求

复制上面的 Request ID,执行批准命令:


# 语法: openclaw devices approve <Request_ID>

openclaw devices approve 01b2cbb2-87f9-44a2...

第三步:连接成功

回到浏览器,刷新页面

此时右上角状态应变为绿色的 Connected*。

  • 系统会下发一个长期的 Access Token 给该浏览器,以后再访问无需再次批准。

🦊 Yoyo 的小贴士

  • Token 获取:如果 Dashboard 提示需要输入 Token,可以在终端输入 cat /root/.openclaw/openclaw.json 查看 gateway.auth.token 字段。

  • 多设备管理:如果你换了台电脑或手机访问,需要重复 步骤 4 进行批准。这是为了你的安全!


评论