新闻详情

新闻详情

首页 / 资讯中心 / 详情

用 OpenClaw 管理个人待办事项:从 SKILL.md 到 Gateway 的配置骨架

发布时间:2026/9/29 6:57:23来源:尧图网络
用 OpenClaw 管理个人待办事项:从 SKILL.md 到 Gateway 的配置骨架
1. 为什么我最后把待办搬进了 OpenClaw我平时待办散落在三个地方手机备忘录、飞书任务、还有一个常年不打开的 Obsidian 库。结果就是每次想记一件事先得纠结记哪儿纠结完事情已经忘了。后来我把待办这件事整个交给 OpenClaw 来管核心思路很简单——我不再打开任何 App直接在聊天框里说人话它负责解析、存储、提醒。OpenClaw 是一个可以本地跑、也能接云端模型的智能体运行环境它通过 Skills 扩展能力通过 Gateway 统一管理模型通道。ClawHub 是它的技能市场你可以理解成给 AI 装插件的地方。SKILL.md 则是每个技能的定义文件用自然语言加少量脚本描述这个技能能干什么、怎么触发、执行什么命令。Gateway 负责把请求转发到模型服务这里我们统一走 TaoToken 的 Key/API 通道一个 Key 打通对话、编码、Agent 场景。这套方案适合谁适合不想被待办 App 绑架、又希望数据留在自己手里的人。你不需要写复杂代码会复制粘贴、会改路径就行。下面我从环境准备讲到 SKILL.md 骨架再到 Gateway 配置和验证动作全程可跟做。2. 前置准备ClawHub 装 Skills 与 TaoToken 通道在写自己的技能之前先把地基打好。这一步分两块装现成技能、配好模型通道。2.1 安装 ClawHub 上的待办技能ClawHub 上有社区维护的成熟技能最省事。确保 Gateway 已经在跑然后执行# 安装待办管理 智能提醒组合 clawhub install todo-manager remind-me # 重启网关让技能生效 openclaw gateway restarttodo-manager负责增删改查remind-me负责定时和循环提醒。装完之后你就能直接在聊天框里说添加待办完成项目报告优先级高截止本周日它会自动解析日期和优先级。这一步是动口不动手的起点。2.2 配置 TaoToken 统一 Key 通道模型通道我统一用 TaoToken好处是一个 Key 覆盖多个模型不用在配置文件里塞一堆厂商密钥。先去控制台拿 Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite拿到 Key 之后在 OpenClaw 的 Gateway 配置里指向 TaoToken 的 API 地址。API 基础地址是https://taotoken.net/api注意这个地址不加 UTM 参数直接填。配置片段如下放到你的 Gateway 配置文件里# ~/.openclaw/gateway.yaml providers: taotoken: type: openai-compatible base_url: https://taotoken.net/api api_key: sk-你的TaoToken密钥 models: - gpt-4o - claude-3-5-sonnet default_provider: taotoken注意base_url结尾不要多加/v1OpenClaw 会按 OpenAI 兼容格式自动拼接路径。填错会导致 404这是最常见的坑。改完配置重启网关openclaw gateway restart到这里模型通道和现成技能都就位了。如果你只想快速用起来其实已经可以开始说人话了。但如果你像我一样希望待办存成本地 Markdown、数据完全自己掌控那就继续往下写自己的 SKILL.md。3. 手写 SKILL.md定义待办增删改查能力现成技能功能全但数据存在 OpenClaw 自己的目录里。我更喜欢纯文本极客风——待办就是一个todos.md文件用 Obsidian 或 VSCode 都能直接看。这就需要自建一个 Skill。3.1 SKILL.md 的目录结构与头部在技能目录下创建文件mkdir -p ~/.openclaw/workspace/skills/todo-local touch ~/.openclaw/workspace/skills/todo-local/SKILL.mdSKILL.md 的头部是 YAML front matter定义技能名、描述和触发词。触发词很关键它决定了你说哪些话时 AI 会调用这个技能--- name: todo-local description: 管理本地 ~/Documents/todos.md 文件中的待办事项。触发词todo/待办/任务 ---description里写清楚触发词模型会根据语义匹配。我实测下来把待办任务todo都列进去命中率最高。3.2 增删改查四个动作的脚本骨架SKILL.md 的正文用自然语言描述能力配合 bash 代码块给出具体命令。下面是我在用的完整骨架你可以直接复制# 本地待办管理器 数据文件固定为 ~/Documents/todos.md格式为 Markdown 复选框。 ## 添加任务 当用户说待办xxx或添加任务 xxx时执行 bash TASK$1 echo - [ ] $TASK ($(date %Y-%m-%d)) ~/Documents/todos.md echo 已添加$TASK列出任务当用户说列出待办或我的任务时执行if [ -f ~/Documents/todos.md ]; then grep -n \[ \] ~/Documents/todos.md else echo 暂无待办 fi完成任务当用户说完成 xxx时把对应行从[ ]改成[x]TASK$1 sed -i s/- \[ \] $TASK/- [x] $TASK/ ~/Documents/todos.md echo 已完成$TASK删除任务当用户说删除 xxx时TASK$1 sed -i /$TASK/d ~/Documents/todos.md echo 已删除$TASK这里有个细节sed -i 在 macOS 上需要写成 sed -i Linux 上不用。如果你在 Mac 上跑记得改一下否则会报 sed: 1: ...: invalid command code。这个坑我踩过排查了半天。 ### 3.3 让技能被正确加载 写完 SKILL.md 后重启网关让它生效 bash openclaw gateway restart然后你可以用openclaw skills list确认todo-local出现在列表里。如果没出现检查两点文件路径是否在~/.openclaw/workspace/skills/下以及 front matter 的---是否闭合。YAML 格式错一个空格都会导致解析失败。4. Gateway 配置打通与请求验证技能写好了但真正让它跑起来的是 Gateway 把请求正确路由到模型。这一节我们把配置串起来然后做三个验证动作。4.1 完整 Gateway 配置片段把前面的 provider 配置和技能目录配置合并一个可用的 Gateway 配置长这样# ~/.openclaw/gateway.yaml server: port: 18789 workspace: ~/.openclaw/workspace providers: taotoken: type: openai-compatible base_url: https://taotoken.net/api api_key: sk-你的TaoToken密钥 models: - gpt-4o - claude-3-5-sonnet default_provider: taotoken skills: dirs: - ~/.openclaw/workspace/skills auto_reload: trueauto_reload: true是个省心选项改完 SKILL.md 不用每次手动重启。不过涉及 provider 变更时还是建议手动openclaw gateway restart避免连接池没刷新。4.2 验证一创建待办重启后在 OpenClaw 聊天框输入待办买牛奶预期结果终端或聊天框返回已添加买牛奶同时~/Documents/todos.md里多出一行- [ ] 买牛奶 (2025-xx-xx)。你可以用cat ~/Documents/todos.md确认。4.3 验证二查询待办输入列出我的任务预期返回所有未完成项。这里我做了个优化——脚本里用grep \[ \]只列未完成的已完成的[x]不会干扰视线。如果你想要全部把 grep 条件去掉即可。4.4 验证三完成与删除输入完成 买牛奶再cat文件应该看到那行变成了- [x] 买牛奶。然后输入删除 买牛奶文件里对应行消失。三个动作跑通说明 SKILL.md 的增删改查和 Gateway 的模型路由都正常。提示如果模型没有调用技能而是直接闲聊回复多半是触发词没匹配上。把description里的触发词写得更具体比如加上当用户提到待办清单时。5. 本篇常见错误排查这一节是我实际配置时遇到过的报错按出现频率排序。报错一clawhub: command not found说明 ClawHub CLI 没装或不在 PATH 里。先确认 OpenClaw 主程序装好了ClawHub 通常随主程序一起安装。如果单独装检查~/.openclaw/bin是否加进了环境变量。报错二Gateway 启动后请求返回 401九成是 TaoToken 的 Key 填错或过期。去 API Keys 页面重新生成一个注意复制时别带空格。另外确认base_url是https://taotoken.net/api不要写成带/v1的版本。报错三技能不触发AI 答非所问先openclaw skills list看技能有没有加载。加载了但不触发就是description的触发词问题。把用户可能说的口语都列进去比如记一下帮我记待办事项。报错四sed: invalid command codemacOS 和 Linux 的sed -i语法不同。Mac 上改成sed -i s/.../.../或者干脆用perl -i -pe替代跨平台更稳。报错五定时提醒时间不对检查服务器时区用date命令看当前时间。如果时区是 UTC 而你在东八区提醒会差 8 小时。改时区sudo timedatectl set-timezone Asia/Shanghai。报错六修改 SKILL.md 后不生效如果没开auto_reload必须openclaw gateway restart。开了还不行检查文件是否有语法错误YAML front matter 的缩进用空格不用 Tab。6. 把通道固定下来长期用得更顺待办这种高频场景最怕的就是通道不稳定——今天能记明天 Key 失效后天模型换了要重配。我的做法是把 TaoToken 作为统一通道固定下来一个 Key 管所有模型调用换模型只改配置里的models列表不用动 Key。如果你只是偶尔记几件事现成的todo-manager加remind-me就够了五分钟能跑起来。如果你像我一样要把待办和知识库、会议记录串起来那自建 SKILL.md 更值得投入因为数据格式完全由你定后面接日历、接转录、接自动晨报都好扩展。几个我长期用下来的小技巧待办文件放在~/Documents/todos.md而不是技能目录里这样 Obsidian 能直接打开每周用grep -c \[x\]统计完成数给自己一点正反馈提醒类任务交给remind-me别自己写 cron省得时区踩坑。通道配置和 Key 管理都在控制台统一处理接入文档里有各语言的调用示例需要的时候直接查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite模型对话体验https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite长期编码与 Agent 场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite把 SKILL.md 骨架复制过去改一下文件路径重启网关说一句待办试试 OpenClaw这件事就算落地了。
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

