🚀 快速开始

5分钟搞定，真的！我数过。

📋 准备清单

就像出门前要检查"钱包、手机、钥匙"一样，先确保这些东西都有了：

🟢 Node.js

版本要求: ≥ 22

node --version

📦 npm / pnpm

版本要求: 任意版本

npm --version

🔑 API Key

版本要求: Anthropic / OpenAI

官网注册

💡 不知道 Node.js 是啥？ 简单理解：它是让 JavaScript 能在电脑上运行的环境，就像手机需要 iOS/Android 系统才能运行 App。安装脚本会自动帮你装好，放心。

📝 安装步骤

📦 安装 OpenClaw

就像安装微信一样简单，一行命令搞定

macOS / Linux

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

Windows (PowerShell)

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

💡 提示：如果没有 curl，可以先安装 Homebrew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

💡 Windows 用户建议用 WSL2（Windows Subsystem for Linux），体验更好

🧙‍♂️ 运行配置向导

向导会带你一步步配置，就像新手机开机设置一样

启动向导并安装后台服务

openclaw onboard --install-daemon

🔑 这一步会要求输入 API Key，去 Anthropic Console 申请

📝 建议选 Anthropic Pro/Max，Claude Opus 4.6 最聪明

⚠️ 如果出错，加 --verbose 参数看详细日志

✅ 检查网关状态

确认服务已经跑起来了，就像检查WiFi连上了没

查看服务状态

openclaw gateway status

如果状态正常，你会看到

✓ Gateway is running on port 18789

🌐 默认端口是 18789，可以在配置里改

🔄 如果没运行，手动启动: openclaw gateway --port 18789

🖥️ 打开控制台

用浏览器访问你的AI助手，就像打开微信网页版

自动打开浏览器

openclaw dashboard

或手动访问

http://127.0.0.1:18789

🎉 看到网页界面就成功了！可以直接在网页聊天

📱 也可以配手机App，详见下方频道配置

📱 配置聊天频道（可选但推荐）

网页版虽然能用，但手机App更方便。就像能用微信网页版，但你肯定更常用手机微信对吧？选一个你常用的聊天工具接入：

💬

难度: ⭐⭐

最常用，手机扫码就能连

openclaw channels login whatsapp

• 需要手机保持在线
• 通过 WhatsApp Web 协议连接

✈️

难度: ⭐

最简单，Bot Father 申请个 Token 就行

openclaw channels login telegram

• 去 @BotFather 申请 Bot Token
• 支持群组和私聊

🎮

Discord

难度: ⭐⭐

游戏玩家首选，在 Discord Developer Portal 申请

openclaw channels login discord

• 创建 Application 获取 Token
• 支持 Slash 命令

💼

Slack

难度: ⭐⭐⭐

团队协作用，配置稍微复杂

openclaw channels login slack

• 需要创建 Slack App
• 配置 Event Subscriptions

🔧 常见问题排查

装软件嘛，总会遇到点坑。这里整理了最常见的几个问题，按这个顺序排查：

❌ 'openclaw: command not found'

原因：安装路径没加到系统 PATH

✅ 解决：运行 source ~/.bashrc 或 ~/.zshrc，或者重启终端

❌ 'Error: Cannot find module'

原因：Node 版本太低或者安装不完整

✅ 解决：升级 Node 到 22+: nvm install 22 && nvm use 22

❌ 端口 18789 被占用

原因：之前运行的实例没关掉，或其他程序占用了

✅ 解决：lsof -ti:18789 | xargs kill -9 然后重启

❌ API Key 无效

原因：复制粘贴少了字符，或者Key过期了

✅ 解决：重新去 Anthropic/OpenAI 控制台复制，确保完整

❌ WhatsApp 连不上

原因：手机离线，或者被检测为异常登录

✅ 解决：保持手机在线，多次重试可能被WhatsApp风控

🆘 还是没解决？ 试试这些大招：

运行 openclaw doctor - 自动诊断问题
加 --verbose 参数看详细日志
去 GitHub Issues 搜你的错误信息
加入 Discord 社区问大佬们

🎉 测试第一条消息

装好了？发个消息测试一下！就像新手机要打个电话试试：

# 在控制台里测试

openclaw agent --message "你好，OpenClaw！"

如果看到 AI 回复，恭喜你！🎊 你的私人AI助理已经上线！

🎯 下一步

基础装好了，现在可以玩点更酷的：

🧠

理解核心概念

Gateway、Agent、Session 都是啥？

⚙️

高级配置

多代理、安全配置、远程访问

🛠️

工具与技能

浏览器控制、定时任务、技能市场

←

📚 WIKI 首页

核心概念 🧠

→

OpenClaw WIKI