OpenClaw 接入教程

配置 OpenClaw 使用 XiDao Api 作为 AI 模型提供商，支持多渠道聊天机器人部署

什么是 OpenClaw?

OpenClaw 是一个功能强大的开源 AI 助手平台，支持多智能体、多渠道部署。它可以连接 WhatsApp、Telegram、Discord 等多种聊天平台，让您在任何地方都能使用强大的 AI 能力。

提示: OpenClaw 完美兼容 OpenAI 和 Anthropic API 格式，可以无缝接入 XiDao Api 中转服务。
🤖

多智能体支持

支持创建多个专业化 AI 智能体，每个智能体可独立配置模型和身份

💬

多渠道集成

支持 WhatsApp、Telegram、Discord、Slack 等主流聊天平台

🔌

插件系统

丰富的插件生态，支持浏览器自动化、网络搜索、语音交互等

🔒

安全可靠

支持本地部署、Docker 容器化，数据完全自主可控

环境要求

在安装 OpenClaw 之前，请确保您的系统满足以下要求：

依赖 最低版本 检查命令 用途
Node.js v18+ node -v 运行 OpenClaw 核心
npm v9+ npm -v 包管理器
Git v2.23+ git --version 版本控制、插件安装
注意: 如果 Node.js 版本低于 v18，建议先升级到 LTS 版本。

安装 OpenClaw

方式一：通过 npm 安装（推荐）

bash
# 全局安装 OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version
openclaw doctor

方式二：通过 Docker 安装

bash
# 拉取并运行 OpenClaw Docker 镜像
docker run -d \
  --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 18789:18789 \
  openclaw/openclaw:latest

# 进入容器进行初始配置
docker exec -it openclaw bash

配置向导（推荐）

OpenClaw 提供了交互式配置向导，可以快速完成所有设置：

bash
# 启动配置向导
openclaw onboard

向导步骤：

1

选择模型提供商

在列表中滚动到底部，选择：
Custom Provider (Any OpenAI or Anthropic compatible endpoint)

2

输入 API Base URL

输入 XiDao Api 的地址：

text
# 国内用户
https://api.xidao.online/v1

# 全球加速用户
https://global.xidao.online/v1
3

选择 API Key 输入方式

选择：
Paste API key now（立即粘贴密钥）

4

粘贴 API Key

粘贴你的 XiDao Api Key（格式为 sk-xxxxxxxx）

获取 API Key：登录 https://api.xidao.online → 令牌管理 → 复制令牌
5

选择端点兼容性

选择：
OpenAI-compatible (Uses /chat/completions)

6

设置默认模型

输入你想使用的模型 ID，例如：

text
# 推荐选项
claude-sonnet-4-20250514   # Claude Sonnet 4.5（性价比高）
gpt-5.1                     # GPT-5.1（通用性强）
gemini-2.5-flash            # Gemini Flash（快速响应）
7

验证并完成

OpenClaw 会自动验证配置。成功后会生成 Endpoint ID（如 custom-api-xidao-online）

手动配置

如果你想手动编辑配置文件，可以使用以下方法：

编辑配置文件

bash
# 打开配置目录
cd ~/.openclaw

# 编辑配置文件
nano openclaw.json
# 或使用 VS Code
code openclaw.json

配置示例

