OpenClaw 中文教程

外观

OpenClaw 入门：从零到一搭建你的 AI 助手

约 1136 字大约 4 分钟

tutorialbeginner

2026-02-15

前言

你是否想过拥有一个 7×24 小时在线的 AI 助手，帮你处理日常任务、回答问题、自动化工作流？OpenClaw 就是这样一个开源项目，让你可以在自己的设备上运行强大的 AI 助手。

本文将带你从零开始，搭建你的第一个 OpenClaw 实例。

为什么选择 OpenClaw？

在开始之前，让我们先了解 OpenClaw 的核心优势：

🔒 数据隐私

所有对话记录和 API 密钥都存储在你的设备上，不会上传到任何第三方服务器。

🔌 多平台支持

一次部署，即可在 Telegram、Discord、飞书、微信等多个平台使用。

🤖 模型自由

支持 Claude、GPT、DeepSeek、Kimi、MiniMax 等主流模型，甚至可以使用 Ollama 运行本地模型。

🧩 技能生态

通过 ClawHub 安装各种技能，让你的 AI 助手能够操作浏览器、管理日程、处理文件等。

准备工作

在开始之前，你需要准备：

  1. Node.js 环境（≥ 22.0.0）
  2. 一个 AI 模型的 API Key（推荐新手使用 MiniMax 或 Kimi）
  3. 一个聊天平台账号（推荐 Telegram，配置最简单）

第一步：安装 OpenClaw

打开终端，执行以下命令：

npm install -g openclaw@latest

安装完成后，验证安装：

openclaw --version

第二步：初始化配置

运行引导配置命令：

openclaw onboard --install-daemon

这个命令会启动一个交互式配置向导，引导你完成以下配置：

1. 选择 AI 模型

向导会列出支持的模型提供商，这里我们选择 MiniMax（国内可用，无需翻墙）：

? 选择你的 AI 模型提供商:
  > MiniMax
    Kimi
    DeepSeek
    Claude
    OpenAI GPT

2. 输入 API Key

访问 MiniMax 开放平台，注册并获取 API Key，然后粘贴到终端：

? 请输入 MiniMax API Key: sk-xxxxxxxxxxxxx

3. 选择聊天平台

选择你想要接入的聊天平台，这里我们选择 Telegram：

? 选择聊天平台:
  > Telegram
    Discord
    飞书
    微信

4. 配置 Telegram Bot

按照向导提示：

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot 创建新机器人
  3. 按提示设置机器人名称和用户名
  4. 复制 BotFather 给你的 Token
  5. 粘贴到终端
? 请输入 Telegram Bot Token: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

第三步：启动 OpenClaw

配置完成后，启动 Gateway 控制中心：

openclaw gateway --port 18789

看到以下输出表示启动成功：

✓ OpenClaw Gateway started
✓ Listening on http://localhost:18789
✓ Telegram bot connected
✓ Model: MiniMax (abab6.5s-chat)

第四步：测试你的 AI 助手

打开 Telegram，找到你刚创建的机器人，发送一条消息：

你好！

如果机器人回复了，恭喜你！你的第一个 OpenClaw 实例已经成功运行了！

进阶配置

安装技能

访问 ClawHub，浏览并安装你需要的技能：

# 安装 GitHub 集成技能
openclaw skill install github-integration

# 安装浏览器自动化技能
openclaw skill install browser-automation

配置多个聊天平台

编辑配置文件 ~/.openclaw/config.json，添加更多渠道：

{
  "channels": {
    "telegram": {
      "token": "your-telegram-token"
    },
    "discord": {
      "token": "your-discord-token"
    }
  }
}

切换模型

如果想尝试其他模型，可以在 Gateway 控制台中切换，或编辑配置文件：

{
  "models": {
    "default": {
      "provider": "deepseek",
      "apiKey": "sk-xxxxx",
      "model": "deepseek-chat"
    }
  }
}

常见问题

Q: 机器人不回复消息？

A: 检查以下几点：

  1. OpenClaw 服务是否正在运行
  2. API Key 是否正确且有余额
  3. Bot Token 是否正确
  4. 查看终端日志，看是否有错误信息

Q: 如何让 OpenClaw 开机自启？

A: 使用 --install-daemon 参数：

openclaw onboard --install-daemon

Q: 如何更新 OpenClaw？

A: 重新安装最新版本：

npm install -g openclaw@latest

下一步

现在你已经成功搭建了 OpenClaw，可以：

  1. 探索 技能市场，安装更多功能
  2. 阅读 配置指南，优化你的设置
  3. 查看 使用案例，了解更多玩法
  4. 加入 社区讨论，分享你的经验

总结

OpenClaw 为我们提供了一个强大而灵活的 AI 助手平台。通过本文的步骤，你应该已经成功搭建了自己的实例。

记住，OpenClaw 的强大之处在于它的开放性和可扩展性。随着你对它的深入了解，你会发现更多有趣的用法。

祝你使用愉快！🚀

相关阅读：