OpenClaw 快速入门:国内用户安装指南

🤖 想在自己的设备上运行一个私人的 AI 助手吗?OpenClaw 让你通过 WhatsApp、Telegram、Slack、Discord 等常用聊天工具,与 AI 进行对话,还能在手机和网页上使用。

什么是 OpenClaw?

OpenClaw 是一个开源的个人 AI 助手平台,它的核心特点:

• 🔒 隐私优先:运行在你自己的设备上,数据本地存储
• 📱 多渠道支持:WhatsApp、Telegram、Slack、Discord、微信等 10+ 平台
• 🤖 多模型支持:支持 Anthropic Claude Pro/Max、OpenAI ChatGPT 等主流模型
• 🎯 开箱即用:一条命令完成初始配置
• 💻 跨平台:支持 macOS、Linux、Windows(WSL2)
• 🔧 高度可扩展:支持自定义技能和工作流

为什么选择 OpenClaw?

✅ 完全免费开源 - MIT 许可证✅ 无需云服务 - 本地运行,无需担心数据泄露✅ 支持 OAuth 订阅 - 直接使用你的 Claude Pro/Max 或 ChatGPT Plus 订阅✅ 活跃维护 - 持续更新,快速修复问题✅ 强大社区 - Discord 社区提供支持

📋 系统要求

项目	要求
Node.js	22.12.0 或更高版本
操作系统	macOS、Linux、Windows(推荐 WSL2)
包管理器	npm、pnpm 或 bun
内存	建议 4GB 以上

🚀 三步完成安装

第一步:安装 Node.js

如果你的系统还没有 Node.js 22+,可以通过以下方式安装:

macOS/Linux:

# 使用 nvm (推荐)curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bashnvm install 22nvm use 22

Windows (推荐使用 WSL2):

# 在 WSL2 Ubuntu 环境中curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt-get install -y nodejs

验证安装:

node --version  # 应该显示 v22.x.x 或更高npm --version

第二步:安装 OpenClaw

打开终端,运行:

npm install -g openclaw@latest

或使用 pnpm(更快):

pnpm add -g openclaw@latest

安装完成后,验证:

openclaw --version

第三步:运行初始化向导

这是 OpenClaw 最贴心的地方 - 提供了交互式配置向导:

openclaw onboard --install-daemon

向导会引导你完成:

• ✅ Gateway 配置 - 设置网关端口(默认 18789)
• ✅ 工作空间设置 - 选择数据存储位置
• ✅ 渠道连接 - 选择你要使用的聊天平台(WhatsApp/Telegram/Slack 等)
• ✅ 模型配置 - 登录 Anthropic 或 OpenAI 账号
• ✅ 守护进程 - 自动设置为后台服务,开机自启

提示:--install-daemon 参数会让 OpenClaw 安装为系统服务(launchd/systemd),确保持续运行。

🎯 快速上手

安装完成后,你可以通过多种方式使用 OpenClaw:

1. 命令行直接对话

# 与 AI 助手对话openclaw agent --message "帮我制定一个学习计划"# 使用高思考深度模式(推荐用于复杂任务)openclaw agent --message "分析这个项目的架构" --thinking high

2. 启动网关服务

# 启动 Gateway(如果没使用 daemon 模式)openclaw gateway --port 18789 --verbose# 查看服务状态openclaw status

3. 通过聊天平台使用

如果你在 onboard 时连接了 WhatsApp/Telegram 等平台:

• 在 WhatsApp 中,直接给配置的号码发送消息
• 在 Telegram 中,找到你的 Bot 开始对话
• 在 Slack/Discord 中,在指定频道 @机器人

💬 发送消息示例

# 发送消息到指定渠道openclaw message send --to +1234567890 --message "Hello from OpenClaw"# 查看所有连接的渠道openclaw channels list

🔄 日常管理命令

# 查看版本openclaw --version# 更新到最新版本npm update -g openclaw@latest# 切换更新通道openclaw update --channel stable|beta|dev# 诊断问题openclaw doctor# 查看日志openclaw logs# 停止服务openclaw stop

