openclaw/docs/zh-CN/start/getting-started.md

3.5 KiB
Raw Permalink Blame History

read_when summary title x-i18n
从零开始进行首次设置
你想用最快的路径开始可用聊天
在几分钟内安装 OpenClaw 并开始你的第一次聊天。 入门指南
generated_at model provider source_hash source_path workflow
2026-03-16T06:27:55Z gpt-5.4 openai 47583047c1a603c1254d2540846452ad321d12bc7fc3f24e5def9282ee96f415 start/getting-started.md 15

入门指南

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

最快的聊天方式:打开 Control UI无需设置渠道。运行 `openclaw dashboard` 并在浏览器中聊天,或在 网关主机 上打开 `http://127.0.0.1:18789/`。 文档:[Dashboard](/web/dashboard) 和 [Control UI](/web/control-ui)。

前置条件

  • 推荐使用 Node 24Node 22 LTS目前为 22.16+,仍因兼容性而受支持)
如果你不确定,请使用 `node --version` 检查你的 Node 版本。

快速设置CLI

```bash curl -fsSL https://openclaw.ai/install.sh | bash ``` 安装脚本流程 ```powershell iwr -useb https://openclaw.ai/install.ps1 | iex ```
<Note>
其他安装方式和要求: [Install](/install)。
</Note>
```bash openclaw onboard --install-daemon ```
新手引导会配置认证、Gateway 网关设置和可选渠道。
详情请参见 [CLI 新手引导](/start/wizard)。
如果你已安装服务,它应该已经在运行:
```bash
openclaw gateway status
```
```bash openclaw dashboard ``` 如果 Control UI 能加载,你的 Gateway 网关就已准备就绪,可以使用。

可选检查和附加内容

适合快速测试或故障排除。
```bash
openclaw gateway --port 18789
```
需要已配置的渠道。
```bash
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
```

常用环境变量

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

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

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

深入了解

完整的 CLI 新手引导参考和高级选项。 macOS 应用的首次运行流程。

你将获得什么

  • 一个正在运行的 Gateway 网关
  • 已配置好的认证
  • Control UI 访问权限或一个已连接的渠道

后续步骤

  • 私信安全和批准:Pairing
  • 连接更多渠道:Channels
  • 高级工作流和源码安装:Setup