OpenClaw安装与配置指南之如何使用自定义模型提供商

发布时间：2026-05-22 12:02:56 作者：Jeff Me

我要评论

OpenClaw 是 2026 年初爆火的开源本地 AI 智能体框架，这篇文章主要为大家详细介绍了OpenClaw安装与配置指南，以及如何使用自定义模型提供商，有需要的小伙伴可以参考一下

系统要求

操作系统: Linux / macOS / Windows
Node.js: v18.0.0 或更高版本
npm: v9.0.0 或更高版本
内存: 建议 2GB 以上

基础安装

安装 Node.js 和 npm

使用 nvm (Node Version Manager) 安装：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 重新加载配置
source ~/.bashrc
# 安装 Node.js
nvm install 22
nvm use 22

安装 OpenClaw

# 全局安装 OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version

初始化 OpenClaw

# 运行初始化向导
openclaw onboard

初始化过程会：

创建配置目录 ~/.openclaw/
生成默认配置文件 openclaw.json
设置工作空间目录
配置认证令牌

配置自定义模型

配置文件位置

~/.openclaw/openclaw.json

添加自定义模型提供商

编辑 openclaw.json，在 models.providers 中添加新的提供商配置：

示例 1: OpenAI 兼容 API (如 CrazyRouter)

{
  "models": {
    "mode": "merge",
    "providers": {
      "crazyrouter": {
        "baseUrl": "https://crazyrouter.com/v1",
        "apiKey": "sk-your-api-key-here",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

示例 2: Anthropic 兼容 API (如 MiniMax)

{
  "models": {
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimax.io/anthropic",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "MiniMax-M2.1",
            "name": "MiniMax M2.1",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 15,
              "output": 60,
              "cacheRead": 2,
              "cacheWrite": 10
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

API 类型说明

OpenClaw 支持两种主要的 API 格式：

openai-completions: OpenAI Chat Completions API 格式

适用于: OpenAI, Azure OpenAI, 各种 OpenAI 兼容服务

anthropic-messages: Anthropic Messages API 格式

适用于: Anthropic Claude, 兼容 Anthropic API 的服务

设置默认模型

在 agents.defaults.model 中设置主模型：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "crazyrouter/claude-opus-4-6"
      }
    }
  }
}

格式: <provider>/<model-id>

配置 API 密钥

方法 1: 直接在配置文件中

{
  "models": {
    "providers": {
      "your-provider": {
        "apiKey": "your-api-key-here"
      }
    }
  }
}

方法 2: 使用环境变量

export OPENCLAW_PROVIDER_APIKEY="your-api-key-here"

方法 3: 使用认证配置

{
  "auth": {
    "profiles": {
      "provider:default": {
        "provider": "your-provider",
        "mode": "api_key"
      }
    }
  }
}

频道配置

Telegram 配置

获取 Bot Token

在 Telegram 中找到 @BotFather
发送 /newbot 创建新机器人
按提示设置名称和用户名
获取 Bot Token

配置 Telegram

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your-bot-token-here",
      "dmPolicy": "pairing",
      "groupPolicy": "open",
      "streamMode": "partial"
    }
  }
}

配置说明:

dmPolicy: 私聊策略 (pairing 需要配对, open 开放)
groupPolicy: 群组策略 (open 开放, whitelist 白名单)
streamMode: 流式输出模式 (partial 部分流式, full 完整流式)

Discord 配置

获取 Bot Token

访问 Discord Developer Portal
创建新应用
在 Bot 选项卡中创建 Bot
复制 Token
启用必要的 Intents (Message Content Intent)

配置 Discord

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "your-discord-bot-token",
      "groupPolicy": "open"
    }
  }
}

飞书 (Feishu) 配置

创建飞书应用

访问飞书开放平台
创建企业自建应用
获取 App ID 和 App Secret
配置权限和事件订阅

安装飞书插件

openclaw plugin install @m1heng-clawd/feishu

配置飞书

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_your_app_id",
      "appSecret": "your_app_secret",
      "connectionMode": "websocket",
      "dmPolicy": "pairing"
    }
  },
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
    }
  }
}

启动与管理

启动 Gateway

# 启动 WebSocket Gateway (默认端口 18789)
openclaw gateway --port 18789

# 后台运行
openclaw gateway --port 18789 &

# 绑定到所有网络接口
openclaw gateway --port 18789 --bind 0.0.0.0

查看状态

# 查看健康状态
openclaw health

# 查看服务状态
openclaw status

# 查看会话列表
openclaw sessions

停止服务

# 停止 Gateway
openclaw gateway stop

# 或使用 systemctl (如果配置了服务)
systemctl --user stop openclaw-gateway.service

升级 OpenClaw

# 升级到最新版本
npm update -g openclaw

# 验证版本
openclaw --version

WebUI 访问

启动 Gateway 后，可以通过浏览器访问 WebUI：

http://localhost:18789

认证令牌: 在 openclaw.json 的 gateway.auth.token 中查看

常见问题

422 Unsupported request body 错误

原因: API 请求格式不兼容

解决方案:

检查 api 字段是否正确 (openai-completions 或 anthropic-messages)
确认模型 ID 是否正确
验证 API 提供商是否支持该格式

端口已被占用

错误: Address already in use

解决方案:

# 查找占用端口的进程
lsof -i :18789

# 停止现有服务
openclaw gateway stop

