OpenClaw安装使用完整指南，适合新手入门

一、前置条件

OpenClaw 需要以下环境支持：

• Node.js 22 及以上版本

• 操作系统支持：macOS、Linux（或 Windows 的 WSL2 环境，推荐）、Windows PowerShell

• 网络环境：可访问外网以获取安装依赖和 AI 服务

如果你的系统未安装 Node.js 22+，可以通过 nvm 安装（推荐）：

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
# 重新加载配置
source ~/.bashrc  # zsh用户执行 source ~/.zshrc
# 安装Node.js 22
nvm install 22
nvm use 22

二、安装方式

1. 一键安装（推荐）

这是最简单的安装方式，会自动处理依赖和环境配置：

• macOS / Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

• Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

2. 手动安装

如果你需要自定义安装，可以选择手动方式：

方式一：包管理器全局安装

# 使用npm
npm i -g openclaw
# 或使用pnpm
pnpm add -g openclaw

方式二：从源码构建

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖
pnpm install
# 构建前端界面
pnpm ui:build
# 构建整个项目
pnpm build
# 全局链接
pnpm link --global

三、初始化配置

安装完成后，需要通过配置向导完成初始化：

# 启动配置向导，同时安装后台服务
openclaw onboard --install-daemon

配置向导会引导你完成以下步骤：

1. 选择网关类型：

   1. 本地网关：适合单设备使用，默认选项

   2. 远程网关：适合多设备协同，需要后续配置 Tailscale/SSH

2. AI 授权配置： 支持 Anthropic 等 AI 服务，你可以输入对应的 API 密钥，或者按照向导提示完成授权

3. 渠道配置：可选配置 Telegram、Discord 等聊天渠道，也可以后续再配置

如果你需要自动化配置，可以使用非交互模式：

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

四、基础使用

1. 快速启动聊天

你可以直接启动控制面板进行聊天，无需额外配置渠道：

openclaw dashboard

执行后，在浏览器中访问 http://127.0.0.1:18789/ 即可进入聊天界面，开始使用 AI 助手。

2. 基础管理命令

• 查看 OpenClaw 整体状态：

openclaw status

• 检查网关健康状态：

openclaw health

• 运行深度安全审计：

openclaw security audit --deep

3. 发送消息（CLI 方式）

你可以通过 CLI 直接发送消息给 AI 助手：

openclaw agent --message "帮我列一个出差清单" --thinking high

其中--thinking参数控制 AI 的思考深度，可选值：off、minimal、low、medium、high、xhigh。

五、聊天渠道配置

1. Telegram 渠道配置

方式一：向导配置

在openclaw onboard向导中选择 Telegram 渠道，按照提示完成配置。

方式二：手动配置

1. 访问 Telegram 的 @BotFather，发送/newbot获取 Bot Token

2. 执行命令配置：

openclaw configure --section channels.telegram

3. 或者手动编辑配置文件~/.openclaw/openclaw.json，填入 Bot Token

4. 给你的 Telegram Bot 发送第一条消息，获取配对代码，批准后 Bot 即可回复消息

2. Discord 渠道配置

方式一：向导配置

在openclaw onboard向导中选择 Discord 渠道，填入 Discord Bot Token 即可。

方式二：手动配置

1. 访问 Discord 开发者平台，创建应用并获取 Bot Token

2. 执行命令配置：

openclaw configure --section channels.discord

3. 或者手动编辑配置文件~/.openclaw/openclaw.json，填入 Bot Token

六、高级使用

1. 切换 AI 代理

如果你配置了多个 AI 代理，可以通过命令切换：

openclaw agents switch work

2. 安装技能插件

OpenClaw 支持安装插件扩展功能，步骤如下：

1. 访问 Clawdhub 下载所需插件（如邮件整理、浏览器自动化等）

2. 将插件文件放入~/.openclaw/plugins目录

3. 执行命令激活插件：

openclaw plugin install

3. 自动化任务

你可以通过脚本实现 OpenClaw 的自动化操作，比如定时发送消息、自动化配置等，结合非交互模式的命令即可完成。

七、常见问题

1. 安装失败：检查 Node.js 版本是否为 22+，网络是否正常，或者尝试使用 WSL2 环境（Windows 用户）

2. 无法启动 dashboard：检查端口 18789 是否被占用，或者尝试修改网关端口

3. AI 助手无响应：检查 API 密钥是否有效，网络是否能访问对应的 AI 服务

其他

中文文档地址：https://docs.openclaw.ai/zh-CN