1.获取API密钥

openclaw openclaw解答 2026-04-09 2

*   访问 **OpenClaw官方平台**（通常是其网站或开发者控制台）。
*   注册/登录账户。
*   在“**API管理**”、“**开发者设置**”或“**个人中心**”等板块，找到创建或查看API密钥的选项。
*   生成一个新的API密钥（通常是一串长字符，如 `sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`）。**请立即妥善保存，因为它通常只显示一次。**

调用API
- 认证方式：在HTTP请求头中，使用 Authorization 字段携带密钥。
```
Authorization: Bearer YOUR_API_KEY
```
- 请求地址：根据具体功能使用对应的API端点（Endpoint），
  - https://api.openclaw.com/v1/chat/completions
- 请求方法：通常是 POST。
- 请求体：以JSON格式发送请求参数。

基础使用示例

下面是一个使用 curl 和 Python 调用对话API的示例。

1.获取API密钥-第1张图片-OpenClaw下载官网 - OpenClaw电脑版 | ai小龙虾

cURL 示例

curl https://api.openclaw.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "openclaw-model-name", # 替换为具体模型名
    "messages": [
      {"role": "system", "content": "你是一个AI助手。"},
      {"role": "user", "content": "你好！"}
    ]
  }'

Python 示例 安装 requests 库（如果未安装）：

pip install requests

然后使用以下代码：

import requests
import json
url = "https://api.openclaw.com/v1/chat/completions"
api_key = "YOUR_API_KEY"  # 替换为你的真实密钥
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {api_key}"
}
data = {
    "model": "openclaw-model-name",  # 替换为具体模型名
    "messages": [
        {"role": "system", "content": "你是一个AI助手。"},
        {"role": "user", "content": "你好！"}
    ]
}
response = requests.post(url, headers=headers, json=data)
if response.status_code == 200:
    result = response.json()
    print(result['choices'][0]['message']['content'])
else:
    print(f"请求失败，状态码: {response.status_code}")
    print(response.text)

关键注意事项

API密钥就是密码：请绝对不要将API密钥直接提交到代码仓库（如GitHub）、客户端应用或任何公开场合。

安全存储：推荐使用环境变量来管理密钥。

# 在终端中设置（临时）
export OPENCLAW_API_KEY='your-api-key-here'
# 在Python代码中读取
import os
api_key = os.getenv("OPENCLAW_API_KEY")

查看官方文档：具体参数（如支持哪些model）、可用端点（Endpoints）、速率限制和计费方式等，务必以 OpenClaw官方API文档 为准，这是最准确、最及时的信息来源。
错误处理：常见错误码如 401（密钥无效）、429（请求过快）、400（参数错误）等，请在代码中做好处理。
模型名称："model" 字段需要填写OpenClaw平台提供的具体模型标识符，"claw-3.5" 或 "claw-4.0" 等，请查阅文档。