安装指南

装上 OpenClaw

多种安装方式任你选,殊途同归。

checklist 系统要求

javascript Node.js

Node.js 22 或更高版本(推荐 LTS)

computer OS

Windows 10+、macOS 12+ 或 Linux(Ubuntu 20.04+、Debian 11+)

memory RAM

最低 2 GB 内存,推荐 4 GB

hard_drive Disk

安装和依赖大约需要 ~500 MB 磁盘空间

extension Optional

可选:Python 3.10+(部分技能需要)、Git(源码编译需要)

wifi Network

调用 AI API 需要联网。通过 Ollama 跑本地模型可以离线使用。

复制粘贴一行命令就完事。大多数人选这个。 去文档看完整说明 arrow_forward

Windows (PowerShell)

建议用管理员权限运行 PowerShell。

PS> curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmd

macOS / Linux

macOS 和主流 Linux 发行版都能用。

$ curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

verified 验证安装

运行以下命令确认 OpenClaw 安装正确。

1
$ openclaw --version

应该输出已安装的版本号(如 v2026.3.12)。

2
$ openclaw doctor

对你的环境做一次诊断检查:Node.js 版本、依赖、配置文件和网络连接。

3
$ openclaw onboard

交互式配置向导,带你设置 API Key、连接聊天平台和初始配置。

settings 初始配置

安装完成后,onboard 向导会引导你完成配置。每一步的作用如下。

1

选择 AI 供应商

选 Anthropic (Claude)、OpenAI (GPT)、Google (Gemini) 或通过 Ollama 跑本地模型。随时可以在配置里切换。

2

添加 API Key

从供应商后台粘贴你的 API Key。Key 存在本地 .env 文件里——除了 AI 供应商,不会发到任何地方。

3

连接聊天平台

接入 WhatsApp(扫二维码)、Telegram(粘贴 @BotFather 的 Bot Token)、Discord(粘贴 Bot Token)或其他支持的平台。

4

发条测试消息

通过已连接的聊天软件给 OpenClaw 发条消息。如果它回复了,就说明一切就绪。试试发:'你能做什么?'

.env — 所有配置存储在 ~/.openclaw/.env。你可以直接编辑这个文件来切换供应商、添加 API Key 或调整设置。完整参考见 docs.openclaw.ai/configuration。

system_update_alt 升级 OpenClaw

保持 OpenClaw 最新版本,获取最新功能、集成和安全补丁。 升级和迁移教程 arrow_forward

npm
$ npm update -g openclaw@latest
pnpm
$ pnpm update -g openclaw@latest
Git
$ cd openclaw && git pull && pnpm install && pnpm run build
Docker
$ docker pull openclaw/openclaw:latest && docker restart openclaw

在 github.com/openclaw/openclaw/releases 查看更新日志,了解每个版本的新内容。

delete_forever 卸载 OpenClaw

如果你需要从系统中移除 OpenClaw,按照对应安装方式的步骤操作即可。 卸载详细步骤 arrow_forward

npm
$ npm uninstall -g openclaw
pnpm
$ pnpm remove -g openclaw
Git (Source)
$ rm -rf ~/openclaw
Docker
$ docker stop openclaw && docker rm openclaw && docker rmi openclaw/openclaw:latest

删除用户数据(可选)

这会清除你所有的对话记录、技能、配置和 API Key。操作前先备份好需要保留的内容。

macOS/Linux $ rm -rf ~/.openclaw
Windows PS> rmdir /s /q %USERPROFILE%\.openclaw

build 故障排查

常见问题及解决方法。 更多排错方法 arrow_forward

遇到问题?

来 Discord 问问,总有人能帮到你。

订阅更新

第一时间获取新功能和玩法。放心,不会发垃圾邮件。