AI 大模型推理 > 最佳实践 > OpenClaw 安装配置指南

OpenClaw 安装配置指南

最近更新时间: 2026-03-02 16:52:07

OpenClaw 安装配置指南

1. 介绍

OpenClaw 是一个强大的 AI 代理工具，支持配置多种 AI 模型提供商。通过 OpenClaw，您可以轻松接入七牛云 AI 推理服务，使用多种先进的大语言模型来提升您的开发效率。

OpenClaw 的主要特点：

🚀 支持多模型提供商配置
🔧 灵活的配置方式
💡 开箱即用的 AI 代理能力
🔐 安全的 API Key 管理

2. 安装

主要流程

确认环境：准备 Node.js 22+（支持 macOS / Linux / Windows，Windows 建议 WSL2）。
执行安装（推荐官方脚本）：

curl -fsSL https://openclaw.ai/install.sh | bash

完成初始化：按提示完成 onboarding；若需要手动安装可使用：

npm install -g openclaw@latest
openclaw onboard --install-daemon

安装完成后检查

openclaw doctor
openclaw status
openclaw dashboard

报错处理

安装报错（包括 npm/pnpm、sharp build errors、openclaw not found 等）请直接参考官方安装文档：

https://docs.openclaw.ai/install
https://docs.openclaw.ai/install#npm-pnpm:sharp-build-errors

3. 配置七牛模型

环境变量配置

首先，设置您的七牛 API Key 环境变量：

export QINIU_API_KEY="sk-your-api-key-here"

完整配置示例

在 OpenClaw 配置文件中添加以下配置：

{
  env: { QINIU_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "qiniu/deepseek-v3.2-251201" },
      models: {
        "qiniu/z-ai/glm-5": { alias: "GLM 5" },
        "qiniu/deepseek-v3.2-251201": { alias: "DeepSeek V3.2" },
        "qiniu/moonshotai/kimi-k2.5": { alias: "Kimi K2.5" },
        "qiniu/minimax/minimax-m2.5": { alias: "Minimax M2.5" },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      qiniu: {
        baseUrl: "https://api.qnaigc.com/v1",
        apiKey: "${QINIU_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "deepseek-v3.2-251201",
            name: "DeepSeek V3.2",
            reasoning: false,
            input: ["text"],
            contextWindow: 128000,
            maxTokens: 8192,
            compat: {
              supportsStore: false,
              supportsDeveloperRole: false,
              supportsReasoningEffort: false
            }
          },
          {
            id: "moonshotai/kimi-k2.5",
            name: "Kimi K2.5",
            reasoning: false,
            input: ["text"],
            contextWindow: 256000,
            maxTokens: 8192,
            compat: {
              supportsStore: false,
              supportsDeveloperRole: false,
              supportsReasoningEffort: false
            }
          },
          {
            id: "z-ai/glm-5",
            name: "GLM 5",
            reasoning: false,
            input: ["text"],
            contextWindow: 128000,
            maxTokens: 8192,
            compat: {
              supportsStore: false,
              supportsDeveloperRole: false,
              supportsReasoningEffort: false
            }
          },
          {
            id: "minimax/minimax-m2.5",
            name: "Minimax M2.5",
            reasoning: false,
            input: ["text"],
            contextWindow: 128000,
            maxTokens: 8192,
            compat: {
              supportsStore: false,
              supportsDeveloperRole: false,
              supportsReasoningEffort: false
            }
          },
        ],
      },
    },
  },
}

配置说明

基础配置项：

baseUrl: 七牛 AI 推理服务的 API 端点：https://api.qnaigc.com/v1
apiKey: 通过环境变量 ${QINIU_API_KEY} 引用您的 API Key
api: 使用 openai-completions 协议（OpenAI 兼容）

模型引用格式

七牛云模型引用使用 qiniu/<modelId> 格式，例如：

qiniu/deepseek-v3.2-251201
qiniu/moonshotai/kimi-k2.5
qiniu/deepseek-r1
qiniu/qwen3-max
qiniu/z-ai/glm-5

获取 API Key

您可以通过以下步骤获取七牛 AI 推理服务的 API Key：

登录七牛云控制台
进入 AI 推理服务管理页面
创建或查看您的 API Key
妥善保管您的 API Key，切勿泄露

💡 使用提示

模型选择：根据您的任务需求选择合适的模型。DeepSeek V3.2 和 Qwen3 Max 适合复杂任务，DeepSeek R1 和 Kimi K2 Thinking 支持推理能力
上下文管理：注意不同模型的 contextWindow 限制，合理控制对话长度
成本优化：可以根据实际使用情况更新 cost 配置，便于成本追踪
自定义模型：如需添加更多模型，按照相同格式在 models 数组中添加即可

⚠️ 注意事项

API Key 安全：请勿在代码中硬编码 API Key，始终使用环境变量
配置更新：七牛云会不断更新可用模型列表，请关注官方文档获取最新信息
实名认证：使用七牛 AI 推理服务需要完成实名认证，详见实名认证说明
配额限制：注意您的账户配额限制，避免超额使用

🙋 需要帮助？

如在配置过程中遇到任何问题：

📖 查阅 OpenClaw 官方文档
💬 联系七牛云技术支持
📝 提交工单获取专业帮助

祝您使用愉快！开始您的 AI 开发之旅吧！ 🚀

以上内容是否对您有帮助？