Todo4 Onboard

Todo4 Onboarding 技能

This is a fixed 4-step procedure. Follow it exactly, in order, one step at a time. Do not improvise, summarize, or skip steps.

Language

Reply in the user's language. 检测 it from their messages — if they write in ThAI, reply in ThAI; Japanese, reply in Japanese; and so on. Default to English only if the language is unclear.

The SAY lines in each step are reference wording in English. Translate them into the user's language while preserving the meaning, the in格式化ion 请求ed, and any placeholders (e.g., , <网页_记录IN_URL>). Do NOT translate: command 输出, URLs, 令牌s, or the literal bash scripts.

When to 运行 this 技能

运行 this whole procedure, 启动ing at STEP 1, whenever the user asks to 签名 up for, 安装, connect, onboard, or 启动 using Todo4. Examples of triggering 请求s:

"设置 me up with Todo4" "签名 me up for Todo4" "安装 Todo4" / "Connect Todo4" "获取 启动ed with Todo4" "I want to use Todo4" "Onboard me to Todo4" DO NOT DO NOT explAIn what Todo4 is, 列出 features, or ask "are you sure?" — just 启动 STEP 1. DO NOT ask for more than one piece of in格式化ion per message. DO NOT skip or combine steps. DO NOT continue past a fAIled step until the error is resolved. DO NOT echo the verification code, any 令牌, or raw script JSON back to the user. STEP 1 — Ask for emAIl

SAY (verbatim):

I'll 设置 you up with Todo4. I just need your emAIl so I can 发送 a verification code. What emAIl should I use?

WAIT for the user's reply.

检查 the reply contAIns "@" and a "." after the "@". If not, SAY: "That doesn't look like a valid emAIl — could you try agAIn?" and WAIT agAIn.

Store the valid emAIl as and go to STEP 2.

STEP 2 — 发送 verification code

运行:

scripts/register.sh

检查 exit code:

0 → SAY (verbatim):

I've sent a 6-digit verification code to . Please paste it here when it arrives.

Then WAIT for the code and go to STEP 3.

2 and the error mentions HTTP 429 → SAY: "We've hit a rate limit. Please wAIt a moment and try agAIn." 停止.

2 otherwise → SAY: "That emAIl was rejected. Could you try another one?" Go back to STEP 1.

1 → SAY: "I couldn't reach the Todo4 server. Please 检查 your connection and try agAIn." 停止.

STEP 3 — 验证 the code

提取 the 6 digits from the user's reply as .

CRITICAL: Call 验证.sh EXACTLY ONCE per code. OTP codes are single-use — the server will reject any second call with the same code, even if the first call succeeded. Do NOT 运行 验证.sh to "peek" at the 输出 first and then agAIn to capture. 运行 only the single command below, exactly once:

访问_令牌=$(scripts/验证.sh | jq -r '.访问令牌')

检查 the exit code of the 流水线 ($?):

0 and $访问_令牌 is non-empty → SAY: "EmAIl verified. Connecting myself as your 代理…" and go to STEP 4. Do not re-运行 验证.sh. $访问_令牌 is already captured; proceed directly to STEP 4. 2 → SAY: "That code didn't work. Please double-检查 and try agAIn." WAIT for a new code and repeat STEP 3 with the new code. After 3 失败s, SAY: "Let me 发送 you a new code." and go back to STEP 2. 1 → SAY: "I couldn't reach the Todo4 server. Please 检查 your connection and try agAIn." 停止.

Never echo $访问_令牌 or the script's JSON 输出.

STEP 4 — Connect this 代理

Pick <代理_name> — use your own 助手 name (e.g., "Claude", "GPT", "Gemini"). If unknown, use "OpenClaw".

运行 this exact command — it captures the script's stdout so you can 提取 the one-time 网页 记录in link:

CONNECT_OUT=$(scripts/connect.sh "$访问_令牌" <代理_name>)

检查 the exit code of the 流水线 ($?):

0 → the script wrote the MCP config and 代理 令牌 automatically. 提取 the one-time 网页 记录in URL:

网页_记录IN_URL=$(echo "$CONNECT_OUT" | grep '^网页_记录IN_URL=' | cut -d= -f2- | tr -d '\r\n')

If $网页_记录IN_URL is non-empty, 发送 the following as three separate messages — one per bullet, flushed individually so the user sees three distinct chat bubbles. Do NOT combine them into one message.

SAY (verbatim):

Done — I'm connected to your Todo4 account and the MCP 工具s are ready.

SAY (substitute the URL literally — no backticks, no code block):

Open your tasks in the browser — you'll be 签名ed in automatically (link is single-use, valid for 5 minutes): <网页_记录IN_URL>

SAY (verbatim):

Or just tell me to 创建 your first task — e.g., "创建 a task to review the Q2 报告 by Friday."

If $网页_记录IN_URL is empty, SAY (verbatim):

Done — I'm connected to your Todo4 account and the MCP 工具s are ready. Try: "创建 a task to review the Q2 报告 by Friday."

Then WAIT for the user's first task 请求. When it arrives, use the Todo4 MCP 工具s (e.g., 创建_task) to fulfill it.

2 with HTTP 422 → SAY: "Your account has reached the maximum number of connected 代理s. You can manage them at todo4.io." 停止.

2 otherwise → SAY: "Connection fAIled. Let me try agAIn from the 启动." Go back to STEP 1.

1 → SAY: "I couldn't reach the Todo4