检查OpenClaw是否正常运行

我来帮你详细说明在 AI小龙虾OpenClaw 中配置 通义千问（Qwen） API的完整步骤。

📋 配置前准备

获取通义千问API密钥

• 访问 阿里云百炼平台
• 注册/登录阿里云账号
• 创建API Key（通常以 sk- 开头）
• 记录以下信息：
  • API Key
  • Model ID（如 qwen-max、qwen-plus、qwen-turbo）

确认OpenClaw安装状态

# 或
systemctl status openclaw

🔧 配置通义千问API

通过配置文件（推荐）

找到配置文件

# 根据你的安装方式，配置文件可能在：
# Docker安装
/opt/openclaw/config/config.yaml
# 或
/root/openclaw/config/settings.py
# 或
./config/.env

编辑配置文件

# 在配置文件中添加或修改以下内容
model_providers:
  qwen:
    enabled: true
    api_key: "sk-your-api-key-here"  # 替换为你的API Key
    api_base: "https://dashscope.aliyuncs.com/compatible-mode/v1"  # API端点
    models:
      - qwen-max
      - qwen-plus
      - qwen-turbo

或使用环境变量方式：

# 编辑 .env 文件
QWEN_API_KEY=sk-your-api-key-here
QWEN_API_BASE=https://dashscope.aliyuncs.com/compatible-mode/v1
DEFAULT_MODEL=qwen-max

通过Web界面配置

1. 启动OpenClaw Web服务

   cd /path/to/openclaw
   python app.py  # 或按照文档启动

2. 访问管理界面

   • 打开浏览器访问：http://localhost:8000（端口可能不同）
   • 登录管理员账户

3. 添加模型提供商

   • 进入 模型管理 → 提供商配置
   • 点击 添加提供商
   • 选择 通义千问 或 自定义

4. 填写配置信息

   提供商名称：通义千问
   API类型：Qwen
   API密钥：sk-xxxxxxxxxxxx
   端点URL：https://dashscope.aliyuncs.com/compatible-mode/v1
   默认模型：qwen-max

🧪 测试配置

测试API连通性

# 使用curl测试
curl -X POST "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-max",
    "messages": [{"role": "user", "content": "你好"}]
  }'

在OpenClaw中测试

# 如果你有Python环境，可以使用以下代码测试
import openai
openai.api_base = "https://dashscope.aliyuncs.com/compatible-mode/v1"
openai.api_key = "sk-your-api-key"
response = openai.ChatCompletion.create(
    model="qwen-max",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

⚙️ 高级配置

多模型配置

models:
  - name: "qwen-max"
    display_name: "千问Max"
    max_tokens: 6000
    enabled: true
  - name: "qwen-plus"
    display_name: "千问Plus"
    max_tokens: 30000
    enabled: true
  - name: "qwen-turbo"
    display_name: "千问Turbo"
    max_tokens: 6000
    enabled: true

代理设置（如果需要）

qwen:
  proxy: "http://your-proxy:port"
  timeout: 30
  max_retries: 3

🔍 常见问题排查

问题1：API密钥无效

错误：Invalid API Key
解决：
1. 确认API密钥是否正确复制（不要有空格）
2. 检查阿里云账户余额或配额
3. 确认API密钥是否启用

问题2：连接超时

错误：Connection timeout
解决：
1. 检查网络连接
2. 如果有代理，配置代理设置
3. 调整超时时间

问题3：模型不可用

错误：Model not found
解决：
1. 确认模型名称是否正确
2. 检查该模型是否在可用区域
3. 查看阿里云服务状态页

问题4：OpenClaw无法识别提供商

解决：
1. 重启OpenClaw服务
2. 检查配置文件格式（YAML缩进）
3. 查看OpenClaw日志

# 查看日志
docker logs openclaw
# 或
journalctl -u openclaw -f

📝 配置检查清单

• [ ] 获取有效的通义千问API密钥
• [ ] API密钥格式为 sk-xxxxxxxxxxxx
• [ ] 配置文件路径正确
• [ ] YAML格式缩进正确
• [ ] API端点URL正确
• [ ] 模型名称正确
• [ ] 网络可以访问 dashscope.aliyuncs.com
• [ ] 重启OpenClaw服务使配置生效
• [ ] 测试API调用正常

🔄 重启服务应用配置

# Docker方式
docker restart openclaw
# Systemd方式
systemctl restart openclaw
# 直接运行方式
pkill -f openclaw
cd /path/to/openclaw && python main.py

如果你在配置过程中遇到具体问题,可以告诉我：

1. 你的OpenClaw安装方式（Docker/源码）
2. 具体的错误信息
3. 配置文件内容（隐藏敏感信息）

我会帮你进一步分析和解决！ 🦞

标签： 运行状态 正常性