02-OpenClaw 快速上手 5 分钟搭建第一个 AI 应用

专栏OpenClaw_AI 应用实战 第 2 篇字数约 8500 字阅读时间约 20 分钟难度⭐ 入门更新时间2026-04-01写在前面5 分钟能做什么刷 2 条短视频喝半杯咖啡安装并运行 OpenClaw和 AI 助手第一次对话如果你已经看过第 1 篇知道 OpenClaw 是什么现在让我们动手做起来。本文目标✅ 完成 OpenClaw 安装3 分钟✅ 运行引导向导1 分钟✅ 打开控制面板第一次对话1 分钟✅ 了解后续可以做什么无需准备❌ 不需要编程经验❌ 不需要服务器❌ 不需要信用卡仅使用免费额度一、安装前的准备1.1 系统要求系统最低配置推荐配置macOSM1/Intel, 4GB 内存M2, 8GB 内存Linux2 核4GB 内存4 核8GB 内存WindowsWSL2, 4GB 内存WSL2, 8GB 内存存储空间2GB 可用空间10GB 可用空间检查 Node.js 版本node--version需要Node 22。如果没有安装脚本会自动处理。1.2 网络要求OpenClaw 需要访问openclaw.ai- 下载安装脚本npm registry- 安装依赖包api.anthropic.com或api.openai.com- AI 模型 API中国大陆用户注意# 设置 npm 镜像可选加速下载npmconfigsetregistry https://registry.npmmirror.com# 设置 API 代理如果需要exportHTTPS_PROXYhttp://127.0.0.1:7890二、快速安装3 分钟2.1 一键安装推荐macOS/Linux/WSL2curl-fsSLhttps://openclaw.ai/install.sh|bashWindows (PowerShell)iwr-useb https://openclaw.ai/install.ps1|iex安装过程 OpenClaw Installer ✓ 检查 Node.js 版本... (v24.14.0) ✓ 下载 openclaw CLI... ✓ 安装到 /usr/local/bin/openclaw ✓ 验证安装... 安装完成 接下来运行引导向导 openclaw onboard --install-daemon2.2 验证安装# 检查版本openclaw--version# 输出示例# openclaw/0.8.12 linux-x64 node-v24.14.02.3 其他安装方法方法 2npm 安装如果你已有 Node 22 并且想手动控制npminstall-gopenclawlatest openclaw onboard --install-daemon遇到问题# sharp 构建错误macOS 常见SHARP_IGNORE_GLOBAL_LIBVIPS1npminstall-gopenclawlatest# 或者安装构建工具xcode-select--install# macOSnpminstall-gnode-gyp方法 3Docker 安装适合服务器部署dockerrun-d\--nameopenclaw\-p18789:18789\-v~/.openclaw:/root/.openclaw\openclaw/openclaw:latest方法 4从源码安装适合开发者gitclone https://github.com/openclaw/openclaw.gitcdopenclawpnpminstallpnpmbuildpnpmlink--globalopenclaw onboard --install-daemon三、引导向导1 分钟运行向导openclaw onboard --install-daemon3.1 向导步骤详解步骤 1选择模式 OpenClaw Onboarding Wizard 选择设置模式 1) QuickStart推荐使用默认配置 2) Advanced完全控制 请输入选择 [1]:新手选 1老手选 2。步骤 2配置 AI 模型选择 AI 提供商 1) Anthropic (Claude) 2) OpenAI (GPT-4) 3) Google (Gemini) 4) 自定义 (OpenAI 兼容) 请输入选择 [1]: 1 输入 API Key: ***********************API Key 获取提供商免费额度获取链接Anthropic$5新用户https://console.anthropic.comOpenAI$5新用户https://platform.openai.comGoogle免费有限额https://aistudio.google.com安全提示API Key 存储在~/.openclaw/openclaw.json文件权限自动设置为600仅所有者可读不要分享到 GitHub 或公开场合步骤 3选择工作空间选择工作空间目录 默认~/.openclaw/workspace 按 Enter 使用默认或输入自定义路径工作空间存放什么AGENTS.md- AI 助手的行为指南SOUL.md- AI 的人格设定skills/- 自定义技能memory/- 长期记忆文件步骤 4网关配置网关配置 端口18789 绑定地址127.0.0.1仅本地访问 认证方式Token自动生成 是否启用 Tailscale 远程访问[y/N]: N配置说明配置项默认值说明端口18789Web 控制面板端口绑定地址127.0.0.1仅本地访问安全认证Token自动生成的随机令牌Tailscale关闭需要远程访问时开启步骤 5安装守护进程是否安装系统服务开机自启[Y/n]: Y ✓ 创建 systemd 服务Linux ✓ 启动 openclaw-gateway 服务 ✓ 设置开机自启服务管理命令# 查看状态openclaw gateway status# 重启服务openclaw gateway restart# 停止服务openclaw gateway stop# 查看日志journalctl-uopenclaw-gateway-f# Linuxtail-f~/Library/LaunchAgents/openclaw.plist# macOS步骤 6健康检查 健康检查... ✓ 网关正在运行 (端口 18789) ✓ 工作空间已创建 ✓ 配置文件已生成 ✓ API 连接测试成功 设置完成 下一步 openclaw dashboard # 打开控制面板四、第一次对话1 分钟4.1 打开控制面板openclaw dashboard浏览器自动打开http://127.0.0.1:18789/首次连接粘贴网关 Token在~/.openclaw/openclaw.json中点击连接进入聊天界面4.2 第一次对话试试这些命令你好介绍一下你自己 帮我写一个 Python 函数计算斐波那契数列 读取当前目录的 package.json 文件 搜索最新的 AI 新闻示例对话你帮我写一个 Python 函数计算斐波那契数列 AI: 好的我来写一个计算斐波那契数列的函数。 使用 write 工具创建文件... ✅ 已创建 fibonacci.py def fibonacci(n): 计算斐波那契数列的第 n 项 if n 0: return 0 elif n 1: return 1 else: return fibonacci(n-1) fibonacci(n-2) # 测试 for i in range(10): print(ffibonacci({i}) {fibonacci(i)}) 需要我运行测试吗4.3 查看工具调用在控制面板中你可以看到工具调用记录AI 使用了哪些工具Token 使用统计每次对话的成本文件操作历史创建/修改了哪些文件五、连接消息渠道可选5.1 连接 WhatsApp# 1. 登录 WhatsAppopenclaw channels login whatsapp# 2. 扫描二维码用手机 WhatsApp# 3. 验证连接openclaw channels status whatsapp配置白名单// ~/.openclaw/openclaw.json { channels: { whatsapp: { allowFrom: [8613800138000] // 只允许这个号码 } } }测试openclaw message send\--target8613800138000\--messageHello from OpenClaw5.2 连接 Telegram# 1. 创建 Bot找 BotFather# 2. 获取 Bot Token# 3. 配置openclaw configure--sectiontelegram配置示例{ channels: { telegram: { botToken: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz } } }5.3 连接 Discord# 1. 创建 Discord 应用https://discord.com/developers# 2. 创建 Bot获取 Token# 3. 邀请 Bot 到服务器# 4. 配置openclaw configure--sectiondiscord六、常用命令速查6.1 网关管理# 查看状态openclaw gateway status# 启动网关openclaw gateway# 重启网关openclaw gateway restart# 停止网关openclaw gateway stop# 查看日志openclaw logstail6.2 配置管理# 打开配置向导openclaw configure# 编辑配置文件openclaw config edit# 验证配置openclaw doctor6.3 会话管理# 列出会话openclaw sessions list# 查看会话历史openclaw sessionshistorymain# 发送消息到会话openclaw sessions send main你好6.4 技能管理# 列出技能openclaw skills list# 安装技能clawhubinstallweather# 启用技能openclaw skillsenableweather# 禁用技能openclaw skills disable weather6.5 定时任务# 列出任务openclawcronlist# 添加任务openclawcronadd\--schedule0 9 * * *\--commandmessage send --target 8613800138000 --message 早安# 运行任务openclawcronrunjobId# 删除任务openclawcronremovejobId七、常见问题Q1安装失败提示 Node 版本过低解决方案# 方法 1使用 nvm 安装 Node 22curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh|bashnvminstall22nvm use22# 方法 2直接下载# https://nodejs.org/en/download/Q2网关启动失败端口被占用诊断# 查看谁在使用 18789 端口lsof-i:18789# macOS/Linuxnetstat-ano|findstr :18789# Windows解决# 方法 1停止占用进程killPID# 方法 2修改端口openclaw configure# 修改 gateway.port 为其他值如 18790Q3控制面板无法连接检查步骤# 1. 检查网关状态openclaw gateway status# 2. 检查端口监听netstat-tlnp|grep18789# 3. 检查防火墙sudoufw allow18789# Ubuntusudofirewall-cmd --add-port18789/tcp# CentOS常见原因原因解决方案网关未启动openclaw gateway start端口被占用修改配置或停止占用进程防火墙阻止开放 18789 端口Token 错误重新获取 TokenQ4API Key 无效检查# 查看配置cat~/.openclaw/openclaw.json|grep-A5auth# 测试连接curl-HAuthorization: Bearer YOUR_API_KEY\https://api.anthropic.com/v1/models常见错误错误信息原因解决方案401 UnauthorizedAPI Key 错误重新获取403 Forbidden额度不足充值或换账号429 Too Many Requests频率限制等待或升级Q5消息渠道连接失败WhatsApp# 重新登录openclaw channelslogoutwhatsapp openclaw channels login whatsappTelegram# 检查 Bot Tokenopenclaw configure--sectiontelegram# 重新输入 TokenDiscord# 检查 Bot 权限# 确保 Bot 已邀请到服务器并有发送消息权限八、下一步学习8.1 入门任务清单完成这些任务熟悉 OpenClaw安装 OpenClaw5 分钟运行引导向导5 分钟打开控制面板第一次对话5 分钟让 AI 帮你写一个脚本10 分钟让 AI 帮你读取/修改文件10 分钟配置一个消息渠道15 分钟设置一个定时任务10 分钟预计总时间1 小时8.2 进阶学习路径第 1 周熟悉基础 - 工具系统文件、浏览器、命令行 - 技能系统安装、配置、自定义 - 会话管理历史、多会话 第 2 周实战应用 - RAG 知识库搭建 - 数据分析 Agent - 自动化办公 第 3 周高级用法 - 多 Agent 协作 - 插件开发 - 生产部署8.3 资源推荐官方文档OpenClaw 文档GitHub 仓库ClawHub 技能市场社区Discord 社区Twitter视频教程5 分钟快速上手待发布深度解析系列待发布总结核心要点安装简单一行命令3 分钟完成配置灵活向导式设置新手友好功能强大文件、浏览器、命令行、网络搜索扩展性强技能系统、多 Agent、定时任务成本低廉仅 API 费约 $15-20/月你已经完成✅ 安装 OpenClaw✅ 配置 AI 模型✅ 打开控制面板✅ 第一次对话✅ 了解后续学习路径下一步下一篇如何向 AI 描述需求 提示词工程实战学习如何写出高质量的 Prompt让 AI 更好地理解你的需求。互动环节问题 1你安装过程中遇到了什么问题如何解决的问题 2你第一次让 AI 做了什么任务问题 3你最想用 OpenClaw 自动化什么工作欢迎在评论区留言字数约 8500 字阅读时间约 20 分钟难度⭐ 入门发布时间2026-04-01本文是《OpenClaw_AI 应用实战》专栏的第 2 篇共 20 篇。