OpenClaw 安装完全指南：从零开始配置 AI 助手（2026最新版）

OpenClaw 是一个强大的 AI 助手框架，支持多平台部署、多聊天工具连接，可自定义 Skills 扩展功能。它可以帮你：

• 🤖 连接多个聊天平台（Telegram、Discord、飞书、QQ、钉钉等）
• 🧠 调用多种大模型（MiniMax、Qwen、OpenAI、Claude 等）
• 🔌 扩展各种 Skills（交易、爬虫、自动化等）
• 📡 搭建自己的 AI 助手服务

本文将详细介绍各种安装和配置方法，帮助你快速搭建自己的 AI 助手。

一、服务器安装（推荐）

服务器部署适合需要 24/7 运行、多用户访问的场景。

1.1 Docker 一键部署（推荐）

# 安装 Docker（Ubuntu/Debian）
sudo apt update
sudo apt install -y docker.io docker-compose

# 启动 Docker
sudo systemctl start docker
sudo systemctl enable docker

# 安装 OpenClaw（官方一键脚本）
curl -sSL https://get.openclaw.ai | bash

# 或者手动部署
git clone https://github.com/openclaw/openclaw.git
cd openclaw
cp config.example.json config.json
# 编辑 config.json 配置你的 API Key
docker-compose up -d

1.2 手动安装（CentOS/RHEL）

# 安装依赖
sudo yum install -y git curl

# 克隆项目
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装 Node.js（如果未安装）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 安装依赖
npm install

# 复制配置
cp config.example.json config.json

# 编辑配置文件，填入你的 API Key
nano config.json

# 启动
npm start

1.3 服务器配置要求

1.4 防火墙配置

# 开放 16404 端口（Ubuntu）
sudo ufw allow 16404/tcp
sudo ufw reload

# 开放 16404 端口（CentOS）
sudo firewall-cmd --permanent --add-port=16404/tcp
sudo firewall-cmd --reload

二、本地安装教程

本地安装适合个人使用、开发和测试场景。

2.1 Windows 安装

# 方法一：使用 winget（推荐）
winget install OpenClaw.OpenClaw

# 方法二：手动安装
# 1. 访问 https://github.com/openclaw/openclaw/releases
# 2. 下载 Windows 版 openclaw-x.x.x-win-x64.zip
# 3. 解压到 C:\Program Files\OpenClaw
# 4. 创建桌面快捷方式
# 5. 运行 openclaw.exe

2.2 Mac 安装

# 方法一：使用 Homebrew
brew install openclaw

# 方法二：手动安装
# 1. 访问 https://github.com/openclaw/openclaw/releases
# 2. 下载 macOS 版 openclaw-x.x.x-macos-x64.tar.gz
# 3. 解压到 /Applications
# 4. 首次运行允许（系统偏好设置 → 安全性与隐私 → 通用）

2.3 Linux 安装

# Ubuntu/Debian
sudo apt update
sudo apt install -y curl
curl -sSL https://get.openclaw.ai | sudo bash

# CentOS/RHEL
sudo yum install -y curl
curl -sSL https://get.openclaw.ai | sudo bash

# 验证安装
openclaw --version

# 启动服务
sudo systemctl start openclaw
sudo systemctl enable openclaw  # 开机自启

三、配置模型 API

OpenClaw 需要配置大模型 API 才能正常工作，目前推荐使用 MiniMax 或 Qwen。

3.1 MiniMax 配置（推荐 – 延迟最低）

1. 访问 MiniMax 开放平台
2. 注册账号并完成实名认证
3. 在控制台创建 API Key
4. 编辑配置文件：

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

# 添加或修改 models 部分：
{
  "models": {
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimax.chat/v1",
        "apiKey": "你的API Key",
        "models": [
          {"id": "MiniMax-M2.5", "name": "MiniMax M2.5"}
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {"primary": "minimax/MiniMax-M2.5"}
    }
  }
}

3.2 阿里云 Qwen 配置

1. 访问 阿里云 DashScope
2. 开通模型服务并获取 API Key
3. 配置：

{
  "models": {
    "providers": {
      "qwen": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "你的API Key",
        "models": [
          {"id": "qwen-plus", "name": "Qwen Plus"},
          {"id": "qwen-max", "name": "Qwen Max"}
        ]
      }
    }
  }
}

3.3 模型对比

四、聊天工具连接配置

4.1 Telegram 配置

1. 打开 Telegram，搜索 @BotFather
2. 发送 /newbot 创建新机器人
3. 按照提示设置名称和用户名
4. 记录获得的 Bot Token
5. 在 OpenClaw 配置文件中添加：

"channels": {
  "telegram": {
    "enabled": true,
    "token": "你的Telegram_Bot_Token"
  }
}

4.2 Discord 配置

