跳到主要内容

快速开始

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

启动服务​

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

# 启动 Gateway 服务（前台运行）
openclaw gateway

# 或安装为系统服务
openclaw gateway install
openclaw gateway start

# 检查服务状态
openclaw gateway status

看到 Gateway 正常运行后，可以继续配置。

访问 Control UI​

打开浏览器访问：

http://127.0.0.1:18789

这是 OpenClaw 的控制界面，提供聊天、配置、会话管理等功能。

如果设置了访问 Token，首次访问需要认证。Token 配置在 gateway.auth.token 中。

运行 Onboarding​

Onboarding 是交互式配置向导，帮助快速完成基础设置：

# 运行 Onboarding 向导
openclaw onboard

# 同时安装为系统服务
openclaw onboard --install-daemon

Onboarding 会引导你：

  1. 配置模型提供商（Anthropic、OpenAI 等）
  2. 设置工作空间
  3. 配置渠道（可选）
  4. 安装技能（可选）

使用 Setup 命令​

如果只需要初始化工作空间：

# 初始化配置和工作空间
openclaw setup

# 指定工作空间路径
openclaw setup --workspace ~/my-workspace

这会创建 ~/.openclaw/openclaw.json 配置文件和默认的工作空间模板文件。

配置模型​

OpenClaw 需要配置 LLM 才能工作。支持多种模型提供商：

提供商配置方式特点
Anthropic ClaudeAPI Key推理能力强，推荐
OpenAI GPTAPI Key综合能力均衡
DeepSeekAPI Key性价比高
Google GeminiAPI Key多模态能力强
OpenRouterAPI Key多模型聚合
本地模型Ollama完全离线

方式一：使用 Models CLI​

# 查看可用模型
openclaw models list

# 设置默认模型
openclaw models set anthropic/claude-sonnet-4-6

# 配置认证
openclaw models auth login --provider anthropic

方式二：编辑配置文件​

编辑 ~/.openclaw/openclaw.json：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4"
      }
    }
  }
}

方式三：使用环境变量​

# 设置 API Key
export ANTHROPIC_API_KEY="sk-xxx"

# OpenClaw 会自动检测并使用

第一次对话​

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

通过 Control UI​

在浏览器中打开 http://127.0.0.1:18789，直接在聊天框输入：

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

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

通过命令行​

# 发送消息给 Agent
openclaw agent --message "帮我查看当前目录下有哪些文件"

# 简写形式
openclaw agent -m "你好"

# 指定思考级别
openclaw agent -m "分析这个项目的架构" --thinking high

配置第一个渠道​

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

接入 Telegram​

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot 创建新机器人
  3. 按提示设置名称，获取 Bot Token
  4. 配置 OpenClaw：
# 添加 Telegram 渠道（交互式）
openclaw channels add --channel telegram

# 或非交互式
openclaw channels add --channel telegram --token YOUR_BOT_TOKEN

接入 WhatsApp​

# 添加 WhatsApp 渠道
openclaw channels add --channel whatsapp

# 扫描 QR 码登录
openclaw channels login --channel whatsapp

验证渠道​

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

# 检查渠道状态
openclaw channels status

# 深度检查（包括连接探测）
openclaw channels status --probe

安装第一个 Skill​

Skills 是 OpenClaw 的核心能力扩展，可以从 ClawHub 安装社区技能。

搜索技能​

# 搜索技能
openclaw skills search weather

# 列出已安装技能
openclaw skills list

安装技能​

# 安装技能
openclaw skills install skill-name

# 查看技能详情
openclaw skills info skill-name

检查技能状态​

# 查看技能就绪状态
openclaw skills check

配置第一个定时任务​

让 OpenClaw 定时自动执行任务。

创建 Cron 任务​

# 列出所有定时任务
openclaw cron list

# 添加定时任务
openclaw cron add --name daily-report --at "0 9 * * *" --message "生成昨日工作总结"

# 启用/禁用任务
openclaw cron enable daily-report
openclaw cron disable daily-report

# 手动执行任务
openclaw cron run daily-report

定时任务格式​

# 每天 9:00 执行
--at "0 9 * * *"

# 每 6 小时执行
--every "6h"

# 使用 Cron 表达式
--cron "0 */6 * * *"

验证配置​

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

# 检查服务状态
openclaw gateway status

# 运行诊断
openclaw doctor

# 检查模型配置
openclaw models status

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

# 检查渠道状态
openclaw channels list

常用诊断命令​

# 查看日志
openclaw logs

# 实时跟踪日志
openclaw logs --follow

# 检查健康状态
openclaw health

# 查看详细状态
openclaw status --deep

下一步​

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

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