跳转到内容

5 分钟上手

前置准备

在开始之前,请确保:

  • 已完成 GetClaw 安装
  • 准备好至少一个 AI 提供商的 API Key(如 OpenAI、DeepSeek、Kimi 等)

无需安装 Node.js 或其他依赖,所有内容已内置。


第一步:启动 GetClaw

  • Windows:在桌面或开始菜单找到 GetClaw,双击启动
  • macOS:在应用程序文件夹或 Launchpad 找到 GetClaw,点击启动

首次启动会进入配置向导(如安装时已完成配置,可直接进入运行面板)。


第二步:配置 AI 提供商

  1. 进入「配置中心」→「AI 提供商」
  2. 选择你使用的提供商(推荐:OpenAI、DeepSeek 或 Kimi)
  3. 填入 API Key(界面以掩码显示,安全存储)
  4. 点击「测试连接」——显示绿色表示配置成功

支持的提供商详情请参考 AI 提供商配置


第三步:启动 OpenClaw

  1. 返回「运行面板」
  2. 点击「启动 OpenClaw」按钮
  3. 等待状态灯变为绿色(通常 3–10 秒)
  4. 绿灯亮起 = OpenClaw 正在运行

此时 AI 助手已就绪,可以开始接收消息。


第四步(可选):接入消息平台

如果你想让 AI 助手处理 Telegram、Discord 等平台的消息:

  1. 进入「配置中心」→「消息频道」
  2. 选择平台(如 Telegram)
  3. 按照向导填入 Bot Token 或授权码
  4. 点击「启动」

详细步骤请参考 消息频道配置


运行面板说明

成功启动后,运行面板显示:

指标说明
状态灯绿色 = 运行中,红色 = 已停止
运行时长自上次启动以来的时间
已接入频道当前活跃的消息平台数量
实时日志OpenClaw 的运行日志(可按 Info/Warn/Error 过滤)

常见问题

状态灯一直是红色

  • 检查 API Key 是否正确配置
  • 点击「AI 诊断」查看自动分析结果
  • 查看日志中的具体错误信息

API Key 测试失败

  • 确认 Key 已正确复制(无多余空格)
  • 国内用户访问 OpenAI 可能需要代理,参考 网络问题
  • 推荐改用国内直连的 DeepSeek 或 Kimi

下一步