概述

本文介绍 OpenClaw 对话不可用问题的排查方法，以及 OpenClaw Gateway Token 和 IAM API Key 的区别与配置方式。

对话不可用

问题现象

访问 OpenClaw 对话页面时，提示以下错误：

1 [assistant turn failed before producing content]

原因

OpenClaw 未正确配置模型服务，常见原因包括：

• Base URL 配置错误；
• 模型名称配置错误；
• 使用了无法直接调用的预占位模型。

例如，页面中底部对话框显示的模型名称为 deepseek-v3.1-250821，但该模型仅用于预占位，无法直接使用。

处理方法

可以选择以下任一种方式配置模型服务。

方式一：在 OpenClaw 中配置模型服务

1. 创建 OpenClaw 后，进入设置页面，手动配置模型名称、模型供应商地址等信息。
2. 配置完成后，点击右上角 Save，然后重新加载页面。

3. 也可以通过直接修改 openclaw.json 配置模型服务。

方式二：在 AX AI 应用中配置模型服务

1. 在 AX 控制台中的 模型代理 模块完成模型服务配置。

2. 在 AX 控制台中的 AI 应用 模块使用已配置的模型服务创建 OpenClaw。

3. 创建完成后，OpenClaw 会使用 AX 中配置的模型服务。

鉴权说明

1. Token 和 IAM API Key 的区别

简单来说，Token 用于访问 OpenClaw，IAM API Key 用于访问 AI 应用。

2. OpenClaw Gateway Token

• 这里的 Token 指 OpenClaw Gateway Token，是 OpenClaw 使用的访问凭证。
• 通过 AI 应用预置模板 Openclaw-lite 创建的 OpenClaw，默认使用 OpenClaw 的 Gateway Token 模式。访问 WebUI 时，必须携带 Gateway Token。详情请参考 OpenClaw 官方文档。
• AI 应用访问地址会自动携带创建 OpenClaw 时设置的 Gateway Token，以参数 token=xxx 的形式，展示到访问地址中。

1token=xxx

3. IAM API Key

• IAM API Key 是 AI 应用的入站访问凭证，用于在访问 AI 应用前完成身份认证。
• 所有 AI 应用都可以配置 IAM API Key。目前支持 HTTP Header 和 URL 参数两种认证方式。

方式一：HTTP Header

请求 AI 应用访问地址时，在 HTTP Header 中添加：

1X-AX-Access-Token: <IAM API Key>

例如：

1X-AX-Access-Token: bce-v3/ALTAK-XXXX

方式二：URL 参数

请求 AI 应用访问地址时，在 URL 中添加：

1x-ax-access-token=<IAM API Key>

例如：

1x-ax-access-token=bce-v3/ALTAK-XXXX

4. 配置建议

• OpenClaw 一次访问可能会产生多个请求。仅通过 URL 参数进行鉴权时，可能只有第一个请求能够携带该参数并通过认证。
• 因此，建议安装浏览器插件，为指定的 AI 应用域名统一配置 HTTP Header，实现入站访问鉴权。