OpenAI

OpenAI 就像一个很聪明、知道很多事情的机器人朋友。OpenClaw 这个工具想和它聊天，就需要先认识它。这里有两种认识它的方法，你可以选一个。

第一种方法：用“秘密钥匙”（API Key） 这就像你有一把能打开 OpenAI 大门的钥匙。适合直接用它，并且按使用次数付钱。

1. 先拿到钥匙：你需要去 OpenAI 的网站上，找到你的 OPENAI_API_KEY，它看起来像 sk-...。
2. 告诉 OpenClaw 钥匙在哪：打开电脑的命令行（一个可以打字下命令的黑色窗口），输入命令。
   • 你可以用这个命令，它会一步步问你：openclaw onboard --auth-choice openai-api-key
   • 或者，如果你已经把钥匙放在一个叫 OPENAI_API_KEY 的地方了，可以直接告诉它：openclaw onboard --openai-api-key "$OPENAI_API_KEY"
3. 设置聊天用哪个机器人：你需要在 OpenClaw 的配置文件里写清楚。比如，你想主要用 gpt-5.4 这个机器人，就这样写：

   {
     env: { OPENAI_API_KEY: "sk-..." },
     agents: { defaults: { model: { primary: "openai/gpt-5.4" } } },
   }
   

   • 记得把 "sk-..." 换成你真正的钥匙哦！
   • openai/gpt-5.4 和 openai/gpt-5.4-pro 这两个名字都可以用。

第二种方法：用你的 ChatGPT 账号登录 这就像你直接用微信账号登录一个游戏，适合已经有 ChatGPT 会员的小朋友。

1. 让 OpenClaw 和你的账号做好朋友：打开命令行，输入命令。
   • 用这个命令，它会打开一个网页让你登录：openclaw onboard --auth-choice openai-codex
   • 或者直接用这个命令登录：openclaw models auth login --provider openai-codex
2. 设置聊天用哪个机器人：在配置文件里，这次要这样写：

   {
     agents: { defaults: { model: { primary: "openai-codex/gpt-5.4" } } },
   }
   

   • 注意，这里的名字是 openai-codex/gpt-5.4，和第一种方法不一样。

怎么让聊天更顺畅？（关于 Transport） OpenClaw 和机器人聊天，有两种“打电话”的方式，一种叫 WebSocket，一种叫 SSE。默认会先试试 WebSocket，如果不行就用 SSE。你可以在配置文件里指定用哪一种，就像选择用手机打电话还是用对讲机。

• 设置的地方在 agents.defaults.models.<provider/model>.params.transport。
• 可以填 "auto"（自动选）、"sse"（只用 SSE）或 "websocket"（只用 WebSocket）。
• 如果用 WebSocket 方式，OpenClaw 会默认先“热热身”（openaiWsWarmup: true），这样第一句话能回得快一点。如果你不想热身，可以把它改成 false。

让机器人优先回答你 OpenAI 有个“快速通道”叫 service_tier=priority。如果你想让机器人更快地回答你，可以在配置里告诉它：

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            serviceTier: "priority",
          },
        },
      },
    },
  },
}

可以填的值有 auto、default、flex 和 priority。

帮机器人整理记忆（Server-side Compaction） 当聊天内容很长时，OpenClaw 会默认请 OpenAI 机器人自己整理一下记忆，这样它能记住更多。这个功能大部分时候是自动打开的。

• 如果你想为某个机器人明确打开或关闭这个整理功能，可以设置 responsesServerCompaction 为 true 或 false。
• 你还可以设置一个数字 responsesCompactThreshold，告诉它“当记忆超过这么多字时，就开始整理”。

重要的小提醒

• 在设置里，机器人的名字永远是 提供商/模型名 这样的格式，比如 openai/gpt-5.4。
• 关于登录的更多细节，可以去看另一页说明书（/concepts/oauth）。