LaunchThat OpenClaw Connector
Deprecated: this skill is being phased out.
Use @launchthatbot/connect-openclaw-plugin instead.
When to use this skill
Use this skill when you need to:
- - connect an existing OpenClaw VPS to LaunchThatBot,
- configure secure ingest token + request signing,
- validate heartbeat/ingest/replay behavior,
- troubleshoot connection, auth, or payload issues.
Do not use this skill for:
- - deploying OpenClaw infrastructure,
- managing unrelated bot runtime logic,
- reading local secrets outside explicitly provided token/secret inputs.
Security boundaries
- - Outbound-only network calls to LaunchThatBot API endpoints.
- No shell execution from connector runtime.
- No arbitrary filesystem reads (only explicit token/secret files and optional queue file).
- Canonical event schema only (
agent_status_changed, agent_moved_room, task_started, task_completed, room_updated). - Optional HMAC request signing with timestamp skew checks.
Source-of-truth policy
- - Connector implementation changes must be made in this monorepo package:
packages/launchthat-openclaw-connector. - The mirrored
launchthatbot/connect repo is a distribution mirror, not a primary authoring surface. - Use the sync workflow/runbook to propagate updates and avoid multi-writer divergence.
Quick setup workflow
- 1. Create auth link:
CODEBLOCK0
- 2. Open returned
authUrl, capture:
-
instanceId
- INLINECODE10
- 3. Export secrets:
CODEBLOCK1
- 4. Run connector:
CODEBLOCK2
Operational checks
- - Heartbeat endpoint returns
200. - Ingest endpoint returns
ok: true. - Replay endpoint returns recent events.
- LaunchThatBot dashboard reflects active connected instance.
Common troubleshooting
- - 401 Invalid token: refresh callback and rotate ingest token.
- 401 Invalid request signature: verify
OPENCLAW_SIGNING_SECRET and clock skew. - 429 Rate limit exceeded: reduce burst size/retry cadence.
- No UI updates: verify replay endpoint contains events for current instance/workspace.
Additional resources
LaunchThat OpenClaw 连接器
已弃用:此技能正在逐步淘汰。
请改用 @launchthatbot/connect-openclaw-plugin。
何时使用此技能
在以下情况下使用此技能:
- - 将现有的 OpenClaw VPS 连接到 LaunchThatBot,
- 配置安全的摄取令牌 + 请求签名,
- 验证心跳/摄取/重放行为,
- 排查连接、认证或负载问题。
请勿在以下情况下使用此技能:
- - 部署 OpenClaw 基础设施,
- 管理无关的机器人运行时逻辑,
- 读取明确提供的令牌/密钥输入之外的本地机密。
安全边界
- - 仅向 LaunchThatBot API 端点发起出站网络调用。
- 连接器运行时禁止执行 shell 命令。
- 禁止任意文件系统读取(仅允许明确的令牌/密钥文件和可选的队列文件)。
- 仅支持规范事件模式(agentstatuschanged、agentmovedroom、taskstarted、taskcompleted、room_updated)。
- 可选的 HMAC 请求签名,带时间戳偏差检查。
数据源策略
- - 连接器实现变更必须在此单体仓库包中进行:packages/launchthat-openclaw-connector。
- 镜像仓库 launchthatbot/connect 是分发镜像,而非主要创作平台。
- 使用同步工作流/操作手册传播更新,避免多写入者冲突。
快速设置工作流
- 1. 创建认证链接:
bash
lt-openclaw-connect auth-link \
--base-url=https://app.launchthatbot.com \
--workspace-id=default \
--instance-name=my-openclaw
- 2. 打开返回的 authUrl,获取:
- instanceId
- ingestToken
- 3. 导出密钥:
bash
export LAUNCHTHATINGESTTOKEN=
export LAUNCHTHATSIGNINGSECRET=
- 4. 运行连接器:
bash
lt-openclaw-connect run \
--base-url=https://app.launchthatbot.com \
--workspace-id=default \
--instance-id=
运行检查
- - 心跳端点返回 200。
- 摄取端点返回 ok: true。
- 重放端点返回最近事件。
- LaunchThatBot 仪表盘反映已连接的活跃实例。
常见故障排查
- - 401 无效令牌:刷新回调并轮换摄取令牌。
- 401 无效请求签名:验证 OPENCLAWSIGNINGSECRET 和时钟偏差。
- 429 超出速率限制:降低突发大小/重试频率。
- 无 UI 更新:验证重放端点包含当前实例/工作空间的事件。
其他资源