Skip to main content
本文档精简整理了 OpenClaw 安装与基本使用流程。完整文档请参阅 OpenClaw 官方文档。

​
环境要求

检查 Node.js 版本：
若版本低于 22，推荐通过 nvm 安装：

​
全局安装 CLI

验证安装：

​
首次配置（向导模式）

运行向导并安装守护进程：
向导会自动完成以下步骤：
  • 创建 OpenClaw 工作目录（~/.openclaw）
  • 引导配置模型提供方（可先跳过，后续接入 PhanEdge 时再配置）
  • 配置默认模型与会话参数
  • 配置通讯渠道（WhatsApp / Telegram / Slack / 飞书 / WebChat 等）
  • 安装并启动 Gateway 守护进程
如需接入 PhanEdge，建议在向导中先跳过模型配置，直接参考 接入 PhanEdge 进行配置。

​
手动启动 Gateway（调试用）

  • 默认控制平面地址：ws://127.0.0.1:18789
  • --verbose 输出详细日志，便于排查问题

​
基本使用

​
终端发送消息

--to 的具体格式取决于你配置的通讯渠道（手机号、聊天 ID、频道等）。

​
Agent 对话模式

通过 Gateway 调用已配置的默认模型，适合快速测试。

​
Web UI

Gateway 运行后，浏览器访问日志中打印的地址（通常为 http://127.0.0.1:18789），可使用：
  • Dashboard：查看 Gateway 状态、节点、通道
  • WebChat：浏览器中直接对话
  • Channels：管理通讯渠道配置
  • Models：查看与调整模型参数

​
高级部署

启动后按 compose 文件中暴露的端口访问 Gateway 与 Web UI。

​
常见问题

  • 确认 npm install -g openclaw@latest 执行成功
  • 检查全局 npm bin 路径已加入 PATH
使用 nvm 安装 Node 22+ 后重新安装 OpenClaw CLI。
执行诊断命令：
按提示检查配置、权限、网络等。
重新运行 openclaw onboard，检查各通道的 Token、证书、Webhook 等配置。

​
下一步

接入 PhanEdge

配置 PhanEdge 模型提供方，通过 PhanEdge 聚合平台调用 AI 模型。