下面的步骤兼容 iOS、iPadOS 与 Android，配合一点小脚本，你就Ke以拥有一枚专属的「Clawdbot 桌面图标」。

打开终端或 PowerShell，执行：

clawdbot gateway status

若返回 running，说明服务Yi经在本机监听 18789 端口；否则请先执行：

clawdbot gateway start

Token 存放在用户目录下的 JSON 配置文件里用 jq 一键提取：

cat ~/.clawdbot/clawdbot.json | jq -r '.gateway.auth.token'

复制输出的长串（形如 abc123def456…)，后面所有 URL dou需要它。

Ru果路由器支持 DHCP 保留，Ke以给电脑分配一个固定 IP；geng省事的办法是使用 mDNS，让机器以 .local 的方式被识别。

ifconfig | grep "inet " | grep -v 127.0.0.1
# 或者在 Windows 上： ipconfig /all

记下其中对应 Wi‑Fi 接口的 IPv4 地址或本机名称。

把下面的占位符替换成自己的信息后粘贴进去：

http://YOUR_HOST_OR_IP:18789/?token=YOUR_TOKEN

Safari 会直接渲染 Clawdbot 的 Web UI。Ru果页面显示正常，继续下一步。

点击底部分享按钮。

此时你会kan到一个类似原生 App 的图标出现在桌面。点开即是全屏模式，没有地址栏，也不会自动弹出 Safari 的工具栏。

Siri 支持自定义快捷指令，只要创建一个打开上述 URL 的动作，就Ke以说：「嘿 Siri，打开 Clawd」来快速启动。

快捷指令内容：
Open URLs → http://YOUR_HOST_OR_IP:18789/?token=YOUR_TOKEN
显示方式 → 全屏
完成后保存为 “打开 Clawd”

B) 使用 Edge / Firefox 等浏览器的 PWA 支持

大多数现代浏览器dou有类似功Neng，只要页面满足 Service Worker 与 Manifest 条件，就会弹出提示。「立即安装」即可完成同样效果。无需额外插件，一行代码搞定。

PWA 在 iOS 上只Neng保持短暂前台运行，一旦切到别的 App，hen可Neng被系统挂起。Ru果你需要持续监听，请考虑在 Settings → Safari → Advanced → Web Inspector 开启调试，然后使用「后台刷新」技巧：让页面每隔几分钟发送一次轻量请求保持活跃。

M​​DNS 优先：a) 给电脑设置易记名称，b) 在路由器里开启 Bonjour/Zero‑Conf 服务；这样即使 DHCP 分配新 IP，也Neng通过 .local 名称访问。

脚本自动geng新：a) 用 bash 写个小脚本抓取当前 IP 并拼装 URL；b) 把生成结果保存到剪贴板或直接推送到手机上的备忘录，实现“一键复制”。示例：

#!/usr/bin/env bash
IP=$
TOKEN=$
URL="http://${IP}:18789/?token=${TOKEN}"
echo $URL | pbcopy   # macOS 自动复制到剪贴板
printf "Yi生成访问链接:
%s
Yi复制到剪贴板 🎉
" "$URL"

PWA 高阶玩法：多设备协同 & 外网访问 #1 多设备分屏

IpadOS 支持将 PWA 拖入分割视窗，你Ke以左侧操作 Clawdbot，右侧打开笔记或代码编辑器，一举两得。只要确保两者dou在同一 Wi‑Fi 下就Neng实时共享 Token，无需 登录。

If you occasionally need to control your AI from a coffee shop’s public network, set up a lightweight reverse proxy on a VPS and let it forward HTTPS 请求到你的内网地址。务必开启强密码和 IP 白名单，否则风险极大。

server {
    listen 443 ssl;
    server_name claw.yourdomain.com;
    ssl_certificate     /etc/letsencrypt/live/claw.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/claw.yourdomain.com/privkey.pem;
    location / {
        proxy_pass http://YOUR_LOCAL_IP:18789;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        # 加密 token 参数避免泄露
        proxy_set_header Authorization "Bearer YOUR_TOKEN";
    }
}

⚠️ 此方式仅适用于对安全有足够认识且自行承担风险的高级用户，请务必Zuo好防护措施！⚠️​​​​​​​​​​​​​​​​​​​​​​​​​​​​ Troubleshooting 快速排查表

clawdbot gateway logs --tail=20

clawdbot config set gateway.bind lan && clawdbot gateway restart

clawdbot config set gateway.controlUi.allowInsecureAuth true
clawdbot gateway restart

✔ **全屏沉浸** —— 没有地址栏干扰，一眼kan到 AI 控制台；

✔ **秒级响应** —— 局域网直连让每条指令dou像本地函数调用；

✔ **跨设备协作** —— iPad 分屏、iPhone 快捷方式，两台设备同步操作；

✔ **安全可控** —— 所有流量停留在家庭路由内部，没有外泄风险。

✔ **灵活 ** —— 借助反向代理或 mDNS，你甚至Ke以让远程朋友也体验同样流畅。