1. 访问 Discord Developer Portal
2. 点击「New Application」创建应用
3. 左侧点击「Bot」→ 点击「Reset Token」获取 Token
4. 点击「OAuth2」→ 「URL Generator」
5. Scopes 勾选 bot，Bot Permissions 勾选管理员
6. 复制生成的 URL，添加到服务器
7. 配置 OpenClaw：

"channels": {
  "discord": {
    "enabled": true,
    "token": "你的Discord_Bot_Token",
    "application_id": "你的Application_ID"
  }
}

4.3 飞书配置

1. 登录 飞书开放平台
2. 创建企业自建应用
3. 获取 App ID 和 App Secret
4. 添加权限：
   • im:chat:readonly – 查看群聊
   • im:message:send_as_bot – 发送消息
   • im:message:接收消息
5. 发布版本并添加到企业
6. 配置 OpenClaw：

"channels": {
  "feishu": {
    "enabled": true,
    "appId": "你的App_ID",
    "appSecret": "你的App_Secret"
  }
}

4.4 QQ 配置

1. 访问 QQ 开放平台
2. 创建应用（需要企业认证）
3. 获取 App ID 和 Client Secret
4. 配置 OpenClaw：

"channels": {
  "qqbot": {
    "enabled": true,
    "appId": "你的QQ_App_ID",
    "clientSecret": "你的Client_Secret"
  }
}

4.5 钉钉配置

1. 登录 钉钉开放平台
2. 创建小程序或企业应用
3. 获取 ClientId 和 ClientSecret
4. 配置 OpenClaw：

"channels": {
  "ddingtalk": {
    "enabled": true,
    "clientId": "你的Client_ID",
    "clientSecret": "你的Client_Secret"
  }
}

五、常用 Skills 推荐与安装

Skills 是 OpenClaw 的扩展功能，可以增强 AI 的各种能力。

5.1 交易类 Skills

5.2 效率类 Skills

5.3 安装 Skills

# 使用 skillhub 安装（推荐国内）
skillhub install okx-cex-trade
skillhub install polymarket
skillhub install trading-signals
skillhub install web-scraper
skillhub install weather

# 或使用 clawhub
clawhub install trading-coach
clawhub install automation-tool

# 查看已安装的 Skills
openclaw skills list

六、实操案例：搭建 AI 交易助手

下面演示如何搭建一个可以交易的小助手。

6.1 完整配置步骤

# 步骤1：安装 OpenClaw（Ubuntu）
curl -sSL https://get.openclaw.ai | sudo bash

# 步骤2：配置 MiniMax 模型
# 编辑 ~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "minimax": {
        "apiKey": "你的MiniMax_API_Key",
        "models": [{"id": "MiniMax-M2.5"}]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {"primary": "minimax/MiniMax-M2.5"}
    }
  }
}

# 步骤3：安装交易 Skills
skillhub install okx-cex-trade
skillhub install polymarket

# 步骤4：配置 Telegram 连接
# 在配置文件中添加 Telegram Token

# 步骤5：重启服务
sudo systemctl restart openclaw

6.2 验证安装

# 检查服务状态
openclaw status

# 测试模型连接
openclaw test model

# 查看已安装的 Skills
openclaw skills list

# 查看日志
tail -f ~/.openclaw/logs/openclaw.log

6.3 常用命令

# 启动/停止服务
openclaw start
openclaw stop
openclaw restart

# 查看帮助
openclaw help

# 更新 OpenClaw
openclaw update

七、常见问题解答

Q1: 模型 API 返回 2049 错误？
A: API Key 无效或过期，需要去对应平台重新获取有效的 Key。

Q2: 模型返回 1008 错误？
A: 账户余额不足，需要去平台充值后继续使用。

Q3: 延迟太高怎么办？
A: 建议使用 MiniMax 模型，延迟约 300ms，比阿里云 Qwen 快 10+ 倍。

Q4: 如何连接多个平台？
A: 在配置文件中同时添加多个 channel 配置即可。

Q5: Skills 安装失败？
A: 检查网络连接，或尝试使用国内源 skillhub。

Q6: 如何查看日志？
A: 使用 openclaw logs 或查看 ~/.openclaw/logs/ 目录。

Q7: 端口 16404 无法访问？
A: 检查防火墙设置，确保已开放该端口。

八、总结

OpenClaw 是一个功能强大的 AI 助手框架，支持多种安装方式和聊天平台。通过合理配置 Skills，可以实现：

• 📈 量化交易 – 自动交易 OKX、Polymarket
• 🤖 自动化办公 – 定时提醒、数据抓取
• 📰 内容生成 – 自动写文章、做摘要
• 💬 多平台客服 – 同时服务多个平台

建议：选择延迟低的模型（如 MiniMax）以获得更好的使用体验，记得及时充值避免服务中断。

如有问题，欢迎在评论区留言讨论！