OpenClaw 安装教程：小白10分钟从零部署个人AI助手

Prerequisites

OpenClaw 是一款开源的个人AI助手（Agent框架），支持本地运行大模型、执行电脑操作、接入飞书/钉钉/Telegram等，支持技能扩展。

在开始前，确保满足以下条件：

• 操作系统：Windows 10/11（推荐）、macOS 12+、Linux（Ubuntu 20.04+ 或其他主流发行版）
• Node.js：v20 或 v22（安装脚本会自动处理，但建议提前准备）
• Git：用于部分手动安装（Windows用户推荐安装）
• 硬件：至少4GB内存（推荐8GB+），特别是使用本地模型时需更高配置
• 网络：需要访问GitHub、npm registry，可能需要科学上网获取模型API
• API Key（可选但强烈推荐）：OpenAI、Groq、DeepSeek、通义千问、Claude等兼容OpenAI接口的密钥

小提示：若电脑存放重要隐私数据，建议使用干净环境或云服务器运行。

Step 1: 选择并执行一键安装（推荐方式）

官方推荐使用安装脚本，几分钟内完成Node.js检测/安装及初始配置。

Windows 用户（PowerShell方式）

1. 按 Win + S 搜索 PowerShell，右键选择 以管理员身份运行
2. 复制并粘贴以下命令，然后回车执行：

powershell irm https://openclaw.ai/install.ps1 | iex

或使用curl（若已安装）：

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

脚本会自动：

• 检查/安装 Node.js
• 全局安装 openclaw CLI
• 启动 onboarding 向导

macOS / Linux 用户（Terminal）

1. 打开 终端（Terminal）
2. 执行以下命令：

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

脚本运行中可能需要输入电脑密码（sudo权限）。

预期输出示例（部分）

Detected OS: darwin-arm64 Installing Node.js via nvm... Installing openclaw@latest... Running onboarding wizard... ? Welcome to OpenClaw! Press Enter to continue

Step 2: 完成Onboard向导配置

安装完成后会自动进入交互式配置向导，按提示操作：

1. 选择语言 → 简体中文（或English）
2. AI模型提供商 → 推荐：OpenRouter / Groq / DeepSeek / 通义千问（免费额度较高）
   • 输入你的 API Key
   • 选择模型（如 qwen-max、deepseek-chat、claude-3.5-sonnet 等）
3. 聊天渠道（Gateway）→ 推荐先选 Web UI 或 Terminal 测试
   • 后续可添加飞书、钉钉、Telegram、Discord等
4. 技能（Skills） → 默认开启 Shell、Browser、File 等核心技能
5. Gateway设置 → 设置访问密码（重要！防止未授权访问）

配置完成后会显示类似信息：

OpenClaw Gateway running at http://localhost:8765 Admin password: xxxxxxxx Happy clawing!

Step 3: 启动并测试OpenClaw

• Web界面：浏览器打开 http://localhost:8765，输入刚才设置的密码登录
• 终端聊天：在任意终端输入

bash openclaw chat

输入测试指令：

帮我在桌面创建一个叫test.txt的文件，内容是"Hello OpenClaw"

观察是否成功创建文件。

• 查看日志：

bash openclaw logs

Common Issues & Troubleshooting

• 安装卡住 / Node安装失败：手动下载安装 Node.js 22 LTS（https://nodejs.org），然后重新运行脚本
• 权限错误（macOS）：确保终端有“完全磁盘访问”权限（系统设置 → 隐私与安全性）
• API Key无效：检查是否复制完整，确认提供商支持的模型名称
• 端口8765被占用：修改配置文件或杀掉占用进程
• 浏览器打开空白：确认Gateway已启动，尝试 http://127.0.0.1:8765
• 技能执行失败：检查是否给了OpenClaw足够的系统权限（如屏幕录制、辅助功能）
• 中文乱码：确保终端编码为UTF-8

遇到问题可运行自检：

bash openclaw doctor

Next Steps

• 配置飞书/钉钉/Telegram机器人，让AI在聊天软件里响应
• 探索更多Skills：如Playwright浏览器自动化、代码执行、数据库查询等
• 尝试多Agent协作：创建Researcher + Coder + Executor团队
• 部署到云服务器实现7×24小时在线
• 加入OpenClaw社区交流经验（GitHub Discussions 或相关群组）

现在你已拥有一个强大的本地AI助手，快去释放它的潜力吧！