Skip to content

OpenClaw 配置指南

什么是 OpenClaw

OpenClaw 是一个开源的个人 AI 助手框架,支持通过 Telegram、Discord、WhatsApp 等平台与 AI 聊天。

安装

macOS / Linux

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

Windows (PowerShell)

powershell
iwr -useb https://openclaw.ai/install.ps1 | iex

npm 安装

bash
npm install -g openclaw@latest

初始化配置

运行初始化命令:

bash
openclaw onboard --install-daemon

配置 ai.TokenHub

OpenClaw 支持 OpenAI 兼容协议,可以直接配置 ai.TokenHub 作为 API 提供商。

方法 1:使用 onboard 向导

? Select your AI provider:
> Custom (Third-party/Aggregation Platform)

? Enter the base URL:
https://ai-tokenhub.com/v1

? Enter your API Key:
your_api_key_here

方法 2:手动配置

编辑配置文件 ~/.openclaw/openclaw.json

json
{
  "model": "anthropic/claude-sonnet-4-20250514",
  "models": {
    "providers": {
      "openai": {
        "apiKey": "your_api_key_here",
        "baseURL": "https://ai-tokenhub.com/v1"
      }
    }
  }
}

模型配置

使用 Claude 模型

json
{
  "models": {
    "providers": {
      "anthropic": {
        "apiKey": "your_api_key_here",
        "baseURL": "https://ai-tokenhub.com/v1"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-20250514"
      }
    }
  }
}

使用 GPT 模型

json
{
  "models": {
    "providers": {
      "openai": {
        "apiKey": "your_api_key_here",
        "baseURL": "https://ai-tokenhub.com/v1"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-4o"
      }
    }
  }
}

配置多个模型

json
{
  "models": {
    "mode": "merge",
    "providers": {
      "anthropic": {
        "apiKey": "your_api_key_here",
        "baseURL": "https://ai-tokenhub.com/v1"
      },
      "openai": {
        "apiKey": "your_api_key_here",
        "baseURL": "https://ai-tokenhub.com/v1"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-20250514",
        "fallbacks": [
          "openai/gpt-4o",
          "openai/gpt-4o-mini"
        ]
      }
    }
  }
}

常用命令

查看配置

bash
openclaw config show

检查状态

bash
openclaw gateway status

打开控制台

bash
openclaw dashboard

切换模型

在聊天中使用 /model 命令切换模型:

/model openai/gpt-4o

常见问题

API 错误

检查 API Key 是否正确,以及账户是否有足够的余额。

连接超时

检查网络连接,确保可以访问 https://ai-tokenhub.com

模型未找到

确保模型名称拼写正确,使用 /model 从列表中选择。