2026年,想用上 Claude Opus 4.6,其实已经不需要经历复杂的部署流程了。我最近把 OpenClaw 和 88API 这套组合跑通之后,真真切切体会到了什么叫“三分钟直连”。OpenClaw 是当前社区热度很高的开源智能网关,负责模型调度、技能扩展和消息通道;88API 则是聚合类 API 服务商,把 Claude Opus 4.6 的能力通过标准接口送到你的本地工具里。这篇文章我把自己从零到通的完整操作路径、选型逻辑和踩坑记录都整理了出来。
不管你是完全没配过 API 的小白,还是已经在本地跑过 Ollama、OpenClaw 的老手,只要会复制粘贴命令,就能照着跑通。我会从原理讲到实战:为什么这套方案值得选、OpenClaw 在 Windows 和便携包下怎么装、88API 的 Key 怎么接、怎么验证自己真的在用 Opus 4.6,以及那些官方文档里不会写的问题排查经验。内容会稍微长一点,但都是可以直接“抄作业”的干货。
1. 先把原理讲透:OpenClaw 和 88API 到底在各自负责什么
1.1 OpenClaw:一个把“模型能力”和“日常工具”串起来的开源网关
很多人第一次看到 OpenClaw 这个名字,会以为它只是一个聊天软件。实际上,OpenClaw 的定位更像是一个个人 AI 运行时,或者叫智能网关。它跑在你自己的电脑、服务器或者 NAS 上,做的事情可以拆成三块:模型调度、技能扩展、消息通道。
模型调度解决的是“你同时拥有好几个模型,怎么统一管理”的问题;技能扩展解决的是“模型只能出文字,怎么让它执行命令、读写文件”的问题;消息通道解决的是“你习惯在微信、飞书、网页里聊天,怎么把它接到同一个大脑上”的问题。说白了,OpenClaw 干的事情,是把底层模型的智力、外部工具的执行力、还有你日常使用的入口,全部粘合在一起。
我用一个生活里的类比:OpenClaw 就像是一个手机系统,里面的模型是 CPU,Skill 是 App,微信、飞书、网页是屏幕。系统本身不产出内容,但它把所有组件组织在一起,形成一个可用的整体。这也是它和单纯“打开官网聊天”最本质的区别:前者给你一座装修好的房子,后者给你一块地,让你按自己的需求盖房子。对小白来说,OpenClaw 相对友好的一点是,它默认给你一个 Web 聊天界面,第一眼看上去不吓人;对有经验的玩家来说,深度玩法都在配置文件和 Skill 里。
1.2 88API:更像一个“模型外卖平台”
88API 在这条链路里扮演的角色,用一句话概括:把 Claude Opus 4.6 这样的大模型能力“外卖”到你手上。它是一个聚合类 API 服务商,不需要你自己去处理上游服务商的支付方式、账户审核、复杂鉴权流程,只需要注册一个账号,创建 API Key,就能获得 OpenAI 兼容的标准接口。
对很多开发者来说,这类平台最大的价值是降低门槛:不用准备外币信用卡、不用纠结支付方式,控制台全中文,按量计费,后台能看到每一次请求的延迟和 token 消耗。我第一次用聚合 API 服务的时候,心里也是打鼓的,担心模型质量会不会打折扣、会不会偷偷换模型。用了一段时间之后,我的结论是:选一个靠谱的聚合平台,配合后台调用日志做复核,整体体验是完全可以接受的。尤其是个人开发者、自己写小工具、做自动化流程,这个“外卖平台”模式远比直接对接上游省心。
如果把 Claude Opus 4.6 比作一家高级餐厅,88API 就是外卖平台的骑手,OpenClaw 则是你家里的智能厨房。你只需要下单,骑手把食材送到,厨房负责加工成你想吃的菜。这个比喻虽然简化,但基本说清了三者关系。文章后面所有的配置操作,都是在处理这三者之间的“接口对接”问题。
1.3 为什么不直接用官网或官方 API?一张表看懂差异
在动手之前,很多人会好奇:既然最终都是调用 Claude Opus 4.6,为什么非要绕一圈用 OpenClaw + 88API?我直接给你一张对比表,看完就明白不同方案的适用场景了。
| 方案 | 上手门槛 | 灵活性 | 成本模式 | 扩展能力 | 适合人群 |
|---|---|---|---|---|---|
| 官方网页版 | 低,开箱即聊 | 低,只能用官方功能 | 固定月费 | 不支持接 IM,不开放工具 | 只想要一个聊天窗口的用户 |
| 官方 API 直连 | 中高,需要注册、绑定支付、写代码 | 高,但开发量也高 | 按量计费 | 可以自己写全套 | 后端开发者,需要定制服务的人 |
| OpenClaw + 88API | 低,复制粘贴命令 | 高,模型可切换、Skill 可扩展 | 按量计费,额度可控 | 微信/飞书/网页/自动化都能接 | 个人用户、办公场景、轻量开发者 |
看完这张表你应该能发现,OpenClaw + 88API 并不是要替代官方方案,它更像是一条性价比极高的中间路线。你有不错的上手体验,又保留了灵活的扩展能力,适合绝大多数个人开发者和小团队。而且这套组合还有一个隐性优势:底层模型可以随时换。今天用 Claude Opus 4.6,明天可以换成其他模型,OpenClaw 本身不会锁死任何一家,你的 Skill、通道、自动化流程都不用跟着推倒重来。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 装好 OpenClaw:Windows、便携包和常用命令
2.1 Windows 11 下的 PowerShell 一行命令安装
如果你用的是 Windows 11,安装 OpenClaw 最简单的方式就是打开 PowerShell,执行官方安装脚本:
powershell复制irm https://openclaw.ai/install.ps1 | iex
第一次装,我建议用管理员权限打开 PowerShell,避免目录权限和 PATH 写入失败。执行之后,脚本会自动下载核心程序、创建 .openclaw 数据目录,并尝试把可执行文件路径加入系统 PATH。整个安装过程通常一两分钟内能完成,具体快慢取决于网络状态。
装完之后,一定要打开一个新的 PowerShell 窗口再执行 openclaw --version。这一步非常关键,很多新手在这里卡住,不是没装好,而是当前终端窗口里的 PATH 还没刷新,系统根本找不到 openclaw 命令。如果你看到类似 2.x.x 的版本号输出,说明安装成功;如果提示找不到命令,多半是 PATH 没生效,或者安装脚本被安全软件拦截了,具体排查方法放在后面。
顺带说一下 macOS 和 Linux 用户:官方同样提供了 shell 安装脚本,执行 curl -fsSL https://openclaw.ai/install.sh | bash 就行。后面的配置逻辑和 Windows 完全一致,只是路径从 C:\Users\<用户名>\.openclaw\ 换成了 ~/.openclaw/,文章里统一用这个路径说明。
2.2 能不能指定安装目录?先设好 OPENCLAW_HOME
“PowerShell 安装 OpenClaw 能指定目录吗”这个问题,在社区里被问过很多次。官方安装脚本确实没有提供一个类似 --install-dir 的直观参数,但常见做法是先设置环境变量 OPENCLAW_HOME,再执行安装脚本,这样很多版本都会尊重这个路径。比如你想把 OpenClaw 放在 D 盘:
powershell复制$env:OPENCLAW_HOME = "D:\OpenClaw"
irm https://openclaw.ai/install.ps1 | iex
这里有个坑要提前说:不同版本对这个环境变量的支持程度可能不一样,如果你设置了之后发现程序还是装到了默认位置,建议去官方文档确认当前版本的安装器行为。我个人更推荐把程序目录和数据目录分开管理:程序装哪个盘问题不大,关键是要知道你的 workspace 和配置都在 C:\Users\<用户名>\.openclaw\ 下面。如果你的 C 盘空间紧张,可以把整个 .openclaw 目录用 mklink 链接到 D 盘,这是我自己实测有效的办法,操作起来也不复杂。
2.3 便携包:不写注册表、解压就能跑的备选方案
如果你实在不想用命令行,或者需要在多台电脑之间迁移,OpenClaw 还有便携包(Portable Package)可用。下载对应平台的压缩包,解压到一个你熟悉的目录,比如 D:\OpenClawPortable,然后运行文件夹里的启动脚本,就能看到同样的界面。
便携包最大的优点是“无痕”:不写注册表、不修改系统 PATH、不开机自启,非常适合在公司电脑或者临时服务器上使用。缺点是升级比较麻烦,每次都要手动下载新包替换旧文件,不像安装版一条命令就能更新。我的建议是:主力机用安装版,备用机、NAS、U盘里放便携版,按需选择。如果你经常换环境,还可以把便携包和 .openclaw 数据目录放到同一块移动硬盘里,走到哪插到哪,配置和对话记录都在。
2.4 验证安装、常用指令与版本更新频道
装好之后,除了 openclaw --version,你还需要记住几个高频指令:
openclaw gateway start:启动网关后台服务openclaw gateway stop:停止网关openclaw gateway restart:重启网关,改完配置必备openclaw doctor:检查环境健康度,一键排查常见问题openclaw skill list:查看已经安装的 Skillopenclaw update --channel stable:更新到稳定版openclaw update --channel dev:更新到开发版
这里要特别说一下 stable 和 dev 的选择。OpenClaw 现在已经是 2.x 时代,更新频率非常快。稳定版适合日常使用,配置和接口都比较可靠;dev 版会有新 UI 和实验功能,但也可能改配置格式、引入新机制,如果你正在跑重要工作流,不要轻易切 dev 频道。我自己的习惯是:稳定版长期驻留,dev 版只在小号环境里试。另外,不管用哪个频道,升级前最好把 .openclaw 整个目录备份一下,一旦新版配置不兼容,直接删掉新配置、还原旧目录就能回滚,这招救过我很多次。
3. 配置 88API:拿 Key、填参数、接上 Claude Opus 4.6
3.1 注册、创建 Key 与安全习惯
去 88API 官网注册一个账号,登录后进入控制台。在左侧菜单找到“API Keys”或“令牌管理”,创建一个新的 Key。创建成功后你会看到一串类似 sk-xxxx 的字符串,请立刻复制保存到密码管理器里,或者写进本地的 .env 文件。
有几个安全习惯我希望大家从一开始就养成:不要把 Key 截图发到群里,不要提交到 Git 仓库,不要在教程评论区贴出自己的 Key。这串字符串本质上就是钱,别人拿到它就能用你的账户调用模型,烧掉的可都是你的余额。很多聚合平台都支持设置额度上限、创建多个子 Key、按项目隔离权限,我建议你花两分钟把额度上限配上,哪怕后面真的不小心泄露了,损失也能控制在可接受范围内。
创建 Key 之后,你还需要在控制台确认两个关键信息:模型 ID 和 Base URL。模型 ID 一般是 claude-opus-4.6 之类的命名,Base URL 长这样:https://api.88api.com/v1。不同平台的命名可能略有差异,以 88API 使用文档里的模型列表为准。我第一次配置的时候就因为想当然地用错了模型 ID,结果模型一直报错,后来去文档页复制官方 ID 才解决。这种低级错误,其实靠文档就能完全避免。
3.2 在 OpenClaw 里配置模型供应商
OpenClaw 提供了两种配置方式:Web 界面操作和直接改配置文件。对于小白,我更推荐先打开 Web 界面:启动网关后,浏览器访问 http://127.0.0.1:8765,在设置里找到“Model Provider”或“模型供应商”,选择 OpenAI Compatible Provider 类型,然后填入三项关键信息:
text复制Base URL: https://api.88api.com/v1
Model ID: claude-opus-4.6
API Key: sk-xxxx(你刚创建的那串)
保存之后,新建一个会话,选择这个模型,就可以开始对话了。如果你更喜欢直接改配置,OpenClaw 的配置文件通常位于 ~/.openclaw/ 目录下,你可以在配置里找到 models 相关的 JSON 块,格式大致如下:
json复制{
"models": [
{
"id": "claude-opus-4.6",
"provider": "88api",
"baseUrl": "https://api.88api.com/v1",
"apiKeyEnv": "OPENCLAW_API_KEY"
}
]
}
注意这里我用的是 apiKeyEnv,而不是把明文 Key 写死在 JSON 里。配置文件的改动往往会被同步到各种共享目录或者版本仓库里,明文放 Key 风险太高。正确做法是先把 Key 写入系统环境变量 OPENCLAW_API_KEY,然后让配置去引用这个环境变量。改完配置后一定要重启网关:openclaw gateway restart,不重启的话大概率不生效。这个“改完配置不重启”的坑,我踩过太多次,后面排查部分再展开。
3.3 进阶玩法:Skill 机制让 Opus 4.6 从“会聊”到“会做”
很多用户接上模型之后,发现 OpenClaw 只是一个“网页版聊天窗口”,这其实远远没有发挥它的价值。让 OpenClaw 真正好用起来的机制叫 Skill(技能)。
你可以把 Skill 理解成给模型装的“外挂工具”。模型再聪明,本质上也只是一个会输出的文字处理引擎;但一旦挂了 Skill,它就能执行脚本、创建文件、调用接口、操作浏览器。比如你可以写一个非常简单的 Skill,让模型把回答自动保存为 Markdown 文件,放到指定目录:
yaml复制name: save-to-file
description: 将模型的回答保存为 Markdown 文件
commands:
- write-file:
path: "{workspace}/output.md"
content: "{response}"
这个 YAML 文件放进 ~/.openclaw/skills/ 目录,重启一下网关,就能在对话里通过指令触发了。更复杂的 Skill,比如自动整理 Obsidian 笔记、定时抓取网页、跑 Python 脚本,原理都是相通的:给模型一个明确的工具接口,让它按你的规则去调用。
这里顺便说一下 OpenClaw 和 ClawHub 的区别:OpenClaw 是底座运行时,ClawHub 是它的扩展市场。你可以在 ClawHub 上找别人做好的现成 Skill,一键安装,也可以自己写 Skill 放进去。类比一下:OpenClaw 是手机系统,ClawHub 是应用商店,Skill 就是里面的 App。你不需要每个 Skill 都自己写,先在应用商店里翻一遍,大概率能找到满足需求的现成方案。
3.4 多模型混跑:Ollama、NVIDIA NIM、阿里云与免费额度
OpenClaw 不绑定某个云端模型供应商,支持同时配置多个模型通道。这就带来一个很实用的玩法:省钱。比如日常问题用 Ollama 本地模型或者 88API 赠送的免费模型额度来处理,遇到复杂推理、代码生成、长文总结这类硬任务时,再切换到 Claude Opus 4.6。配置方法很简单,在模型供应商列表里继续添加一个 Provider 就行,本地 Ollama 的服务地址一般是 http://127.0.0.1:11434/v1。
NVIDIA NIM 这个方向也想提一下。如果你跑的是 NVIDIA 显卡,而且对推理微服务感兴趣,NIM 同样提供 OpenAI 兼容接口,OpenClaw 里把 Base URL 换成 NIM 的服务地址即可接入,不需要额外写代码。还有一个高频问题:“阿里云 API 能加到飞牛 NAS 上的 OpenClaw 里吗?”答案是能。OpenClaw 本身不挑设备,飞牛这类 NAS 系统只要能跑 Docker 或者 Node 服务,把阿里云百炼的兼容地址和 Key 配置进去,它就会成为 OpenClaw 里的一个可用模型通道。说白了,OpenClaw 的模型接入核心就是三件套:Base URL、模型 ID、API Key,换任何供应商都是这么配。
4. 实测记录:三分钟跑通直连 Claude Opus 4.6
4.1 动手前的检查清单
在开始计时之前,我习惯先做一次快速检查,避免中途卡壳浪费时间。你需要确认三件事:第一,浏览器能正常打开 88API 控制台,说明服务可达;第二,OpenClaw 已经装好,openclaw --version 能正常输出;第三,手里有一串有效的 API Key,并且账户里有足够调用的余额。如果这三项都满足,下面这套流程大概率能在 3 分钟内走完。
检查清单的意义在于把变量控制住。很多新手装不上、连不通,往往不是配置错,而是基础环境不对。你花两分钟把这些前置条件过一遍,后面所有步骤都会顺畅很多。
4.2 五步完成从零到直连
我把我自己的操作序列拆成五步,你可以照着做。
第一步,启动网关。在 PowerShell 里执行:
powershell复制openclaw gateway start
看到类似 gateway started 或者 listening on 127.0.0.1:8765 的日志,说明后台服务已经起来了。
第二步,打开 Web 界面。浏览器访问 http://127.0.0.1:8765,看到 OpenClaw 的登录页或主界面就算成功。如果你绑定了本地账号,直接登录;如果没有,默认情况下首次会引导你创建。
第三步,添加模型供应商。在设置页找到模型供应商配置,选择 OpenAI Compatible Provider,把 88API 的 Base URL、模型 ID、API Key 填进去。
第四步,新建会话并选择模型。在会话列表点“新建”,在模型选择器里找到 Claude Opus 4.6,选中它。这一步因人而异,有些版本还能自定义会话名称,方便区分任务。
第五步,发送测试消息。随便输一句“请用一句话介绍你自己”,如果几秒钟内返回正常回答,恭喜你,整条链路已经通了。
我第一次跑这套流程大概花了 3 分半,主要时间浪费在找模型 ID 上。如果你复制粘贴够快,3 分钟内完全没问题。跑通之后,你会觉得整个过程其实很简单,但从无到有就是这个感觉。
4.3 如何确认你用的真的是 Opus 4.6
接到模型之后,有一个很重要的问题:我到底有没有真的在用 Claude Opus 4.6?聚合平台上如果模型 ID 填错,有些服务不会立刻报错,而是静默地把请求路由到其他模型,这会让测试结果变得没有意义。
我实践下来,最可靠的验证方法是去 88API 控制台的调用记录里看:每次请求都会记录模型名称、token 数量、状态码、耗时。如果你看到日志里显示的模型名是 claude-opus-4.6,并且响应时间、token 消耗都正常,那基本可以确认链路正确。第二个辅助验证方式是问模型一些只有 Opus 4.6 才能答好的复杂问题,比如多步推理题、代码调试题。虽然主观判断不够严谨,但配合后台日志基本够用。第三个方式看 OpenClaw 本身的请求日志,运行 openclaw doctor 或者查看 gateway 日志文件,也能看到实际发出请求的模型标识。三处都指向同一个模型,那就放心大胆用吧。
4.4 日常化:把 OpenClaw 接到微信、飞书和 Obsidian
跑通接入之后,真正能提升效率的部分才开始。常见做法是把 OpenClaw 接到微信或者飞书这类 IM 工具上,这样你不需要打开任何额外界面,在聊天软件里就能直接调用 Claude Opus 4.6。安装方式通常是在 ClawHub 里搜索微信插件或飞书插件,按说明完成扫码授权或者 Token 绑定,然后重启网关。绑定成功之后,你在微信里发消息,OpenClaw 就会用配置好的模型回复,体验上和一个真实联系人没有区别。
我个人用得最多的场景其实是项目管理。我会在 OpenClaw 的配置里把 workspace 指到 Obsidian 的 Vault 目录,然后写一个自定义 Skill,让模型根据任务描述自动生成一份 Markdown 任务清单,存到指定日期命名的笔记里。这样每次开完会,我只要把会议记录丢给 Claude Opus 4.6,它就能整理出清单,我再去 Obsidian 里微调。整个过程不离开聊天界面,也不需要手动复制粘贴多个工具之间,效率提升是实打实的。这种组合玩法其实没有标准答案,你完全可以根据自己的工作流,把各种工具跟 OpenClaw 拼在一起,拼出最适合自己的形态。
5. 常见问题与排查技巧实录
5.1 “openclaw 无法识别为 cmdlet”怎么办
这个问题在 Windows 上太常见了。有次我帮一个朋友远程排查,他装了三次还是提示同样的错误。后来发现是他打开了旧的那个 PowerShell 窗口,环境变量一直没刷新。所以第一步一定是关掉当前终端,重新开一个新窗口,再执行 openclaw --version。
如果新窗口还是不行,打开系统设置,检查环境变量 PATH 里有没有 OpenClaw 的安装目录;没有就手动添加。另外,少数安全软件会拦截安装脚本,导致程序文件没写全,把 OpenClaw 目录加入信任列表之后重新安装一次,基本都能解决。最后提醒一下,安装的时候别开着一堆杀毒软件实时监控,有些安全策略会把脚本的执行环节整个拦掉,从源头卡死你。
5.2 网关一直卡在“启动中”
先看日志,再谈别的。运行 openclaw doctor 能快速自检,或者直接去 .openclaw 目录找日志文件,看看卡住之前最后一行输出的是什么。常见的三种情况:第一,端口被占用。OpenClaw 默认的 Web 端口是 8765,如果之前有残留进程占着这个端口,新实例就会一直等。在 Windows 上可以执行 netstat -ano | findstr 8765 查看 PID,然后在任务管理器里结束对应进程。第二,首次启动需要拉取 Skill 索引和组件,网络慢的时候看起来就像卡住了,等一两分钟再看看。第三,配置里模型的 Base URL 或 Key 有问题,导致启动时校验连接超时。这种情况日志里通常会有 401、403 或者 timeout 字样,回到 88API 控制台核对配置即可。
5.3 exec-approvals.json 提示怎么处理
升级到新版本后,如果你在 Linux 环境启动 OpenClaw,看到类似 legacy exec approvals exist at /root/.openclaw/exec-approvals.json 的提示,不用担心,这不是错误,而是新版把“指令执行审批”的存储机制改了。旧版本里 Skill 要执行本地命令时记录的批准文件还在,新版本希望你把旧数据迁移到新的存储格式里。
处理方式有两种:如果你希望保留原来的审批结果,运行提示里建议的命令查看并迁移即可;如果你平时几乎不用自动执行 Skill,那直接在备份后删除这个 json 文件,让它用新格式重新生成。核心原则是:这个提示不会阻止 OpenClaw 正常启动,但也不能完全无视,因为每次启动都会出现,而且旧文件可能指向你很久以前授权的命令,留着有安全风险。我个人的习惯是定期清空这类历史授权,宁可每次执行时重新确认,也不想留下一个巨大的“白名单后门”。
5.4 关停与重启的正确姿势
很多用户以为关掉浏览器标签页就是关闭 OpenClaw,其实后台网关还在跑。正确的关闭方式有两种:一是系统托盘图标右键退出,二是命令行执行 openclaw gateway stop。需要重启时执行 openclaw gateway restart。
如果某一次进程卡死,Windows 上打开任务管理器结束同名进程;Linux 上执行:
bash复制ps aux | grep -i openclaw
找到 PID 之后再 kill -9 强杀。强杀是最后的办法,不建议日常使用,因为频繁强杀可能导致配置写入不完整。更稳妥的做法是:先 openclaw gateway stop,等几秒再去检查进程是否还在,实在不行才动用 kill。
5.5 其他高发坑与避坑建议速查
最后我整理几个实战中容易被忽略的坑,按优先级排个序:
| 现象 | 原因 | 处理办法 |
|---|---|---|
| 改了配置不生效 | 没有重启网关 | 执行 openclaw gateway restart |
| 请求返回 401/403 | API Key 错误或过期 | 去 88API 控制台重新生成 Key |
| 模型回复很慢 | 选错了模型或网络波动 | 确认模型 ID,检查后台调用记录 |
| 对话记录找不到了 | workspace 路径被改动 | 确认 .openclaw/workspace 完整性 |
| 多设备同步同一个目录冲突 | 锁文件问题 | 不要共享同一份数据目录,用便携包分开 |
还有一个容易被忽略的点:在 NAS 或者云服务器上跑 OpenClaw 时,要确保系统时间准确,否则一些基于签名的 API 校验会失败,表现就是“明明 Key 没错却一直鉴权失败”。这个问题排查起来非常隐蔽,我也是踩过一次才长记性。另外,如果你同时跑了多个 AI 工具,注意别让它们共用同一个端口配置,尽量给 OpenClaw 留一个干净独立的环境。
最后分享一个我个人的使用习惯:不要让 Claude Opus 4.6 处理所有的请求。日常的天气查询、简单问答、邮件草稿这类任务,我用本地小模型或免费额度就搞定了;只有写代码、长文本分析、复杂推理这些真正要求“顶配大脑”的任务,才切到 Opus 4.6。这样做的直接好处是成本可控,而且实测下来响应速度也更好。配置上其实只需要在 OpenClaw 里同时添加两三个 Provider,用的时候手动选择就行。如果你不知道怎么判断什么时候该切,有一个很实用的标准:当你发现模型在同一个问题上反复绕圈子、给不出可执行结论的时候,就是时候换 opus 了。好了,教程到这里就结束了,剩下的事情交给你的想象力。
