4todo

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

目标

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

必需的环境变量

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

运行时要求

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

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

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

示例（首选）

工作区：

Your workspaces:
1) Haoya (default)
2) 4todo
3) Echopark

待办事项（摘要）：

Urgent & important:
1) UK company dissolution
2) Hetzner monthly payment (recurring, monthly)

Important (not urgent):
1) Weekly review (recurring, Fridays)

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

OpenClaw可以仅在代理运行期间注入环境变量（然后恢复原始环境），这有助于避免机密信息出现在提示中。

推荐（生产环境）：通过您托管提供商的机密存储，在网关进程环境中设置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（内部）。

工作流程（推荐顺序）

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

Task checklist:
- [ ] List workspaces (pick `ws_...`)
- [ ] List todos for that workspace
- [ ] Perform the requested mutation (create / complete / reorder / recurring)
- [ ] Re-fetch to verify the change

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