1. 为什么我劝你先别急着装 OpenClaw v2.7.9 办公 SkillOpenClaw v2.7.9 是一个本地运行的职场自动化工具你可以把它理解成一个「能动手操作电脑的 AI 助手」——它不只是聊天而是能真的去整理文件夹、生成表格、抓取网页数据、批量改文件名。而 Skill技能就是它的手脚装了什么 Skill它就能干什么活。ClawHub 是它的技能市场相当于一个应用商店你在里面搜「办公自动化」就能找到一堆现成技能。这篇教程适合谁适合已经装好 OpenClaw v2.7.9、但卡在「Skill 装了不生效」「不知道配置文件写在哪」「想自己写一个可复用的办公 Skill」这三类人。我会从 ClawHub 拿安装包开始走完本地初始化、写一个可复用的办公自动化 Skill、调试、验证输出文件和日志的完整流程。全程给你可复制的配置片段和运行命令不跳步。先说一个我踩过的坑很多人以为在 ClawHub 点了「安装」就完事了结果发指令没反应。原因是 Skill 的加载依赖 Gateway 服务重启而且每个 Skill 有自己的 manifest 和权限声明缺一个字段就会静默失败——日志里只留一行 warning不仔细看根本发现不了。所以这篇的重点不是「怎么点安装按钮」而是「怎么确认它真的加载成功了」。下面按六个部分走先讲清楚问题场景再准备 TaoToken 的模型接入然后给可复制的 Skill 配置接着验证请求和输出再排查常见报错最后给一个稳定的接入入口。你可以按顺序跟做也可以直接跳到你现在卡住的那一步。2. 前置准备TaoToken 接入与 OpenClaw v2.7.9 本地初始化OpenClaw 的 Skill 要跑起来底层得有一个能调用的模型服务。我用的是 TaoToken 的 API 来做模型接入原因是它的 Base URL 和 Key 结构清晰配置到 OpenClaw 的 settings 里不容易出错。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址后面不加任何参数。第一步去控制台拿 Key。打开 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面创建一个新 Key复制出来先存到本地文本里。这个 Key 只显示一次丢了就得重建。如果你还没决定用哪个模型可以先去模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 试一下对话效果确认模型 ID 再填进配置。第二步确认 OpenClaw v2.7.9 的安装包版本。ClawHub 里的 Skill 对客户端版本有要求v2.7.9 对应的 Skill manifest 版本号是2.7.x如果你装的是旧版客户端Skill 会加载失败并提示manifest version mismatch。检查版本的命令openclaw --version # 期望输出OpenClaw v2.7.9 (build 20240923)如果版本不对先去 ClawHub 的安装包页面重新下载对应系统的包。Windows 和 macOS 的包不通用别下错。第三步本地初始化配置目录。OpenClaw 默认把配置放在用户目录下的.openclaw文件夹里Skill 的配置写在skills/子目录。初始化命令openclaw init --profile office # 输出 # [ok] created ~/.openclaw/config.toml # [ok] created ~/.openclaw/skills/ # [ok] created ~/.openclaw/logs/初始化完成后把 TaoToken 的接入信息写进~/.openclaw/config.toml。这一步很关键Skill 调用模型时读的就是这个文件里的 provider 配置。完整的 TOML 片段如下路径和字段名保持原样# ~/.openclaw/config.toml [provider.taotoken] base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model claude-3-5-sonnet timeout 60 [gateway] host 127.0.0.1 port 8787 auto_reload true [skills] dir ~/.openclaw/skills hot_reload true注意model字段要填你在模型对话页面确认过的模型 ID别照抄。auto_reload true是让 Gateway 在 Skill 文件变动后自动重载调试阶段建议开着省得每次手动重启。第四步启动 Gateway 服务并确认它读到了配置openclaw gateway start # 输出 # [gateway] listening on 127.0.0.1:8787 # [provider] taotoken loaded, modelclaude-3-5-sonnet # [skills] watching ~/.openclaw/skills (hot_reloadtrue)看到[provider] taotoken loaded这行说明模型接入通了。如果这行没出现先别往下走去排查 config.toml 的缩进和字段名——TOML 对大小写和引号很敏感base_url写成baseUrl就会静默忽略。3. 可复制配置写一个可复用的办公自动化 Skill现在进入核心部分写一个真正能复用的办公 Skill。我以「每日工作记录生成器」为例它会读取你指定目录下的文件列表生成一份带时间戳的 Markdown 工作记录并归档到reports/目录。这个 Skill 覆盖了文件读取、模型调用、文件写入三个动作是办公自动化的典型骨架你改改 prompt 就能变成周报生成、文件规整、表格汇总。先建目录结构。OpenClaw 的 Skill 目录约定是每个 Skill 一个文件夹里面必须有manifest.json和handler.py两个文件mkdir -p ~/.openclaw/skills/daily-report cd ~/.openclaw/skills/daily-report touch manifest.json handler.pymanifest.json是 Skill 的身份证声明名称、版本、触发词、权限和依赖的模型 provider。字段写错会导致加载失败所以逐字对照{ name: daily-report, version: 2.7.9, description: 读取指定目录文件列表生成每日工作记录 Markdown, trigger: [生成工作记录, daily report, 今日工作记录], permissions: [fs.read, fs.write, model.invoke], provider: taotoken, entry: handler.py, timeout: 90 }几个容易写错的点version要跟客户端大版本对齐写2.7.9而不是1.0.0provider必须和 config.toml 里的[provider.taotoken]段名一致permissions里少了fs.writeSkill 能生成内容但写不进文件日志会报permission denied: fs.write。handler.py是执行逻辑。OpenClaw 的 Skill 用 Python 写入口函数固定叫run接收一个context对象里面带着用户指令和配置# ~/.openclaw/skills/daily-report/handler.py import os import json from datetime import datetime def run(context): # 1. 读取目标目录默认桌面 target_dir context.params.get(dir, os.path.expanduser(~/Desktop)) files [] for name in os.listdir(target_dir): full os.path.join(target_dir, name) if os.path.isfile(full): files.append({ name: name, size: os.path.getsize(full), mtime: datetime.fromtimestamp( os.path.getmtime(full) ).strftime(%Y-%m-%d %H:%M) }) # 2. 调用模型生成摘要 prompt f以下是今日处理的文件列表请生成一份简洁的工作记录\n{json.dumps(files, ensure_asciiFalse)} summary context.model.invoke(prompt) # 3. 写入 reports 目录 report_dir os.path.expanduser(~/.openclaw/reports) os.makedirs(report_dir, exist_okTrue) stamp datetime.now().strftime(%Y%m%d_%H%M%S) out_path os.path.join(report_dir, fdaily_{stamp}.md) with open(out_path, w, encodingutf-8) as f: f.write(f# 工作记录 {stamp}\n\n) f.write(summary) f.write(f\n\n---\n共处理 {len(files)} 个文件\n) return {status: ok, output: out_path, count: len(files)}写完保存因为 config.toml 里开了hot_reload trueGateway 会自动重载。确认加载状态的命令openclaw skills list # 输出 # NAME VERSION STATUS PROVIDER # daily-report 2.7.9 loaded taotoken看到loaded才算成功。如果是error用openclaw skills inspect daily-report看具体报错。这一步是整个流程的分水岭很多人卡在这里就是因为没确认 STATUS 就急着发指令。4. 验证请求触发 Skill 并检查输出文件与日志Skill 加载成功后用示例任务触发它。OpenClaw 的触发方式有两种命令行直接调或者在对话面板里说触发词。先用命令行验证排除对话层的干扰openclaw run daily-report --param dir~/Desktop # 输出 # [skill] daily-report triggered # [model] taotoken invoke, tokens412 # [fs] wrote ~/.openclaw/reports/daily_20240923_143022.md # {status: ok, output: .../daily_20240923_143022.md, count: 17}返回status: ok且count大于 0说明 Skill 完整跑通了。接着检查输出文件内容cat ~/.openclaw/reports/daily_20240923_143022.md # 期望看到 # # 工作记录 20240923_143022 # 模型生成的摘要正文 # --- # 共处理 17 个文件再检查日志确认安装包版本和 Skill 加载状态一致。日志在~/.openclaw/logs/gateway.logtail -n 30 ~/.openclaw/logs/gateway.log | grep daily-report # 期望输出 # [skills] loaded daily-report v2.7.9 (manifest ok) # [skill] daily-report run start, params{dir: ...} # [skill] daily-report run done, statusok重点看loaded daily-report v2.7.9这行——版本号必须和你客户端版本一致。如果这里显示的是v2.7.8或v1.0.0说明 manifest.json 里的 version 写错了Skill 虽然能跑但会在后续升级时出问题。验证模型调用是否真的走了 TaoToken可以在日志里搜 provider 标记grep providertaotoken ~/.openclaw/logs/gateway.log | tail -n 5 # [model] invoke providertaotoken modelclaude-3-5-sonnet tokens412如果这行没有说明 Skill 用了默认 provider 而不是你配的 TaoToken回去检查 manifest.json 的provider字段和 config.toml 的段名是否完全一致。大小写、连字符都算。到这里一个可复用的办公 Skill 就跑通了。你可以把handler.py里的 prompt 换成「生成周报」「汇总表格数据」「批量重命名建议」逻辑骨架不用动这就是可复用的意义。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth调试阶段最容易撞的几类报错我按出现频率排一下每个都给真实报错原文和定位方法。401 Unauthorized。日志原文[model] invoke failed: 401 Unauthorized, providertaotoken。原因九成是 api_key 写错或过期。检查 config.toml 里的api_key字段确认没有多余空格确认 Key 是在控制台 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 里有效的那一个。如果刚重建过 Key旧 Key 会立即失效记得同步更新配置并重启 Gateway。local proxy failed。日志原文[gateway] local proxy failed: connection refused 127.0.0.1:8787。这是 Gateway 没起来或者端口被占。先openclaw gateway status看状态如果是 stopped 就openclaw gateway start如果端口被占改 config.toml 里的port字段换个端口比如 8788然后重启。注意 Skill 调用模型走的是 Gateway 转发Gateway 挂了所有 Skill 都会报这个错。reading choices 相关报错。日志原文[model] response parse error: reading choices field, got null。这是模型返回结构不符合预期通常是 model ID 填错了——比如填了一个不支持 chat completions 格式的模型。去模型对话页面确认模型 ID换成标准的对话模型再试。另外 timeout 设太短也会导致返回被截断把timeout从 60 调到 90 试试。OAuth 相关报错。日志原文[provider] oauth token expired, please re-auth。如果你用的是需要 OAuth 的接入方式token 过期后要重新授权。但用 TaoToken 的 API Key 方式不会遇到这个因为 API Key 是长期有效的。如果你看到这个报错说明配置里混进了 OAuth 的 provider 段把 config.toml 里多余的 provider 段删掉只留[provider.taotoken]。Skill 加载了但触发无反应。日志原文[skills] no match for trigger: 生成工作记录。这是触发词没匹配上。检查 manifest.json 的trigger数组确认你发的指令包含数组里的某个词。中文触发词要注意不要有多余空格生成工作记录和生成 工作记录是两个不同的匹配。输出文件为空。日志显示statusok但文件是 0 字节。这是fs.write权限没生效或者写入路径的目录不存在。确认 manifest.json 的permissions里有fs.write确认handler.py里os.makedirs那行没被注释掉。排查顺序建议先看 Gateway 状态再看 provider 是否 loaded再看 Skill 是否 loaded最后看单次运行的日志。从外到内别一上来就改代码。6. 稳定接入与长期使用建议跑通单个 Skill 之后如果你打算长期用 OpenClaw 做办公自动化建议把模型接入固定下来。TaoToken 的 API 地址 https://taotoken.net/api 直接写进 config.toml 的base_urlKey 从控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 管理需要轮换时只改一处。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各语言的调用示例写自定义 Skill 时可以对照。如果你要写更复杂的 Agent 类 Skill比如多步骤的文件规整加表格汇总建议用 Coding Plan 来跑长任务入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它对长时间、多轮调用的场景更稳。Claude Code 相关的接入配置在 https://taotoken.net/claudecode?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 如果你习惯在编辑器里写 Skill 逻辑可以配合着用。最后给一个实用技巧把常用的 Skill 配置片段存成一个模板目录新写 Skill 时直接复制 manifest.json 改 name 和 triggerhandler.py 保留骨架只改 prompt 和输出路径。这样从「想做一个办公自动化」到「跑通验证」的时间能压到十分钟以内。我实测下来最耗时的从来不是写代码而是排查 manifest 字段和 provider 配置——所以把这两块模板化后面就是纯体力活了。