跳到主要内容

快速开始

本章将带你用 5 分钟完成 OpenClaw 的首次配置和运行，体验 AI 真正"干活"的能力。

启动服务​

安装完成后，首先启动 OpenClaw 服务：

# 启动 Gateway 服务
openclaw gateway start

# 检查服务状态
openclaw gateway status

看到"Gateway is running"表示服务已正常启动。

访问 Web UI​

打开浏览器访问：

http://127.0.0.1:18789

首次访问需要输入初始化时生成的 Token。如果忘记了 Token，可以重新获取：

openclaw config --show-token

基础配置​

配置模型​

OpenClaw 需要配置至少一个 LLM 才能工作。支持多种模型：

模型获取方式特点
ClaudeAnthropic API推理能力强
GPT-4OpenAI API综合能力均衡
DeepSeekDeepSeek API性价比高
通义千问阿里云 API中文能力强
Ollama本地部署完全离线

在 Web UI 中点击"Settings" → "Models"，输入 API Key 即可。

也可以通过命令行配置：

# 配置 Claude
openclaw config set model.provider claude
openclaw config set model.api_key sk-xxx

# 配置备用模型（自动故障转移）
openclaw config set model.fallback deepseek
openclaw config set model.fallback_api_key sk-xxx

配置存储路径​

默认情况下，OpenClaw 的数据存储在用户目录下：

~/.openclaw/
├── config.json      # 全局配置
├── memory/          # 记忆文件
├── skills/          # 技能库
└── workspaces/      # 工作空间

可以自定义存储路径：

openclaw config set storage.path /path/to/custom/location

第一次对话​

配置完成后，就可以开始与 OpenClaw 对话了。

通过 Web UI​

在聊天框输入：

帮我查看当前目录下有哪些文件

OpenClaw 会调用文件系统工具，列出当前目录的文件列表。

通过命令行​

openclaw chat "帮我查看当前目录下有哪些文件"

安装第一个 Skill​

Skills 是 OpenClaw 的核心能力扩展。让我们安装一个实用的技能。

搜索技能​

# 搜索可用技能
openclaw skill search weather

安装技能​

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

# 安装文件整理技能
openclaw skill install file-organizer

使用技能​

安装后直接对话即可：

北京今天天气怎么样？
帮我把下载文件夹里的文件按类型整理一下

配置第一个渠道​

让 OpenClaw 接入你常用的通讯软件，这样就可以在熟悉的聊天工具中使用它。

接入 Telegram​

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot 创建新机器人
  3. 按提示设置名称，获取 Bot Token
  4. 配置 OpenClaw：
openclaw channels add telegram --token YOUR_BOT_TOKEN

接入飞书​

  1. 访问飞书开放平台创建机器人应用
  2. 获取 App ID 和 App Secret
  3. 配置 OpenClaw：
openclaw channels add feishu --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET

验证渠道​

# 查看已配置的渠道
openclaw channels list

# 测试渠道连接
openclaw channels status --probe

配置第一个定时任务​

让 OpenClaw 定时自动执行任务。

创建 Cron 任务​

编辑配置文件：

openclaw config edit

添加定时任务：

{
  "cron": {
    "tasks": [
      {
        "name": "daily-report",
        "schedule": "0 9 * * *",
        "prompt": "生成昨日工作总结并发送到我的邮箱"
      }
    ]
  }
}

这个配置会在每天早上 9 点自动生成工作总结。

配置 Heartbeat​

创建 HEARTBEAT.md 文件：

openclaw memory edit heartbeat

写入需要定期检查的内容：

# Heartbeat 任务

- 检查未读邮件，有重要的就通知我
- 看看今天还有没有未完成的日程
- 如果距离下一个会议 < 30 分钟，提醒我

OpenClaw 会每隔一段时间（默认 30 分钟）自动执行这些检查。

第一个自动化场景​

让我们创建一个完整的自动化场景：监控某个网站的价格变动。

安装必要技能​

# 安装网页监控技能
openclaw skill install web-monitor

# 安装通知技能
openclaw skill install notification

配置监控任务​

帮我监控这个商品页面的价格：https://example.com/product/123
如果价格低于 500 元就通知我

OpenClaw 会自动创建监控任务，定期检查价格并在满足条件时通知你。

验证配置​

完成以上配置后，验证一切正常：

# 检查服务状态
openclaw gateway status

# 检查已安装的技能
openclaw skill list

# 检查渠道状态
openclaw channels list

# 检查定时任务
openclaw cron list

下一步​

恭喜你完成了 OpenClaw 的基础配置！接下来可以：

  1. 阅读核心概念深入理解 OpenClaw 的工作原理
  2. 探索更多 Skills 技能
  3. 配置 Memory 记忆系统
  4. 设置更多 定时任务