Appearance
安装与启动
安装 OpenClaw CLI 并完成首次配置
INFO
本文档精简整理了 OpenClaw 安装与基本使用流程。完整文档请参阅 OpenClaw 官方文档。
环境要求
| 项目 | 要求 |
|---|---|
| 操作系统 | macOS / Linux / Windows(推荐 WSL2) |
| Node.js | ≥ 22 |
| 包管理器 | npm / pnpm / bun |
检查 Node.js 版本:
bash
node -v若版本低于 22,推荐通过 nvm 安装:
bash
# 安装 nvm(Linux / macOS)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc # 或 ~/.zshrc
# 安装并使用 Node 22
nvm install 22
nvm use 22全局安装 CLI
bash
npm install -g openclaw@latest验证安装:
bash
openclaw --version首次配置(向导模式)
运行向导并安装守护进程:
bash
openclaw onboard --install-daemon向导会自动完成以下步骤:
- 创建 OpenClaw 工作目录(
~/.openclaw) - 引导配置模型提供方(可先跳过,后续接入 Fhddos 时再配置)
- 配置默认模型与会话参数
- 配置通讯渠道(WhatsApp / Telegram / Slack / 飞书 / WebChat 等)
- 安装并启动 Gateway 守护进程
TIP
如需接入 Fhddos,建议在向导中先跳过模型配置,直接参考 接入 Fhddos 进行配置。
手动启动 Gateway(调试用)
bash
openclaw gateway --port 18789 --verbose- 默认控制平面地址:
ws://127.0.0.1:18789 --verbose输出详细日志,便于排查问题
基本使用
终端发送消息
bash
openclaw message send \
--to +1234567890 \
--message "Hello from OpenClaw"--to 的具体格式取决于你配置的通讯渠道(手机号、聊天 ID、频道等)。
Agent 对话模式
bash
openclaw agent --message "帮我列一个简单的出差准备清单"通过 Gateway 调用已配置的默认模型,适合快速测试。
Web UI
Gateway 运行后,浏览器访问日志中打印的地址(通常为 http://127.0.0.1:18789),可使用:
- Dashboard:查看 Gateway 状态、节点、通道
- WebChat:浏览器中直接对话
- Channels:管理通讯渠道配置
- Models:查看与调整模型参数
高级部署
从源码运行(开发场景)
git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build pnpm build pnpm openclaw onboard --install-daemon pnpm gateway:watch # 开发模式,代码变更自动重载Docker 部署(服务器场景)
git clone https://github.com/openclaw/openclaw.git cd openclaw # 方式一:脚本一键部署 ./docker-setup.sh # 方式二:docker-compose docker-compose up -d启动后按 compose 文件中暴露的端口访问 Gateway 与 Web UI。
常见问题
CLI 命令找不到(command not found)
- 确认
npm install -g openclaw@latest执行成功 - 检查全局 npm bin 路径已加入
PATH
Node 版本过低
使用 nvm 安装 Node 22+ 后重新安装 OpenClaw CLI。
Gateway 启动报错
执行诊断命令:
openclaw doctor按提示检查配置、权限、网络等。
消息通道无法收发
重新运行 openclaw onboard,检查各通道的 Token、证书、Webhook 等配置。