HTML表单7大属性与9大元素核心原理与实战 2026/9/29 7:54:14

HTML表单7大属性与9大元素核心原理与实战

1. 为什么必须吃透 form 表单的这7种属性和9种元素&#xff1f;——一个做了8年前端的老手的真实体会刚入行那会儿&#xff0c;我总以为表单就是<form>套几个<input>&#xff0c;提交按钮一按&#xff0c;数据就飞走了。直到第一次做银行级用户注册页&#xff0c;被…

阅读更多 →
EPLAN 电缆 块属性 导出 2026/9/29 7:54:02

EPLAN 电缆 块属性 导出

电缆标签导出 块属性1.选中要要导出的 页 2.工具–外部编辑—到处数据 选择需要到处的属性导出文件

阅读更多 →
Mediabunny 入门:在浏览器中完成媒体文件读写、转换与处理的纯 TypeScript 工具箱 2026/9/29 7:54:02

Mediabunny 入门:在浏览器中完成媒体文件读写、转换与处理的纯 TypeScript 工具箱

音视频视频处理音频处理 【免费下载链接】mediabunny Pure TypeScript media toolkit for reading, writing, and converting video and audio files, directly in the browser. 项目地址&#xff1a; https://gitcode.com/gh_mirrors/me/mediabunny 点击查看 免费下载 Mediab…

