1. 部署完 OpenClaw 2.7.9 之后，为什么第一件事是配 Gateway
OpenClaw 2.7.9 装完只是把壳子搭好了，真正让它从「能聊天」变成「能干活」的，是 Skill 技能体系和背后的 Gateway 通道。很多人卡在这一步：技能装了一堆，结果每个 Skill 各自要填 Key、各自要配模型地址，最后配置散落在四五个文件里，改一个忘一个。
我自己的做法是：部署完成后先不急着装技能，而是把 Gateway 统一配好，让所有 Skill 走同一条 API 通道。这样后面不管装文件管理、办公自动化还是浏览器采集类技能，都只需要在 Gateway 层维护一份配置。
这篇就按这个顺序来：先讲清楚 OpenClaw 2.7.9 的 Skill / ClawHub / Gateway 三者关系，再给一份可以直接复制的config.toml骨架，然后是安装包校验、技能启用、连通性验证，最后把新手最容易踩的几个报错逐个拆掉。适合已经装完 OpenClaw 2.7.9、准备正式启用技能的人。
2. 先把 TaoToken 这条统一通道准备好
OpenClaw 的 Skill 在执行任务时，需要调用大模型来完成理解、规划和生成。如果每个 Skill 单独配模型，维护成本会很高。TaoToken 在这里扮演的角色就是「统一 Key / API 通道」：你在一个地方拿到 Key，配到 Gateway，所有 Skill 共用。
具体操作：
打开 https://taotoken.net/api 对应的控制台入口，注册后进入 API Keys 页面创建一个新 Key。建议按用途命名，比如openclaw-gateway，方便以后区分。创建后立刻复制保存，页面刷新后就不再完整显示。
如果你后面打算长期跑编码类、Agent 类技能，可以顺带看一下 Coding Plan 的额度说明，避免高频调用时额度不够。模型对话类的调试入口在模型对话页，用来快速验证 Key 是否可用。
注意：Key 只存在本地配置文件里，不要写进任何会提交到公开仓库的脚本。Gateway 配置建议单独放一个文件，权限设为仅当前用户可读。
拿到 Key 之后，先别急着往 OpenClaw 里塞，用一条最简请求验证一下通道是否通。这一步能省掉后面大量「到底是 Key 错还是技能错」的排查时间。
3. 可复制的 config.toml 骨架与安装包校验
3.1 config.toml 骨架
下面这份骨架是我实测下来比较稳的结构，字段按 OpenClaw 2.7.9 的 Gateway 配置习惯组织。你只需要替换api_key和确认base_url：
# OpenClaw 2.7.9 Gateway 配置骨架 [gateway] enabled = true host = "127.0.0.1" port = 8787 # 所有 Skill 统一走这条通道 default_provider = "taotoken" [providers.taotoken] base_url = "https://taotoken.net/api" api_key = "sk-替换成你自己的Key" timeout_seconds = 60 max_retries = 2 [skills] # 技能安装目录，ClawHub 下载的技能默认落在这里 install_dir = "./skills" auto_enable = false # 启用后 Gateway 重启才会加载新技能 hot_reload = false [logging] level = "info" file = "./logs/gateway.log"几个关键点说明：
default_provider指向taotoken，意味着所有 Skill 默认复用这一份凭证。auto_enable = false是故意的——新手阶段建议手动启用技能，出问题时好定位是哪个技能引起的。hot_reload = false配合后面的「重启 Gateway」步骤，保证配置变更真正生效。
3.2 安装包校验
安装包拿到手先别直接跑，做一次完整性校验。Windows 整合包大约 45.8MB，如果你拿到的文件大小差很多，先怀疑下载不完整。
# Linux / macOS 校验 SHA256 shasum -a 256 OpenClaw-2.7.9-installer.zip # Windows PowerShell 校验 Get-FileHash .\OpenClaw-2.7.9-installer.zip -Algorithm SHA256把输出和官方页面公布的哈希值对比。不一致就重新下载，不要抱侥幸心理——安装包损坏导致的启动失败，排查起来非常费时间。
校验通过后解压，确认目录里有config.toml模板、skills空目录和 Gateway 可执行文件。如果skills目录不存在，手动建一个，和配置里的install_dir保持一致。
4. 从 ClawHub 获取技能并启用
4.1 技能安装流程
OpenClaw 2.7.9 的技能来源主要是 ClawHub。操作路径是：主面板进入技能市场 / ClawHub 板块，搜索目标技能名称，点击安装，然后重启 Gateway。
命令行方式更适合批量操作：
# 查看已安装技能 openclaw skill list # 从 ClawHub 安装指定技能 openclaw skill install file-organizer # 启用技能 openclaw skill enable file-organizer # 重启 Gateway 使技能生效 openclaw gateway restart4.2 新手优先启用的技能组合
按场景分，部署完成后建议先启用这五类，覆盖绝大多数日常需求：
| 场景 | 技能 | 作用 |
|---|---|---|
| 文件管理 | file-organizer | 按类型/日期自动归类桌面和下载目录 |
| 办公自动化 | office-automation | 操控 Word/Excel/WPS 生成和修改文档 |
| 文档处理 | pdf-toolkit | PDF 转 Word、合并、拆分、OCR |
| 浏览器 | web-collector | 网页信息采集、保存为表格 |
| 系统工具 | system-monitor | 查看 CPU/内存/磁盘占用，清理缓存 |
启用后可以发组合指令测试，比如「帮我整理桌面 + 把下载文件夹归类 + 检查电脑垃圾」。如果这条指令能跑通，说明 Gateway 通道和技能加载都正常。
4.3 技能配置的覆盖规则
有些技能自带独立配置项，会覆盖 Gateway 的默认 provider。遇到技能报「未配置模型」时，先检查该技能的配置文件里有没有硬编码的 provider 字段。统一原则是：技能层不写 Key，只继承 Gateway。
5. 连通性验证：确认技能真的能跑
配置改完、技能启用后，必须做一次端到端验证。分三步：
第一步，验证 Gateway 本身是否起来：
curl -s http://127.0.0.1:8787/health返回{"status":"ok"}说明 Gateway 进程正常。
第二步，验证 API 通道是否通：
curl -s https://taotoken.net/api/v1/models \ -H "Authorization: Bearer sk-你的Key"能返回模型列表，说明 Key 和通道都没问题。这一步失败的话，后面技能一定跑不起来，先解决这里。
第三步，触发一个真实技能任务。比如对 file-organizer 发指令「整理桌面所有文件」，观察logs/gateway.log里是否有请求记录和成功返回。日志里出现skill=file-organizer status=success就说明整条链路通了。
三步都过，才算真正「部署完成直接启用」。只做前两步不做第三步，很容易出现「通道通了但技能没加载」的假成功。
6. 本篇常见报错排查
报错一：Gateway 启动后技能列表为空。大概率是install_dir路径不对，或者技能装到了别的目录。检查配置里的路径和实际技能目录是否一致，注意相对路径是相对于 Gateway 启动目录的。
报错二：技能执行时报 401 / 403。Key 无效或没带上。先确认config.toml里api_key没有多余空格，再确认技能没有覆盖 provider 配置。用第 5 步的 curl 单独验证 Key。
报错三：改了配置但行为没变。hot_reload = false时配置不会自动生效，必须openclaw gateway restart。这是最常见的「我明明改了」问题。
报错四：安装包解压后缺文件。回到 3.2 重新校验哈希，重新下载。不要用第三方渠道的安装包。
报错五：技能装上了但指令没反应。检查技能是否enable，以及 Gateway 日志里有没有该技能的加载记录。有些技能需要额外依赖，日志里会提示缺什么。
排查顺序建议固定为：Gateway 健康检查 → API 通道验证 → 技能加载状态 → 技能执行日志。按这个顺序走，基本不会绕弯路。
7. 接下来怎么用
配置和验证都跑通之后，日常使用就是发指令。文件整理、办公文档、网页采集这几类技能的组合指令最实用，比如「把下载文件夹按类型分类 + 生成一份今日工作记录」。
如果你后面要接编码类或 Agent 类技能，Key 和 Gateway 这套结构不用动，只需要在 Coding Plan 里确认额度够用。接入文档里有更细的字段说明，遇到配置项不确定时对照着看。
整套流程的核心就一句话：Gateway 管通道，ClawHub 管技能，Key 只配一次。把这三件事分开，后面加多少技能都不会乱。