# 或使用不同端口
openclaw gateway --port 18790

插件 ID 重复警告

警告: Duplicate plugin ID: feishu

解决方案: 这是已知的配置警告，不影响使用，可以忽略。

无法连接到 Gateway

错误: disconnected [WS] unauthorized gateway token missing

解决方案:

检查 Gateway 是否正在运行: openclaw health
验证认证令牌是否正确
检查防火墙设置
尝试使用 127.0.0.1 而不是 localhost

模型调用失败

检查清单:

API Key 是否正确
baseUrl 是否可访问
模型 ID 是否存在
API 格式是否匹配
网络连接是否正常

配置文件完整示例

{
  "meta": {
    "lastTouchedVersion": "2026.2.15",
    "lastTouchedAt": "2026-02-18T00:00:00.000Z"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "openai": {
        "baseUrl": "https://api.openai.com/v1",
        "apiKey": "sk-your-openai-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-4",
            "name": "GPT-4",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 30,
              "output": 60,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      },
      "anthropic": {
        "baseUrl": "https://api.anthropic.com",
        "apiKey": "sk-ant-your-key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-3-5-sonnet-20241022",
            "name": "Claude 3.5 Sonnet",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 3,
              "output": 15,
              "cacheRead": 0.3,
              "cacheWrite": 3.75
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-3-5-sonnet-20241022"
      },
      "workspace": "~/.openclaw/workspace",
      "maxConcurrent": 4
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your-telegram-bot-token",
      "dmPolicy": "pairing",
      "groupPolicy": "open"
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "your-generated-token"
    }
  }
}

有用的命令

# 查看帮助
openclaw --help
openclaw gateway --help

# 查看配置
cat ~/.openclaw/openclaw.json

# 查看日志
tail -f ~/.openclaw/agents/main/sessions/*.jsonl

# 测试 API 连接
curl -X POST https://your-api-endpoint/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model","messages":[{"role":"user","content":"test"}]}'

# 备份配置
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

到此这篇关于OpenClaw安装与配置指南之如何使用自定义模型提供商的文章就介绍到这了,更多相关OpenClaw安装与配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

Tag：OpenClaw 安装配置

OpenClaw Skills 安装与配置指南
本文介绍了OpenClawSkills的概念、获取途径、安装方式、推荐Skills及配置方法,通过ClawHub官网、GitHub仓库等获取Skills,使用ClawHubCLI或OpenClawCLI安装,文章还提供了安
2026-05-18
OpenClaw安装npm和Bun两种方式的原理差异与实战配置
作者在将本地AI工具链统一迁移到OpenClaw时，遭遇了npm和Bun两种包管理器的安装问题,文章详细记录了踩坑过程，梳理了两种安装方式的原理差异与依赖解析机制，并给出实战配
2026-04-30
OpenClaw(龙虾ai)安装配置API的思路与推荐方案(2026最新版)
OpenClaw 是一个开源、本地部署的 AI 智能体网关，它让你可以在自己的电脑或服务器上运行一个智能助手，通过聊天平台随时使用这个助手来完成任务,下面我们就来看看OpenClaw
2026-04-09
OpenClaw配置与自我进化技能安装的完整过程
OpenClaw是一款开源的AI智能体网关工具,它允许用户在本地部署AI助手,并通过网关将聊天应用连接到AI智能体,从而实现功能的本地化部署,这篇文章主要介绍了OpenClaw配置与自我
2026-04-01
OpenClaw安装与钉钉机器人配置总结
本指南基于Ubuntu24.04虚拟机环境，记录了从零安装 OpenClaw、配置 GLM-4.7-Flash 免费大模型 API，并最终集成钉钉机器人的全过程,具有一定的参考价值，感兴趣的可以了解一
2026-03-30
OpenClaw中Tavily网络搜索Skill的安装配置教程
Tavily 是一个 web search API，可以让你的 OpenClaw AI 助手具备搜索功能,本文将和大家详细介绍如何在 OpenClaw 中安装和使用 Tavily,有需要的小伙伴可以跟随小编一起学习
2026-03-27
OpenClaw汉化版从零部署指南:手把手带你完成安装与进阶配置
本文将为你提供一份从零开始的详细安装指南，涵盖前提条件、安装流程、初始化配置、运行验证，再到进阶配置、模型调优、守护进程管理等完整链路,无论你是初学者还是希望深
2026-03-24
OpenClaw模型配置与切换的过程和遇到的问题解决方案
OpenClaw是一款开源的AI智能体网关工具,它允许用户在本地部署AI助手,并通过网关将聊天应用连接到AI智能体,从而实现功能的本地化部署,这篇文章主要介绍了OpenClaw模型配置与
2026-03-23
Mac安装和配置OpenClaw的超详细保姆级教程(附 skills安装)
OpenClaw是一个开源的AI助手框架,支持多模型接入和技能扩展,适用于多渠道聊天,文章详细介绍了Mac上安装和配置OpenClaw的步骤,包括安装OpenClaw CLI、验证安装、完成onboard
2026-03-12
OpenClaw连接飞书插件安装、配置与踩坑记录完整指南
2026年OpenClaw(前身为Moltbot)凭借轻量化部署、强大的AI任务执行能力与灵活的生态集成特性,成为企业智能化办公的核心工具，这篇文章主要介绍了OpenClaw连接飞书插件安装、
2026-03-10