阅读更多 →
本地知识助手:让代码与文档同步的智能索引方案 2026/9/29 7:53:55

本地知识助手:让代码与文档同步的智能索引方案

1. 为什么你的 Wiki 总是和代码对不上干我们这行的&#xff0c;大概都经历过这种场景&#xff1a;新同事入职&#xff0c;你甩给他一个 Wiki 链接&#xff0c;说“照着这个搭环境就行”。结果他折腾了一下午跑过来问你&#xff0c;为什么文档里写的mvn clean install在他机器上…

阅读更多 →
Python Machine Learning 第6章实战指南:模型评估与超参数调优的最佳实践 2026/9/29 7:53:49

Python Machine Learning 第6章实战指南:模型评估与超参数调优的最佳实践

示例工程机器学习深度学习 【免费下载链接】python-machine-learning-book-2nd-edition The "Python Machine Learning (2nd edition)" book code repository and info resource 项目地址&#xff1a; https://gitcode.com/gh_mirrors/py/python-machine-learning-bo…

阅读更多 →
黑马程序员JavaScript前端开发课后习题:从语法到DOM实战精讲 2026/9/29 7:53:48

黑马程序员JavaScript前端开发课后习题:从语法到DOM实战精讲

1. 为什么这本教材的课后习题值得逐题啃下来《JavaScript前端开发案例教程》这本书&#xff0c;黑马程序员的读者群体里几乎人手一本。我在带人和自己复盘的时候发现一个很奇怪的现象&#xff1a;书里的正文部分大家读得挺认真&#xff0c;一到课后习题就集体“跳过”&#xff…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