OpenClaw 新手入门指南 - 从部署到运行快速搞定!

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 月的最新版本编写，如有更新请参考官方文档。
祝你使用愉快！🦞

Skill	用途
`tavily-search-skill`	高质量网页搜索
`self-improving-agent`	自动学习和改进
`miaoda-web-fetch`	网页内容抓取
`miaoda-image-understanding`	图片理解分析
`feishu-bitable`	飞书多维表格管理
`feishu-calendar`	飞书日历管理