Skip to content

入门指南

目标:以最少的设置,从零开始到完成第一次可用聊天。

  • 推荐使用 Node 24(Node 22 LTS,目前为 22.16+,仍因兼容性而受支持)
  1. 安装 OpenClaw(推荐)

    Terminal window
    curl -fsSL https://openclaw.ai/install.sh | bash
    安装脚本流程
  2. 运行新手引导

    Terminal window
    openclaw onboard --install-daemon

    新手引导会配置认证、Gateway 网关设置和可选渠道。 详情请参见 CLI 新手引导

  3. 检查 Gateway 网关

    如果你已安装服务,它应该已经在运行:

    Terminal window
    openclaw gateway status
  4. 打开 Control UI

    Terminal window
    openclaw dashboard
在前台运行 Gateway 网关

适合快速测试或故障排除。

Terminal window
openclaw gateway --port 18789
发送一条测试消息

需要已配置的渠道。

Terminal window
openclaw message send --target +15555550123 --message "Hello from OpenClaw"

如果你将 OpenClaw 作为服务账户运行,或想使用自定义配置/状态位置:

  • OPENCLAW_HOME 设置用于内部路径解析的主目录。
  • OPENCLAW_STATE_DIR 覆盖状态目录。
  • OPENCLAW_CONFIG_PATH 覆盖配置文件路径。

完整的环境变量参考: 环境变量

CLI 新手引导

完整的 CLI 新手引导参考和高级选项。

macOS 应用新手引导

macOS 应用的首次运行流程。

  • 一个正在运行的 Gateway 网关
  • 已配置好的认证
  • Control UI 访问权限或一个已连接的渠道
  • 私信安全和批准:Pairing
  • 连接更多渠道:Channels
  • 高级工作流和源码安装:Setup