API 指南

先把 API Key 拿对,再继续安装

很多新手不是卡在命令,而是卡在“拿错了 Key”。这页先带你把 DeepSeek 路线走通,再把其他主流平台的入口放齐。只要先拿到正确的 API Key,后面的配置就会顺很多。

先把这件事理解对

你在网页里能聊天,不代表你已经有能给程序调用的 API Key。

API Key 是什么

  • 1. API Key 是给程序调用大模型的密钥。
  • 2. 它不是网页聊天会员,也不是登录密码。
  • 3. 你后面要配给龙虾机器人和 OpenClaw 的,就是它。
  • 4. 拿到以后不要随便发群里,也不要外传截图。

最容易搞混的点

你能在某个平台网页里正常聊天,通常只说明账号能用,不说明 API 也已经开好了。真正要接进程序的,一定是开放平台里创建出来的开发者 Key。

先走通 DeepSeek 这一条

如果你是第一次配置龙虾机器人,DeepSeek 通常是最省事的起步路线。

1

打开 DeepSeek API Keys 页面

https://platform.deepseek.com/api_keys

如果你还没登录,打开后会先进入登录页。

2

完成登录并进入 API Keys 管理页

先输入手机号并完成验证码登录,然后确认自己进入的是开发者平台里的 API Keys 页面。

DeepSeek 登录步骤标注图
3

创建新的 API Key 并立刻复制保存

登录后找到左侧或页面上方的 API Keys,然后点击 Create API Key

DeepSeek 创建 API Key 标注图
  • - 创建完成后立刻复制。
  • - 先粘贴到记事本确认完整。
  • - 不要把 Key 和截图随便发出去。
4

回到 OpenClaw 里完成 onboarding

openclaw onboard --install-daemon

向导里选择 DeepSeek,系统提示输入 API Key 时,把刚复制的 Key 粘贴进去,然后立刻做一次最小测试。

其他平台也已经整理好

如果你后面不想只用 DeepSeek,可以直接点进对应平台的详细图文页。

通义千问 / Qwen

适合后面想继续走阿里云生态、文本 + 视觉 + 语音一起接的用户。

官方入口
https://bailian.console.aliyun.com/?tab=model#/api-key
  1. 1. 登录阿里云百炼
  2. 2. 进入密钥管理页
  3. 3. 创建 API Key
  4. 4. 回到 OpenClaw 完成配置

GLM / 智谱 / Z.AI

适合想走中文能力、Agent 工具链和多模态路线的用户。

官方入口
https://z.ai/manage-apikey/apikey-list
  1. 1. 进入 Z.AI 开放平台
  2. 2. 创建 API Key
  3. 3. 确认拿到的是程序调用 Key
  4. 4. 在 OpenClaw 里选择 Z.AI / GLM

Kimi / Moonshot

适合经常处理长文档、长上下文和资料整理的用户。

官方入口
https://platform.moonshot.cn/console/api-keys
  1. 1. 进入 Moonshot 平台
  2. 2. 创建 API Key
  3. 3. 复制保存 Key
  4. 4. 在 OpenClaw 中走 Moonshot 配置路线

OpenAI

适合已经熟悉海外开发者平台,后面还想继续做 Agent 或复杂工作流的用户。

官方入口
https://platform.openai.com/api-keys
  1. 1. 进入 OpenAI Platform
  2. 2. 创建 API Key
  3. 3. 确认账单和权限可用
  4. 4. 在 OpenClaw 中选择 OpenAI

如果这里报错,优先检查这四件事

大多数新手报错都集中在 Key 本身、平台选错、复制不完整和配完不测试。

1. 复制不完整

最常见。前后多了空格、少了字符、只复制到一半,都会直接导致 invalid api key。

2. 拿的是网页账号,不是 API Key

一定要确认自己进入的是开放平台或开发者平台,而不是普通聊天网页。

3. 平台和 provider 对不上

比如拿的是 DeepSeek Key,却在 OpenClaw 里配成了别的平台,这也会直接失败。

4. 配完没有立刻验证

正确做法是 Key 配好后马上发一条最短测试消息,第一时间确认链路是否真的跑通。