5 分钟上手
前置准备
在开始之前,请确保:
- 已完成 GetClaw 安装
- 准备好至少一个 AI 提供商的 API Key(如 OpenAI、DeepSeek、Kimi 等)
无需安装 Node.js 或其他依赖,所有内容已内置。
第一步:启动 GetClaw
- Windows:在桌面或开始菜单找到 GetClaw,双击启动
- macOS:在应用程序文件夹或 Launchpad 找到 GetClaw,点击启动
首次启动会进入配置向导(如安装时已完成配置,可直接进入运行面板)。
第二步:配置 AI 提供商
- 进入「配置中心」→「AI 提供商」
- 选择你使用的提供商(推荐:OpenAI、DeepSeek 或 Kimi)
- 填入 API Key(界面以掩码显示,安全存储)
- 点击「测试连接」——显示绿色表示配置成功
支持的提供商详情请参考 AI 提供商配置。
第三步:启动 OpenClaw
- 返回「运行面板」
- 点击「启动 OpenClaw」按钮
- 等待状态灯变为绿色(通常 3–10 秒)
- 绿灯亮起 = OpenClaw 正在运行
此时 AI 助手已就绪,可以开始接收消息。
第四步(可选):接入消息平台
如果你想让 AI 助手处理 Telegram、Discord 等平台的消息:
- 进入「配置中心」→「消息频道」
- 选择平台(如 Telegram)
- 按照向导填入 Bot Token 或授权码
- 点击「启动」
详细步骤请参考 消息频道配置。
运行面板说明
成功启动后,运行面板显示:
| 指标 | 说明 |
|---|---|
| 状态灯 | 绿色 = 运行中,红色 = 已停止 |
| 运行时长 | 自上次启动以来的时间 |
| 已接入频道 | 当前活跃的消息平台数量 |
| 实时日志 | OpenClaw 的运行日志(可按 Info/Warn/Error 过滤) |
常见问题
状态灯一直是红色
- 检查 API Key 是否正确配置
- 点击「AI 诊断」查看自动分析结果
- 查看日志中的具体错误信息
API Key 测试失败
- 确认 Key 已正确复制(无多余空格)
- 国内用户访问 OpenAI 可能需要代理,参考 网络问题
- 推荐改用国内直连的 DeepSeek 或 Kimi