❓ 常见问题

安装问题

Q: 提示 Node 版本过低怎么办?

# 更新 Node.js 到最新 LTS 版本nvm install 22nvm use 22node --version  # 确认版本 >= 22.12.0

Q: 全局安装失败,提示权限错误?

# macOS/Linux: 使用 sudosudo npm install -g openclaw@latest# 或修改 npm 全局目录(推荐)mkdir ~/.npm-globalnpm config set prefix '~/.npm-global'# 然后将 ~/.npm-global/bin 添加到 PATH

Q: Windows 用户如何安装?

强烈建议使用 WSL2 (Windows Subsystem for Linux):

# 在 PowerShell (管理员) 中wsl --install# 重启后,在 WSL2 Ubuntu 环境中按照 Linux 方式安装

配置问题

Q: onboard 向导中断了怎么办?

可以随时重新运行:

# 重新开始配置openclaw onboard --install-daemon# 或查看当前配置openclaw config show

Q: 如何连接多个聊天平台?

# 添加新渠道openclaw channels add whatsappopenclaw channels add telegram# 查看已连接的渠道openclaw channels list

Q: 支持哪些 AI 模型?

• Anthropic: Claude Pro/Max (推荐 Opus 4.6)
• OpenAI: ChatGPT/Codex
• 其他兼容 OpenAI API 的模型

配置模型:

openclaw models configure

使用问题

Q: 服务没有正常运行?

# 检查服务状态openclaw status# 查看日志排查问题openclaw logs# 重启服务openclaw restart# 使用诊断工具openclaw doctor

Q: 如何更新到最新版本?

# 更新工具npm update -g openclaw@latest# 检查更新openclaw --version# 运行诊断确保配置正确openclaw doctor

Q: 如何完全卸载?

# 停止服务openclaw stop# 卸载全局包npm uninstall -g openclaw# 删除数据(可选)rm -rf ~/.openclaw

✅ 安装完成检查清单

• Node.js 版本 >= 22.12.0
• 全局安装 openclaw 成功
• openclaw onboard 配置完成
• Gateway 服务正常运行
• 至少连接一个聊天平台
• AI 模型配置成功

📚 下一步学习

官方资源

•
阅读官方文档

• 完整文档: https://docs.openclaw.ai
• 快速开始: https://docs.openclaw.ai/start/getting-started
• 常见问题: https://docs.openclaw.ai/start/faq

•
加入社区

• Discord: https://discord.gg/clawd
• GitHub: https://github.com/openclaw/openclaw

•
探索高级功能

• 自定义技能开发
• Canvas 实时界面
• 多设备同步

💡 使用建议

• 🔥 推荐使用 Anthropic Claude Pro/Max + Opus 4.6 - 长上下文能力更强,抗提示注入更好
• 💾 定期备份配置 - ~/.openclaw 目录包含所有配置和数据
• 🔄 关注更新 - OpenClaw 持续快速迭代,建议定期更新
• 📖 遇到问题先看日志 - openclaw logs 能快速定位问题

🎉 结语

恭喜你完成了 OpenClaw 的安装!现在你可以在自己的设备上运行一个强大的个人 AI 助手了。

记住核心命令:

# 一键初始化openclaw onboard --install-daemon# 启动服务openclaw gateway# 与 AI 对话openclaw agent --message "你的问题"# 诊断问题openclaw doctor

祝你使用愉快!有问题随时查阅文档或加入社区寻求帮助! 🚀

关键词: #OpenClaw #AI助手 #开源工具 #安装教程 #本地AI #隐私优先

相关链接:

• 官网: https://openclaw.ai
• 文档: https://docs.openclaw.ai
• GitHub: https://github.com/openclaw/openclaw
• Discord: https://discord.gg/clawd

.preview-wrapper pre::before { position: absolute; top: 0; right: 0; color: #ccc; text-align: center; font-size: 0.8em; padding: 5px 10px 0; line-height: 15px; height: 15px; font-weight: 600; }

.hljs.code__pre > .mac-sign { display: none; }

h2 strong { color: inherit !important; }