Linux/macOS

openclaw AI小龙虾攻略 2026-04-09 1

我来为您详细介绍 AI小龙虾 OPENCLAW API 密钥的配置方法。

Linux/macOS-第1张图片-官方获取 | OpenClaw下载 - openclaw官网

🔑 获取API密钥

登录控制台
- 访问 AI小龙虾开发者平台
- 使用您的账号登录
创建应用并获取密钥
- 进入“应用管理”页面
- 点击“创建新应用”
- 选择应用类型（Web/移动端/服务端）
- 生成后即可获得：
  - API Key（客户端使用）
  - Secret Key（服务端使用，需保密！）

📁 配置方式

环境变量（推荐）

export OPENCLAW_SECRET_KEY="your-secret-key-here"
# Windows PowerShell
$env:OPENCLAW_API_KEY="your-api-key-here"
$env:OPENCLAW_SECRET_KEY="your-secret-key-here"
# Windows CMD
set OPENCLAW_API_KEY=your-api-key-here
set OPENCLAW_SECRET_KEY=your-secret-key-here

配置文件

# config.py 或 .env 文件
OPENCLAW_API_KEY = "sk-xxxxxxxxxxxxxxxx"
OPENCLAW_BASE_URL = "https://api.openclaw.ai/v1"  # API端点

代码中直接配置

import openclaw
# 初始化客户端
client = openclaw.OpenClaw(
    api_key="sk-xxxxxxxxxxxxxxxx",
    # 可选参数
    base_url="https://api.openclaw.ai/v1",
    timeout=30,
    max_retries=3
)

🛠 各语言SDK配置示例

Python

# 安装SDK
pip install openclaw-sdk
# 使用
import os
from openclaw import OpenClaw
# 从环境变量读取
client = OpenClaw(api_key=os.getenv("OPENCLAW_API_KEY"))
# 调用API
response = client.chat.completions.create(
    model="claw-3.5-turbo",
    messages=[{"role": "user", "content": "你好"}]
)

JavaScript/Node.js

// 安装
npm install openclaw
// 使用
const OpenClaw = require('openclaw');
const client = new OpenClaw({
  apiKey: process.env.OPENCLAW_API_KEY,
});
// 或直接配置
const client = new OpenClaw({
  apiKey: 'sk-xxxxxxxxxxxxxxxx',
});

cURL 示例

curl https://api.openclaw.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claw-3.5-turbo",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

🔒 安全注意事项

密钥保护
- ❌ 永远不要将密钥提交到版本控制系统（如Git）
- ❌ 不要在客户端代码中硬编码密钥
- ✅ 使用环境变量或密钥管理服务
- ✅ 定期轮换密钥
权限管理
- 根据需要创建不同权限的API密钥
- 限制IP白名单（如果支持）
- 设置使用配额和频率限制

🐛 常见问题排查

认证失败

检查密钥是否正确复制（注意前后空格）
确认密钥是否已激活
验证账户余额或配额状态

连接问题

# 调试模式
import logging
logging.basicConfig(level=logging.DEBUG)
# 或检查网络
client = OpenClaw(
    api_key="your-key",
    base_url="https://api.openclaw.ai/v1",
    timeout=60  # 增加超时时间
)

权限错误

确认密钥有对应接口的访问权限
检查API版本是否匹配
验证请求参数格式

📝 最佳实践

密钥存储

# 使用python-dotenv管理环境变量
from dotenv import load_dotenv
load_dotenv()  # 加载.env文件

多环境配置

# 根据环境使用不同密钥
import os
ENV = os.getenv("ENVIRONMENT", "development")
if ENV == "production":
    API_KEY = os.getenv("OPENCLAW_PROD_KEY")
    BASE_URL = "https://api.openclaw.ai/v1"
else:
    API_KEY = os.getenv("OPENCLAW_TEST_KEY")
    BASE_URL = "https://test-api.openclaw.ai/v1"