名称： 4todo
描述： 在聊天中管理 4todo (4to.do)。捕获任务、使用艾森豪威尔矩阵进行优先级排序、重新排序、完成任务以及管理工作区中的重复任务。

4todo

4to.do 艾森豪威尔矩阵待办事项列表

目标

• 使用 curl 调用 4todo API (https://4to.do/api/v0) 来管理：
• 工作区
• 待办事项
• 重复性待办事项
• 以可注入但不泄露的方式存储令牌（推荐使用 OpenClaw 每次运行时的环境变量注入；切勿将密钥粘贴到提示词、日志或仓库文件中）。

必需的环境变量

• FOURTODO_API_TOKEN：您的 4todo API 令牌（Bearer token）
• 如果缺失，请提示用户通过 OpenClaw 配置进行设置（不要要求他们将令牌粘贴到聊天中）。

运行时要求

• curl 必须在 PATH 中可用（如果代理在沙盒容器中运行，则沙盒容器内也必须可用）。

面向用户的输出规则（重要）

• 默认使用非技术性语言。关注结果，而非实现细节。
• 避免提及：curl、端点、请求头、API 机制、JSON 负载、配置补丁。
• 仅在调试或用户明确询问“这是如何工作的？”时提及技术细节。
• 默认不打印内部 ID：
• 除非用户要求，否则不要显示 ws_...、todo_...、rec_todo_...。
• 通过名称来引用工作区和任务。
• 如果需要消除歧义（名称重复），请提出澄清问题并提供一个简短的数字编号名称列表；仅在用户请求时才提供 ID。
• 象限：
• 在聊天中，优先使用通俗语言：“紧急且重要”、“重要（不紧急）”、“紧急（不重要）”、“既不重要也不紧急”。
• 在内部 API 调用中使用 IU | IN | NU | NN。仅当用户先使用代码或明确询问时才显示代码。

示例（推荐）

工作区：

您的工作区：
1) Haoya (默认)
2) 4todo
3) Echopark

待办事项（摘要）：

紧急且重要：
1) 注销英国公司
2) Hetzner 月度付款 (重复性，每月)

重要（不紧急）：
1) 每周回顾 (重复性，每周五)

在 OpenClaw 中存储/注入令牌（推荐）

OpenClaw 可以仅在代理运行期间注入环境变量（然后恢复原始环境），这有助于防止密钥泄露到提示词中。

推荐（生产环境）：使用您托管提供商的密钥存储，在您的 Gateway 进程环境中设置 FOURTODO_API_TOKEN，并且不要将令牌存储在聊天日志中。

主机运行（非沙盒化）：使用 skills.entries

编辑 ~/.openclaw/openclaw.json：

{
  skills: {
    entries: {
      "4todo": {
        enabled: true,
        env: {
          FOURTODO_API_TOKEN: "YOUR_4TODO_API_TOKEN"
        }
      }
    }
  }
}

注意：
- 仅当变量尚未设置时，才会注入 skills.entries.<skill>.env。

沙盒化会话：使用 agents.defaults.sandbox.docker.env

当会话被沙盒化时，技能环境注入不会传播到 Docker 容器中。需要通过 Docker 环境变量提供令牌：

{
  agents: {
    defaults: {
      sandbox: {
        docker: {
          env: {
            FOURTODO_API_TOKEN: "YOUR_4TODO_API_TOKEN"
          }
        }
      }
    }
  }
}

请求约定

• 每个请求必须包含 Authorization: Bearer <token>。
• 带有 JSON 请求体的请求必须包含 Content-Type: application/json。
• GET /todos 需要一个 workspace 查询参数。
• 象限：使用 IU | IN | NU | NN（内部使用）。

工作流程（推荐顺序）

复制此清单并在执行时保持更新：

任务清单：
- [ ] 列出工作区（选择 `ws_...`）
- [ ] 列出该工作区的待办事项
- [ ] 执行请求的变更操作（创建 / 完成 / 重新排序 / 设置重复）
- [ ] 重新获取数据以验证更改

1. GET /workspaces：选择一个目标 ws_...（通常是默认工作区）。
2. GET /todos?workspace=ws_...：获取待办事项（按象限分组）。
3. 创建：POST /todos。
4. 完成：POST /todos/:id/complete（幂等操作）。
5. 重新排序 / 移动象限：POST /todos/reorder。
6. 重复性待办事项：使用 /recurring-todos 端点。

HTTP 示例 (curl)

本技能特意使用 curl 以实现跨操作系统和环境的最高可移植性。

注意：
- 仅使用 HTTPS (https://4to.do/api/v0)。
- 始终通过 FOURTODO_API_TOKEN 传递令牌（切勿将令牌粘贴到聊天中）。

curl -sS -H "Authorization: Bearer $FOURTODO_API_TOKEN" -H "Accept: application/json" "https://4to.do/api/v0/workspaces"
curl -sS -H "Authorization: Bearer $FOURTODO_API_TOKEN" -H "Accept: application/json" "https://4to.do/api/v0/todos?workspace=ws_...&show=all"
curl -sS -X POST -H "Authorization: Bearer $FOURTODO_API_TOKEN" -H "Accept: application/json" -H "Content-Type: application/json" --data-raw '{"name":"...","quadrant":"IU","workspace_id":"ws_..."}' "https://4to.do/api/v0/todos"
curl -sS -X POST -H "Authorization: Bearer $FOURTODO_API_TOKEN" -H "Accept: application/json" "https://4to.do/api/v0/todos/todo_.../complete"
curl -sS -X POST -H "Authorization: Bearer $FOURTODO_API_TOKEN" -H "Accept: application/json" -H "Content-Type: application/json" --data-raw '{"moved_todo_id":"todo_...","previous_todo_id":"todo_...","next_todo_id":null,"quadrant":"IN"}' "https://4to.do/api/v0/todos/reorder"

注意：如果 moved_todo_id 以 rec_todo_ 开头，API 将仅更新重复性待办事项的象限，并忽略 previous_todo_id/next_todo_id。

常见错误处理（代理指导）

• 401 token_expired / invalid_token：停止重试；提示用户在 4todo 设置中创建新令牌并更新 OpenClaw 配置。
• 402 WORKSPACE_RESTRICTED：工作区为只读；不要重试变更操作；切换工作区或提示用户升级/解锁。
• 429 rate_limited：遵循 Retry-After / X-RateLimit-* 并在重试前退避。
• 400 Invalid quadrant type：确保象限是 IU|IN|NU|NN 之一。

参考

• 本技能附带的完整 API 文档：{baseDir}/references/api_v0.md