OpenClaw 作为轻量高效的 AI Agent 调度平台,凭借灵活的扩展性成为开发者连接多模型的首选工具。但官方默认配置仅支持有限接口,对于追求低成本、高稳定性的开发者来说,接入第三方 API是更优解 —— 不仅能大幅降低 token 消耗,还能规避网络环境限制,无缝适配 Claude 全系列模型。本文将从「配置逻辑→实操步骤→问题排查」全程拆解,即使是新手也能快速上手。

在这里插入图片描述

参考github上本机私有部署的命令,在Mac上执行,node的版本最低要求22。

官网:OpenClaw

安装命令

npm install -g openclaw@latest

启动命令

openclaw onboard --install-daemon

启动完成后,就跟着下面的图片一行一行操作即可


在这里插入图片描述
我下面选择的是三方的模型,如果你没有三方的,可以看下面的文章进行获取 API key:
【Claude】全网最新超详细ClaudeAPI KEY调用教程!(claude-4.5)
在这里插入图片描述

在这里插入图片描述

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述
启动完成
在这里插入图片描述
当我们启动成功的时候,进行提问,会出现16000相关的报错。如下:

⚠️ Agent failed before reply: Model context window too small (4096 tokens). Minimum is 16000.
Logs: openclaw logs --follow

Model context window too small (4096 tokens) 报错,核心原因是:虽然你配置了 claude-3-5-haiku-latest 模型,但 OpenClaw 实际识别到的该模型上下文窗口还是 4096(而非预期的 200k)—— 问题出在 models.json 中未明确指定 contextWindow 字段,导致系统默认识别为 4096。

此时我们需要进行下面的命令,调整token

open ~/.openclaw/openclaw.json

打开配置后我们需要调整"contextWindow"配置,把他配置成200000。如下:
在这里插入图片描述
当我们保存后。然后openclaw gateway stop停止服务,在启动服务openclaw gateway --port 18789。访问链接:http://127.0.0.1:18789/chat
在这里插入图片描述

在这里插入图片描述
这样就可以进行操作了。

更多命令可参考下方文章:

【AI领域】OpenClaw 实战指南:手把手教你接入三方 API 完美支持 Claude、openai等大模型

【AI领域】OpenClaw 从零到精通:命令全攻略(MAC 最新版)

【OpenAI】获取OpenAI API Key的多种方式全攻略:从入门到精通,再到详解教程!

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