json
{
  "models": {
    "providers": {
      "xidao": {
        "name": "XiDao Api",
        "type": "openai",
        "base_url": "https://api.xidao.online/v1",
        "api_key": "${XIDAO_API_KEY}",
        "models": [
          {
            "id": "claude-sonnet-4-20250514",
            "name": "Claude Sonnet 4.5",
            "description": "平衡性能与速度"
          },
          {
            "id": "gpt-5.1",
            "name": "GPT-5.1",
            "description": "通用编程助手"
          },
          {
            "id": "gemini-2.5-flash",
            "name": "Gemini 2.5 Flash",
            "description": "快速响应"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "xidao/claude-sonnet-4-20250514",
        "fallbacks": [
          "xidao/gpt-5.1",
          "xidao/gemini-2.5-flash"
        ]
      }
    }
  }
}
成功! 配置完成后，运行 openclaw gateway start 启动服务。

环境变量配置（推荐）

为了安全起见，建议将 API Key 存储在环境变量中：

bash
# 创建或编辑环境变量文件
nano ~/.openclaw/.env

# 添加以下内容（将 YOUR_API_KEY 替换为你的实际密钥）
XIDAO_API_KEY=sk-your-api-key-here
安全提醒: 请勿将 .env 文件提交到 Git 仓库！设置文件权限：chmod 600 ~/.openclaw/.env

使用命令行设置

bash
# 设置 API Key
openclaw config set XIDAO_API_KEY sk-your-api-key-here

# 验证设置
openclaw config get models.providers.xidao.apiKey

使用方法

启动 Gateway 服务

bash
# 启动 Gateway（后台运行）
openclaw gateway start

# 查看状态
openclaw gateway status

# 停止服务
openclaw gateway stop

# 重启服务（配置修改后）
openclaw gateway restart

访问 Web 控制面板

bash
# 启动 Dashboard
openclaw dashboard

# 浏览器访问 http://localhost:18789

开始对话

启动后可以通过以下方式使用：

方式 命令/操作 说明
命令行 openclaw chat 直接在终端交互式对话
Web UI http://localhost:18789 浏览器访问控制面板
Telegram 配置 Bot Token 连接 Telegram 机器人
Discord 配置 Bot Token 连接 Discord 服务器

常用命令

bash
# 查看当前配置
openclaw config

# 编辑配置
openclaw config edit

# 检查配置问题
openclaw doctor

# 查看日志
openclaw logs

# 切换智能体（如果配置了多个）
/agent <agent-id>

# 清除会话上下文
/clear

核心功能介绍

🔄 模型回退机制

当主模型不可用（如限速、服务中断）时，OpenClaw 会自动切换到备用模型，确保服务连续性。

json
"agents": {
  "defaults": {
    "model": {
      "primary": "xidao/claude-sonnet-4-20250514",
      "fallbacks": [
        "xidao/gpt-5.1",
        "xidao/gemini-2.5-flash"
      ]
    }
  }
}

🤖 多智能体配置

可以为不同场景创建专门的智能体，每个智能体有独立的身份和配置。

json
"agents": {
  "list": [
    {
      "id": "coder",
      "name": "代码助手",
      "emoji": "💻",
      "model": { "primary": "xidao/claude-sonnet-4-20250514" }
    },
    {
      "id": "writer",
      "name": "写作助手", 
      "emoji": "✍️",
      "model": { "primary": "xidao/gpt-5.1" }
    }
  ]
}

🧠 上下文管理

自动管理长对话的上下文，防止溢出。支持时间修剪和滑动窗口模式。

🔌 插件与技能

通过插件扩展功能，包括网络搜索、浏览器自动化、语音交互等。

bash
# 安装插件
openclaw plugins add <plugin-name>

# 安装技能
openclaw skills install <skill-name>

# 查看已安装插件
openclaw plugins list

常见问题排查

❌ 无法连接到 API

检查以下几点：

  • 确认 Base URL 正确（注意是否包含 /v1 后缀）
  • 确认 API Key 有效（以 sk- 开头）
  • 尝试切换国内/全球节点
  • 检查网络连接是否正常

❌ 认证失败

确保 API Key 正确且余额充足。可以在控制台查看令牌状态。

❌ 模型不可用

检查模型名称是否正确。可通过以下命令查看可用模型：

bash
curl https://api.xidao.online/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

⚠️ 响应速度慢

  • 尝试切换到更快的模型（如 Gemini Flash）
  • 减少单次请求的上下文长度
  • 检查本地网络连接
  • 尝试切换国内/全球节点
提示: 遇到问题时，先运行 openclaw doctor 自动诊断配置问题。
下一篇 Hermes-Agent 教程 → ← 返回教程列表