夜雨聆风OpenClaw 新手入门指南
📅 更新时间：2026-03-20🎯 适合人群：零基础想快速上手 OpenClaw 的用户
一、什么是 OpenClaw？
OpenClaw 是一款面向个人与团队的低门槛 AI 自动化代理工具，可替代人工完成流程化、重复性工作，无需用户掌握编程技能，适配多场景自动化需求。
核心价值
传统聊天机器人 | OpenClaw |
|---|---|
只能回答问题 | 思考 - 行动 - 反馈循环执行任务 |
被动响应 | 主动执行复杂工作流 |
纯对话交互 | 可调用工具、管理文件、安排日程等 |
简单说：让 AI 从"陪聊助手"升级为"能干活的员工"。
二、快速安装（10 分钟搞定）
方式一：一键安装脚本（推荐）
curl -fsSL https://openclaw.ai/install.sh | bash方式二：npm 安装
npm install -g openclaw@latest# 或pnpm add -g openclaw@latest
系统要求
Node.js: 22.0.0+
Git: 已安装
操作系统: Windows / macOS / Linux
Windows 用户特别注意
以管理员身份运行 PowerShell
如遇权限问题，执行：
如路径未识别，手动添加环境变量：
找到安装目录（如
C:\nodejs\node\_global\openclaw\）添加到系统 PATH
三、初始化配置（onboard 向导）
安装完成后，运行：
openclaw onboard向导会引导你完成以下配置：
1️⃣ 选择 AI 模型
推荐选项：
Kimi-K2.5
Qwen（阿里百炼）- 性价比高
Minimax - 中文能力强
Claude - 综合能力强
💡 提示：需要先到对应平台注册账号获取 API Key
2️⃣ 选择聊天渠道
可选：
飞书（推荐国内用户）
Telegram
Slack
企业微信
跳过（先用 Web UI）
3️⃣ 启用技能（Skills）
根据提示选择是否启用 Skills 系统（建议启用）
4️⃣ 启动 Gateway 服务
openclaw gateway run --port 18789或直接访问 Web UI：
http://127.0.0.1:18789/#token=你的值
四、接入飞书（详细步骤）
步骤 1：创建飞书应用
访问飞书开放平台
创建企业自建应用
获取 App ID 和 App Secret
步骤 2：配置 Bot Token
在 OpenClaw 配置中设置
openclaw config set channels.feishu.botToken "你的 Bot_Token"步骤 3：配对验证
openclaw pairing approve feishu <验证码>步骤 4：测试连接
在飞书中向 Bot 发送消息，确认能正常回复。
五、常用命令速查
Gateway 管理
# 启动systemctl --user start openclaw-gateway.service# 重启systemctl --user restart openclaw-gateway.service# 停止systemctl --user stop openclaw-gateway.service# 查看状态systemctl --user status openclaw-gateway.service
模型管理
# 列出可用模型openclaw models list# 切换默认模型openclaw models auth login --provider <provider> --set-default# 测试模型openclaw models test <model-name>
配置管理
# 查看帮助/help# 查看连接状态/status# 切换 Agent/agent# 切换 Session/session# 重置当前 Session/new# 中止当前运行/abort
六、Skills 扩展系统
OpenClaw 最强大的功能之一：Skills 系统
什么是 Skills？
Skills 是模块化的功能包，可以扩展 OpenClaw 的能力。每个 Skill 包含特定功能的实现。
生态规模
内置: 49 个
官方: 93 个
社区: 1715+ 个
总计: 1800+ 个可用 Skills
安装 Skill
# 通过 clawhub 安装clawhub install <skill-name># 示例：安装搜索技能clawhub install tavily-search-skill# 示例：安装自我改进技能clawhub install self-improving-agent
常用 Skills 推荐
Skill
用途
tavily-search-skill
高质量网页搜索
self-improving-agent
自动学习和改进
miaoda-web-fetch
网页内容抓取
miaoda-image-understanding
图片理解分析
feishu-bitable
飞书多维表格管理
feishu-calendar
飞书日历管理
七、实战案例
案例 1：文件管理帮我从 1000 张图片中找到跑步机发票
案例 2：自动报销
整理这些发票，自动填写报销单 Excel
案例 3：批量重命名
根据文件内容自动重命名这些文档
案例 4：知识管理
保存这篇技术文章到备忘录，并提取关键点
案例 5：定时推送
每天早上 9 点推送 AI 行业资讯
八、常见问题 FAQ
Q1: 安装失败怎么办？
检查项：
Node.js 版本是否 >= 22.0.0
网络是否正常（可能需要科学上网）
权限是否足够（Windows 需管理员权限）
Q2: Gateway 启动失败？
解决方案：
# 查看详细日志 openclaw gateway --verbose # 检查端口占用 lsof -i :18789 # 更换端口 openclaw gateway run --port 18790
Q3: 飞书 Bot 不回复？
检查项：
Bot Token 是否正确配置
配对验证是否完成
Gateway 服务是否正常运行
飞书应用权限是否开启
Q4: 如何省钱使用？
优先使用免费额度高的模型
配置多个模型，按需切换
使用本地模型（如 Ollama）
避免频繁调用高成本 API
Q5: 如何保证安全？
⚠️ 重要建议：
使用备用设备或云端 VPS部署
不要在生产环境直接运行
敏感数据做好隔离
定期备份配置文件
九、学习资源
官方资源
官网: https://openclaw.ai
GitHub: https://github.com/openclaw/openclaw
文档: https://docs.openclaw.ai
Discord: https://discord.com/invite/clawd
社区教程
腾讯云开发者社区: OpenClaw 新手入门
CSDN: 从零开始：OpenClaw 完整安装配置实战指南
知乎: OpenClaw 完整本地部署安装与使用指南
GitHub 教程集合: awesome-openclaw-tutorial
视频教程
Bilibili: OpenClaw 新手必看教程
YouTube: 小白到高手！零基础 OpenClaw 系统教程
十、下一步
✅已完成：安装 + 基础配置
🎯 建议接下来：
熟悉 Web UI - 在浏览器中和 AI 对话，测试基本功能
接入飞书/Telegram - 在常用聊天工具中使用
安装 3-5 个 Skills - 扩展 AI 能力
尝试自动化工作流 - 让 AI 帮你完成实际任务
加入社区 - 获取更多技巧和案例分享
附录：配置文件模板
多模型配置示例
{ "models": { "default": "qwen-portal/vision-model", "providers": { "qwen": { "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "apiKey": "your-key" }, "minimax": { "baseUrl": "https://api.minimax.chat/v1", "apiKey": "your-key" } } }}
飞书双机器人配置
{ "channels": { "feishu": { "bots": [ { "name": "主助理", "token": "token-1", "purpose": "日常对话" }, { "name": "技术助手", "token": "token-2", "purpose": "代码相关" } ] } }}
💡 提示：本教程基于 2026 年 3 月的最新版本编写，如有更新请参考官方文档。
祝你使用愉快！🦞
