Linux/Mac

我来详细介绍如何配置和安装AI小龙虾OpenClawAPI密钥。

获取API密钥

注册账号

访问 OpenClaw 官网
2. 点击"注册"或"Sign Up"
3. 填写邮箱、密码等信息
4. 完成邮箱验证

创建API密钥

登录控制台（Dashboard）
2. 导航到"API Keys"或"密钥管理"
3. 点击"创建新密钥"
4. 设置密钥名称和权限
5. 复制生成的密钥（只显示一次，请妥善保存）

安装配置方法

方法1：环境变量配置（推荐）

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

方法2：配置文件方式

# config.py 或 .env 文件
OPENCLAW_API_KEY = "your-api-key-here"
API_BASE_URL = "https://api.openclaw.ai/v1"

方法3：Python SDK安装配置

# 安装SDK
pip install openclaw-sdk
# 或
pip install git+https://github.com/openclaw/openclaw-python-sdk.git

# Python代码中配置
import openclaw
# 方式1：使用环境变量（自动读取OPENCLAW_API_KEY）
client = openclaw.OpenClaw()
# 方式2：显式传入密钥
client = openclaw.OpenClaw(api_key="your-api-key")
# 方式3：从配置文件加载
import os
from dotenv import load_dotenv
load_dotenv()
api_key = os.getenv("OPENCLAW_API_KEY")
client = openclaw.OpenClaw(api_key=api_key)

验证安装

测试连接

import openclaw
# 创建客户端
client = openclaw.OpenClaw()
# 测试API
try:
    response = client.models.list()
    print("API连接成功！")
    print("可用模型：", response)
except Exception as e:
    print(f"连接失败：{e}")

不同框架的配置

Django项目

# settings.py
OPENCLAW_CONFIG = {
    'API_KEY': os.environ.get('OPENCLAW_API_KEY'),
    'TIMEOUT': 30,
}
# views.py
from django.conf import settings
import openclaw
client = openclaw.OpenClaw(api_key=settings.OPENCLAW_CONFIG['API_KEY'])

Flask项目

# app.py
from flask import Flask
import openclaw
app = Flask(__name__)
app.config['OPENCLAW_API_KEY'] = os.environ.get('OPENCLAW_API_KEY')
# 初始化
client = openclaw.OpenClaw(api_key=app.config['OPENCLAW_API_KEY'])

Node.js项目

// 安装
npm install openclaw-sdk
// 配置
const { OpenClaw } = require('openclaw-sdk');
const client = new OpenClaw({
  apiKey: process.env.OPENCLAW_API_KEY,
});
// 或使用配置文件
const config = require('./config.json');
const client = new OpenClaw(config.openclaw);

安全最佳实践

密钥存储安全

# 使用密钥管理工具
# 开发环境：.env文件（加入.gitignore）
# 生产环境：
#   - Docker Secrets
#   - Kubernetes Secrets
#   - AWS Secrets Manager
#   - HashiCorp Vault

权限控制

创建最小权限的API密钥
2. 定期轮换密钥（建议每90天）
3. 设置IP白名单（如支持）
4. 监控API使用情况

错误处理

import openclaw
from openclaw.exceptions import AuthenticationError, RateLimitError
try:
    client = openclaw.OpenClaw(api_key="your-key")
    response = client.chat.completions.create(
        model="claw-3.5",
        messages=[{"role": "user", "content": "Hello"}]
    )
except AuthenticationError:
    print("API密钥无效或已过期")
except RateLimitError:
    print("达到速率限制，请稍后重试")
except Exception as e:
    print(f"其他错误：{e}")

常见问题排查

问题1：密钥无效

解决方案：
1. 检查密钥是否正确复制（注意空格）
2. 确认账号是否已验证邮箱
3. 检查API密钥是否已启用
4. 联系技术支持

问题2：连接超时

# 增加超时设置
client = openclaw.OpenClaw(
    api_key="your-key",
    timeout=60,  # 增加超时时间
    max_retries=3  # 增加重试次数
)

问题3：版本兼容性

# 检查SDK版本
pip show openclaw-sdk
# 更新到最新版本
pip install --upgrade openclaw-sdk

进阶配置

自定义端点

client = openclaw.OpenClaw(
    api_key="your-key",
    base_url="https://your-custom-endpoint.com/v1",
    organization="your-org-id",  # 组织ID（如有）
)

代理配置

import openclaw
client = openclaw.OpenClaw(
    api_key="your-key",
    http_client=CustomHTTPClient(proxy="http://proxy:8080")
)

注意事项

1. 不要硬编码密钥到源代码中
2. 不要提交包含密钥的文件到版本控制
3. 定期检查使用量和费用
4. 关注官方更新日志和API变更通知

如果需要针对特定语言或框架的详细配置,请告诉我具体的使用场景！

标签： Linux Mac