OpenClaw 快速上手：5分钟搭建你的 AI 助手

本教程属于《OpenClaw 从入门到精通》系列

查看系列目录

想不想在 5 分钟内拥有一个可以通过微信、Telegram 随时联系的 AI 助手？本篇将带你完成从零开始的完整部署流程。

📋 准备工作

在开始之前，请确保你具备以下条件：

要求	说明
Node.js	18.x 或更高版本
pnpm	推荐使用 pnpm 包管理器
聊天账号	Telegram Bot / 微信等
AI API Key	OpenAI / Anthropic 等

检查环境

# 检查 Node.js 版本
node -v

# 检查 pnpm 是否已安装
pnpm -v

如果未安装 Node.js，推荐使用 nvm 管理：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20

🚀 安装步骤

方式一：一键安装（推荐）

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

# 首次运行会自动安装依赖并启动
openclaw --version

方式二：手动安装

# 1. 创建项目目录
mkdir my-openclaw && cd my-openclaw

# 2. 初始化项目
pnpm init

# 3. 安装 OpenClaw
pnpm add openclaw

# 4. 创建配置目录
mkdir -p ~/.openclaw

# 5. 启动 Gateway
pnpm openclaw gateway start

方式三：Docker 部署

# 1. 拉取镜像
docker pull openclaw/openclaw:latest

# 2. 运行容器
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

# 3. 查看日志
docker logs -f openclaw

⚙️ 首次配置

1. 访问管理界面

安装完成后，浏览器打开：

http://localhost:18789

首次访问会引导你完成初始化配置。

2. 配置 AI 提供商

OpenClaw 支持多种 AI 模型，请在配置中选择：

# ~/.openclaw/config.yaml
ai:
  provider: "anthropic"  # 或 "openai"
  model: "claude-sonnet-4-20250514"
  apiKey: "sk-ant-xxxxx"  # 你的 API Key

3. 配置消息渠道

选择你想使用的聊天平台：

Telegram 配置

找 @BotFather 创建新机器人
获取 Bot Token
在 OpenClaw 中配置：

telegram:
  enabled: true
  botToken: "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"

Discord 配置

在 Discord 开发者门户创建应用
添加机器人到你的服务器
配置：

discord:
  enabled: true
  botToken: "YOUR_BOT_TOKEN"
  guildId: "YOUR_SERVER_ID"

🎯 第一个任务：Hello World

配置完成后，让我们来测试一下！

在终端测试

openclaw chat "你好，请介绍一下自己"

在 Telegram 测试

打开你创建的 Telegram 机器人
发送 /start 激活
发送消息开始对话

验证成功

如果一切正常，你会收到类似这样的回复：

👋 你好！我是你的 OpenClaw AI 助手。

我可以帮助你：
- 回答问题和提供信息
- 执行各种任务
- 管理你的日程和提醒
- 访问网页和处理文件

随时告诉我你需要什么！

🔧 进阶配置

配置技能（Skills）

OpenClaw 的强大之处在于 Skills 扩展。安装你的第一个 Skill：

# 安装天气查询技能
openclaw skills install weather

# 安装网络搜索技能
openclaw skills install web-search

配置心跳任务

让 AI 主动检查你的邮箱：

# ~/.openclaw/config.yaml
heartbeat:
  enabled: true
  interval: 3600  # 每小时检查一次
  tasks:
    - name: "check-email"
      enabled: true

配置记忆系统

让 AI 记住你的偏好：

memory:
  enabled: true
  type: "file"  # 或 "sqlite"
  path: "~/.openclaw/memory"

📱 移动节点配对

想要 AI 调用你的手机？配对一个节点：

iOS 设备

从 App Store 下载 “OpenClaw Node”
在手机设置中配对
授予相机、通知等权限

Android 设备

下载 OpenClaw Node APK
开启开发者选项中的 USB 调试
配对后即可使用

配对完成后，你可以让 AI：

📷 拍照给你看
📍 获取位置信息
🔔 发送手机通知

❓ 常见问题

Q1: 端口被占用怎么办？

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

# 修改端口
openclaw gateway start --port 3001

Q2: AI API 调用失败

检查 API Key 是否正确
确认 API 余额是否充足
查看网络是否能访问 AI 服务

Q3: Telegram 收不到消息

确认 Bot Token 正确
检查是否已与 Bot 开始对话
查看 OpenClaw 日志排查

✅ 验证清单

安装完成后，请确认以下事项：

OpenClaw 服务正常运行
可以访问管理界面
AI 对话正常工作
至少一个聊天渠道已连接
发送消息能收到回复

🎉 下一步

现在你已掌握 OpenClaw 的基本使用！接下来可以学习：

第二阶段：部署与安装 - 深入了解各种部署方式
技能系统：让 AI 掌握更多技能 - 安装和使用各种 Skills

📚 参考资料

本教程由 AI 自动生成并发布