OpenClaw 入门指南 — 几分钟内设置你的 AI 助手

要开始使用 OpenClaw，请使用 npm install -g openclaw@latest 全局安装，然后运行 openclaw onboard 来配置你的实例。 引导向导将带你完成 AI 模型设置、连接 WhatsApp 或 Telegram 等消息频道以及配置工作区。或者，MyClaw.ai 提供托管服务，无需任何设置即可立即使用你的实例。

什么是 OpenClaw？

OpenClaw（前身为 Clawdbot）是一个开源的个人 AI 助手，运行在你自己的机器上。与纯云端 AI 工具不同，OpenClaw 给你完全的控制权——你的数据保留在本地，你通过已经在使用的消息应用进行交互：WhatsApp、Telegram、Slack、Discord、Signal、iMessage 等。

开始使用 OpenClaw

有两种开始方式：

1. 自托管 — 安装到你自己的机器上（本指南）
2. 托管服务 — 让 MyClaw.ai 为你处理一切

自托管的前提条件

在安装 OpenClaw 之前，请确保你有：

• Node.js — 版本 22 或更高（在此下载）
• 操作系统 — macOS、Linux 或 Windows（强烈推荐 WSL2）

步骤 1：安装 OpenClaw

最快的开始方式是全局安装：

npm install -g openclaw@latest

步骤 2：运行引导向导

引导向导将带你完成整个设置：

openclaw onboard --install-daemon

向导将引导你完成：

• 模型设置 — 选择你的 AI 模型（Claude、GPT 或本地模型）并配置 API 认证
• 频道连接 — 关联你的消息应用（WhatsApp、Telegram、Slack、Discord 等）
• 工作区初始化 — 在 ~/.openclaw/workspace 设置你的本地工作区
• 技能配置 — 从 ClawHub 浏览和安装技能
• 守护进程安装 — 设置后台服务（macOS 上的 launchd，Linux 上的 systemd），使 OpenClaw 持续运行

步骤 3：验证你的设置

运行内置诊断工具，确保一切配置正确：

openclaw doctor

步骤 4：发送你的第一条消息

一旦频道连接好，就通过消息应用向 OpenClaw 发送消息——就像给朋友发短信一样。例如，在 WhatsApp 或 Telegram 上发送：

"你能帮我做什么？"

你也可以直接从命令行交互：

openclaw agent --message "你能帮我做什么？"

OpenClaw 会通过同一频道回复。从这里开始，你可以让它管理邮件、查看日历、浏览网页、编写代码或运行任何已安装的技能。

实用命令

OpenClaw 运行后，这些命令帮助你进行管理：

命令	功能
/status	查看当前会话状态
/new 或 /reset	重置对话会话
/think <level>	控制推理深度
openclaw doctor	诊断配置问题
openclaw update --channel stable	更新到最新版本

常见设置问题

端口冲突

如果你看到"端口已被使用"的错误，请指定一个不同的端口：

openclaw gateway --port 18790

Node 版本不支持

OpenClaw 需要 Node.js 22 或更高版本。检查你的版本：

node --version

如果版本较旧，从 nodejs.org 更新或使用 nvm：

nvm install 22
nvm use 22

macOS 权限错误

OpenClaw 可能需要辅助功能权限才能使用某些功能。前往：

系统设置 > 隐私与安全性 > 辅助功能

将你的终端应用添加到允许列表中。

更简单的选择：托管服务

自托管给你完全的控制权，但也意味着需要自己管理更新、运行时间和配置。如果你想跳过这些，MyClaw.ai 在云端为你运行 OpenClaw：

• 零设置 — 无需安装、配置或调试
• 始终在线 — 无需保持电脑开机，你的实例全天候运行
• 自动更新 — 始终运行最新版本的 OpenClaw

无论是自托管还是使用托管服务，最重要的是开始使用 OpenClaw，发现它能为你的工作流程做些什么。

下一步

OpenClaw 运行起来后：

• 探索技能市场（ClawHub）中社区构建的集成
• 尝试连接更多消息频道
• 加入 OpenClaw 社区 Discord 获取技巧和支持
• 查看什么是 OpenClaw？深入了解功能
• 如果你想从源代码构建，请阅读完整安装指南