1. 先搞清楚 OpenClaw 里 Skill、ClawHub、Gateway 各管什么刚接触 OpenClaw 的办公用户最容易卡在三个词上Skill、ClawHub、Gateway。它们不是一回事但缺一个都跑不起来。你可以把 OpenClaw 想成一台刚装好的电脑Skill 是上面装的软件ClawHub 是软件商店Gateway 是负责把指令从你这里送到软件、再把结果送回来的那根数据线。软件没装电脑再快也干不了活商店打不开你就找不到软件数据线没插好软件装了也收不到指令。这篇面向的是刚上手、想用 OpenClaw 做办公自动化的普通用户不要求你会写代码但要求你愿意复制几段配置、改几个字段。整条链路是在 ClawHub 里找到 Skill 并安装在 config.toml 里把 Gateway 通道配好在 settings.json 里把关键开关打开最后发一条办公任务验证闭环。跑通一次之后后面加技能就是重复动作。我试过把这套流程拆给完全没接触过的人卡点基本集中在两处一是 Gateway 的地址和密钥填错二是 Skill 装了但没在 settings.json 里启用。下面按顺序来每一步都给可复制的骨架你照着改就行。2. 前置准备拿到可用的 API 通道与访问凭证OpenClaw 的 Skill 要真正执行任务底层得有一个能调用的模型通道。这一步用 TaoToken 来做接入它的作用是给你一个统一的 API 入口省去自己拼各家模型地址的麻烦。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后进控制台。进控制台后做两件事第一创建一个 API Key这个 Key 后面要填进 config.toml 的 Gateway 段第二确认你的账户里有可用额度否则请求会直接返回鉴权或额度错误。API Key 的创建页面在 https://taotoken.net/api-keys 注意这个 Key 只显示一次复制后先存到本地记事本。注意API Key 等同于密码不要写进会公开的仓库也不要截图发群里。config.toml 如果放桌面建议单独建一个目录存放。如果你后面要长期跑编码类或 Agent 类任务可以了解下 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。只是做办公自动化验证的话先用按量 Key 就够。3. 可复制配置config.toml 骨架与 settings.json 关键字段OpenClaw 的配置文件通常分两个config.toml 管通道和运行参数settings.json 管技能启用和界面行为。下面这份 config.toml 骨架可以直接复制把你的API_KEY换成上一步拿到的 Key。# config.toml —— OpenClaw Gateway 通道配置骨架 [gateway] # Gateway 监听地址本地办公场景保持默认即可 host 127.0.0.1 port 8787 # 通道类型走标准 API 接入 channel api [gateway.provider] # TaoToken 统一 API 入口 base_url https://taotoken.net/api api_key 你的API_KEY # 办公自动化常用模型按需替换 model claude-sonnet timeout 60 [gateway.retry] max_attempts 3 backoff_seconds 2 [skills] # Skill 安装目录ClawHub 下载的技能会落到这里 install_dir ./skills auto_update false几个字段说明一下。base_url填https://taotoken.net/api不要多加路径Gateway 会自己拼。timeout给 60 秒办公任务里像 PDF 转换、批量重命名这类操作耗时较长太短会中途断掉。auto_update建议先关避免技能在你不知情时被替换导致行为变化。然后是 settings.json它决定哪些 Skill 真正生效{ gateway: { enabled: true, config_path: ./config.toml }, skills: { enabled: [ file-organizer, office-automation, pdf-toolkit, web-collector, system-monitor ], disabled: [], confirm_before_execute: true }, workspace: { default_dir: ./workspace, allow_outside_access: false }, logging: { level: info, file: ./logs/openclaw.log } }enabled数组里就是你要启用的 Skill 名称这些名字要和 ClawHub 里安装的保持一致。confirm_before_execute建议先设 true第一次跑任务时每一步都会问你确认行为符合预期后再改成 false 提速。allow_outside_access保持 false办公场景没必要让技能访问工作目录之外的文件。4. 从 ClawHub 安装 Skill 并重启 Gateway配置写好后去 ClawHub 拿技能。ClawHub 是 OpenClaw 的技能市场入口在操作面板里。打开面板进入 ClawHub 页面搜索你要的技能名比如file-organizer点安装。安装完成后技能文件会落到 config.toml 里install_dir指定的目录。安装动作本身不复杂容易出问题的是顺序先装技能再改 settings.json 的 enabled 列表最后重启 Gateway。如果先重启再改 enabled技能不会加载。重启命令按你的部署方式不同常见的是# 停止当前 Gateway openclaw gateway stop # 重新启动加载新配置 openclaw gateway start --config ./config.toml # 查看启动日志确认技能加载成功 tail -f ./logs/openclaw.log日志里出现类似loaded skill: file-organizer的行说明技能被识别了。如果只看到skill not enabled回去检查 settings.json 的 enabled 数组拼写。技能名大小写敏感File-Organizer和file-organizer会被当成两个东西。5. 验证一次办公自动化任务整理下载目录并生成记录配置和技能都就位后发一条真实任务验证闭环。选一个低风险的场景整理下载目录里的文件按类型归类并生成一份操作记录。这条任务会同时用到 file-organizer 和 office-automation 两个技能。在 OpenClaw 对话界面输入把 ./workspace/downloads 目录下的文件按类型归类到子文件夹 图片放 images文档放 docs压缩包放 archives 完成后生成一份 markdown 记录列出每个文件移动前后的路径。如果confirm_before_execute是 true你会先看到它列出的执行计划确认后它开始移动文件。成功时你会看到类似输出[move] report.pdf - docs/report.pdf [move] photo.png - images/photo.png [move] backup.zip - archives/backup.zip [done] 3 files organized, record saved to ./workspace/organize-log.md打开organize-log.md里面应该有每个文件的原始路径和目标路径。这一步跑通说明从 ClawHub 安装、Gateway 通道、settings.json 启用、到技能执行整条链路是通的。后面再加 PDF 处理、网页采集只是往 enabled 数组里加名字、去 ClawHub 装对应技能。想单独验证模型通道是否正常可以打开模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一句简单指令看是否有正常回复。通道通了OpenClaw 这边的报错基本就只剩配置问题。6. 本篇常见错排查Gateway 连不上、技能不生效、任务中断报错一Gateway connection refused。说明 Gateway 没起来或者 host/port 和客户端填的不一致。先openclaw gateway status看进程在不在再看 config.toml 里 port 是不是 8787客户端连的端口要一样。如果改了端口没重启配置不生效。报错二401 unauthorized。API Key 错了或过期。去 https://taotoken.net/api-keys 重新生成一个替换 config.toml 里的api_key重启 Gateway。注意 Key 前后不要带空格复制时容易多带一个换行。报错三skill not found。ClawHub 里装了但 settings.json 的 enabled 名字对不上或者 install_dir 路径不对。检查技能实际落地的目录和 config.toml 里install_dir是否一致。相对路径是相对于启动 Gateway 时的工作目录不是配置文件所在目录这点容易踩。报错四任务跑到一半 timeout。办公任务里批量操作耗时长把 config.toml 的timeout从 60 调到 120 或更高。如果是 PDF 转换这类重活还要看机器本身性能跟通道关系不大。报错五文件没动但显示 done。多半是 workspace 的default_dir和任务里写的路径不一致技能在另一个目录里操作了。把任务里的路径写成绝对路径先验证一次确认后再改回相对路径。接入相关的完整字段说明和排障清单可以对照接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 逐项核对。文档里对 base_url、鉴权头、超时参数都有示例比对着改比盲试快。跑通这条最小闭环后我的习惯是先把常用的五个技能固定进 enabled 数组config.toml 备份一份到单独目录。以后 ClawHub 里看到新技能先装、再改 enabled、再重启三步走完就能用。真正省时间的不是技能数量而是这条链路你闭着眼都能走通。