名称： ecto-connection
版本： 1.0.0
描述： 通过 Tailscale Funnel 将 OpenClaw 连接到互联网。当用户说“connect with ecto”、“setup ecto connection”、“expose openclaw publicly”或“enable external access”时使用。
元数据：
openclaw:
emoji: "🔌"
author: "OpenClaw"
commands:
- connect
- status
- disconnect

Ecto 连接技能

一键配置，通过 Tailscale Funnel 安全地将 OpenClaw 暴露到公网。

功能概述

1. 安装 Tailscale（如未安装）
2. 使用您的 Tailscale 账户进行身份验证
3. 以适当权限启动 Tailscale 服务
4. 启用 Funnel 以公开暴露端口 18789
5. 配置 OpenClaw，设置安全认证令牌并启用所有 API 端点
6. 重启网关以应用新设置

使用方法

当用户说“connect with ecto”或类似指令时，运行：

~/.openclaw/workspace/skills/ecto-connection/scripts/connect.sh

可用命令

连接（完整设置）：

./scripts/connect.sh

检查状态：

./scripts/status.sh

断开连接（禁用 Funnel）：

./scripts/disconnect.sh

输出结果

成功运行后，脚本将输出：
- 公共 URL：https://<machine>.tail<xxxxx>.ts.net/v1/chat/completions
- 用于 API 访问的认证令牌
- 示例 curl 命令

前置要求

• 安装 Homebrew 的 macOS 系统
• Tailscale 账户（可在 tailscale.com 免费注册）
• sudo 权限（用于管理 Tailscale 服务）

安全性说明

• 生成加密随机的 32 字节认证令牌
• 所有 API 请求均需提供 Bearer 令牌
• Funnel 使用 Tailscale 的自动 TLS 证书
• 网关绑定到本地回环地址（仅能通过 Funnel 访问）

设置完成后

使用 OpenAI 兼容的 API：

curl https://<your-url>/v1/chat/completions \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Hello!"}]}'

故障排除

Funnel 无法工作？
- 确保已在您的 Tailnet 中启用 Funnel：https://login.tailscale.com/admin/machines
- 运行检查命令：tailscale funnel status

认证错误？
- 令牌文件位于：~/.openclaw/ecto-credentials.json
- 重新生成令牌：./scripts/connect.sh --regenerate-token

网关无响应？
- 查看日志：cat /tmp/openclaw-gateway.log
- 重启服务：./scripts/connect.sh --restart