北洋API接入文档教程
    • #站点操作指南-快速上手调用大模型API
    • 龙虾上下文解决方案
    • 价格-充值-分组-模型价格介绍
    • Hermes部署指南
    • ClaudeCode使用CCswitch配置说明
    • ClaudeDesktop桌面版安装对接北洋api教程
    • claudecode安装教程(win/mac)
    • GPT-codex安装教程
    • VScode安装cc插件教程(未安装CC终端使用)
    • 北洋API接入chatbox
    • 北洋API接入Cherry Studio
    • 北洋Api接入vscode的continue插件
    • gpt-image-2配置-生图模型
    • WorkBuddy对接北洋api自定义
    • openclaw相关
      • openclaw-win一键安装
      • openclaw接入北洋api模型配置教程
      • 腾讯云openclaw接入北洋API教程
      • open claw在云服务器linux环境下通过终端配置api
      • OpenClaw 通过 cc switch 自定义接入 API 教程
      • openclaw接入byapi claude模型配置教程
    • 模型接口
      • Openai
        • 文本生成
        • 文本生成---上下文阅读
        • 图片理解
        • 图片生成(gpt-image-1)
        • 图片编辑/edits
        • 图片编辑 / 网页版
        • 函数调用 tools
        • v1/Responses / 通用
        • 创建文本嵌入
        • 批量创建嵌入
        • 文本转语音 / TTS
        • 语音转文本 / whisper-1
        • 语音转文本 / gpt-4o-transcribe
        • 音频翻译
        • Audio接口 / 输出
        • Audio接口 / 输入
        • 内容补全接口
        • 创建内容审核
        • PDF文件分析
        • deep-research / 深度研究
        • Web search / 联网搜索
        • response_format
      • Anthropic
        • 原生接口
          • 文本生成 (思考配置)
          • 图片理解
          • 文本生成
          • 文本生成 / 强制返回思考
          • 函数调用
          • Web search / 联网搜索
        • OpenAI兼容接口
          • 文本生成
          • 图片理解
          • 文本生成 / 强制返回思考
          • 函数调用
          • Web search / 联网搜索
      • Google
        • OpenAI兼容接口(推荐)
          • 文本生成
          • 文本生成 / 强制返回思考
          • 图片理解
          • 图片生成
          • 图片修改
          • 图片生成 / Imagen 4
          • 音频理解
          • 视频理解
          • 文本转语音 / TTS
          • 图片编辑(Nano-banana)
          • 图片编辑(Nano-banana) base64格式
        • Google Gemini接口
          • 文本生成
          • 文字转语音
          • 音频转文
          • 视频转文
          • 图片理解
          • 文生图片(nanobanana pro)
          • 图片编辑(nanobanana)
          • 图片编辑(nanobanana pro)
      • Midjourney
        • openai兼容/chat格式
          • MJ视频 (chat格式)
        • 原生接口
          • 文生图(Imagine)
          • 图片融合(Blend)
          • 按钮点击(Action)
          • 窗口执行(Modal)
          • 生成视频(Video)
          • 图生文(Describe)
          • 编辑图片(Edit)
          • 上传(upload)
          • 换脸(FaceSwap)
          • 缩短提示词(Shorten)
          • 查询
          • 获取种子(Seed)接口
          • 批量查询
          • 文生图 / OpenAI兼容
      • FLUX
        • /fal-ai/nano-banana 文生图
        • /fal-ai/nano-banana/edit 图片编辑
      • 文生图接口
        • flux / OpenAI兼容接口
        • flux-kontext-pro / OpenAI兼容接口
        • stable-diffusion / OpenAI兼容接口
        • ideogram / OpenAI兼容接口
        • recraftv3 / OpenAI兼容接口
        • flux携带参考图 / OpenAI兼容接口
      • Suno
        • 场景一:stems声曲分离 Vocals Instrumental
        • 生成歌曲
        • 生成歌词
        • 查询任务状态(批量)
        • 查询任务状态(单个)
      • 3D模型
        • Hunyuan3D-2
      • veo
        • 图生视频
        • 文生视频
        • 查询视频生成状态
        • 图生视频(chat格式)
      • 豆包
        • doubao-seedream-4-0-250828-文生图
        • doubao-seedream-4-0-250828-图生图
        • doubao-seedream-4-0-250828-多图生图
      • sora
        • 官方异步格式
          • 创建视频任务
          • 获取视频任务状态
          • 编辑视频(remix)
          • 获取视频内容
        • 渠道异步格式
          • 创建视频任务
          • 获取视频任务状态
          • 转存视频
          • 创建视频(带 Character)
          • 编辑视频(remix)
          • 获取视频内容
          • 创建视频任务 Copy
          • 从已生成的任务中创建角色
          • 使用故事板创建视频
        • chat格式
          • 创建绘画
        • 创建角色接口
          • 创建角色

    龙虾上下文解决方案

    龙虾上下文 16k 解决方案#

    龙虾报错 API rate limit 还有这个
    Context limit exceeded. I've reset our conversation to start fresh - please try again.
    To prevent this, increase your compaction buffer by setting agents.defaults.compaction.reserveTokensFloor to 20000 or higher in your config.
    是本地上下文配置为 16 k,需要自行修改
    1.jpg
    2.png
    OpenClaw 的模型上下文大小不是固定 16k,主要看本地配置。请检查 ~/.openclaw/openclaw.json 或 ~/.openclaw/agents/< agentId>/agent/models.json,把对应模型的 contextWindow 和 maxTokens 改成模型实际支持值。以 MiniMax-M2.5 为例,可改为 contextWindow: 196608、maxTokens: 8192。修改后重启 OpenClaw 即可。官方配置参考与 MiniMax 示例都支持这种写法。

    方法一:web页面配置那搜索 contextWindow 然后改成128000#

    3.jpg

    方法二:OpenClaw 修改上下文配置说明#

    一、问题现象#

    如果在 OpenClaw 中接入自定义模型或第三方中转模型时,模型配置里的上下文窗口写得太小,例如:
    就可能出现以下问题:​
    长对话容易失败​
    工具调用时更容易报错​
    页面提示 API rate limit reached​
    模型明明支持更大上下文,但 OpenClaw 仍按较小值处理​
    ​
    OpenClaw 官方文档说明,模型的 contextWindow 和 maxTokens 可以在配置中显式设置;主配置文件路径为 ~/.openclaw/openclaw.json,也可以在 agent 目录下使用 models.json 单独覆盖。

    二、配置文件位置#

    1)主配置文件路径#

    OpenClaw 默认主配置文件:
    官方文档已明确这一点。

    2)Agent 模型配置路径#

    如果是按 agent 单独配置模型,路径通常是:
    官方文档写明:自定义 provider 可以加在 models.providers 中,或者写在 ~/.openclaw/agents/< agentId>/agent/models.json。

    3)如果改过自定义 Agent 根目录#

    如果设置过环境变量:
    那么 agent 配置目录会被这个环境变量覆盖。官方文档也写了可通过 OPENCLAW_AGENT_DIR(或 PI_CODING_AGENT_DIR)修改 agent 配置根目录。

    三、怎么改#

    方案 A:改主配置#

    openclaw.json
    打开:
    找到你当前模型提供商对应的配置,例如:
    官方 MiniMax 示例里给出的 MiniMax-M2.5 配置就是 contextWindow: 196608、maxTokens: 8192。

    方案 B:改 agent 下的#

    models.json
    打开:
    把里面对应模型的:
    改成更合理的值,例如:

    四、建议怎么填#

    这个别乱填,别搞成“我希望它 1M 上下文所以我就写 1000000”,宇宙不是这么运行的。

    推荐原则#

    contextWindow:按模型真实支持值填写​
    maxTokens:按模型真实最大输出填写​
    如果你接的是中转平台,要看中转实际放行的上限,不是只看原厂宣传值

    以 MiniMax-M2.5 为例#

    OpenClaw 官方示例推荐:

    五、修改后要做什么#

    建议修改前先把龙虾停止:先openclaw gateway stop停止
    然后修改配置
    保存配置后,重启 OpenClaw 或对应 gateway 进程。​
    常见可用命令:
    官方文档也给了这两个命令用于检查和切换模型。 ​
    ​
    如果你是通过服务方式运行,还需要重启对应服务,例如:
    或者重启你自己的 systemd / pm2 / docker 容器。

    六、补充说明#

    OpenClaw 官方配置参考还提到:​
    自定义 provider 可以直接写到 models.providers​
    contextWindow / maxTokens 支持显式设置​
    对匹配模型时,会在显式配置和隐式 catalog 之间取更高值​
    若要完全用你自己的配置覆盖 models.json,可用 models.mode: "replace"。
    另外,官方文档现在写的是:对于 custom providers,如果这些字段省略,默认会给到 contextWindow: 200000、maxTokens: 8192。所以如果你客户那里还是 16k 或 4k,多半不是“OpenClaw 现在默认只能 16k”,而是他们本地模型配置被手动写小了,或者旧配置残留。
    修改于 2026-04-13 08:53:54
    上一页
    #站点操作指南-快速上手调用大模型API
    下一页
    价格-充值-分组-模型价格介绍
    Built with