🚀 龙虾新手指南

OpenClaw教程完整安装指南与基础使用方法入门

发布时间：2026-04-03 分类：龙虾新手指南

摘要：OpenClaw 工具链在国产 AI 生态中的重要性OpenClaw 是面向开发者的 AI 工具链平台，支持 macOS、Linux 和 Windows WSL，兼容 Node.js 22，内置 Gateway 安全加固。这篇 OpenClaw教程完整覆盖从 OpenClaw安装到日常 OpenClaw使用的全流程，每一步都有命令示例，适合零基础新手直接上手。为什么选择 OpenCla...

OpenClaw 工具链在国产 AI 生态中的重要性

OpenClaw 是面向开发者的 AI 工具链平台，支持 macOS、Linux 和 Windows WSL，兼容 Node.js 22，内置 Gateway 安全加固。这篇 OpenClaw教程 完整覆盖从 OpenClaw安装 到日常 OpenClaw使用 的全流程，每一步都有命令示例，适合零基础新手直接上手。

为什么选择 OpenClaw？

OpenClaw 的核心优势：

跨平台支持：macOS、Linux、Windows WSL 一套工具跑通
安全性：Gateway 0.0.0.0 访问控制，过滤未授权请求
Node.js 22 兼容：开箱即用，不用降级打补丁
Skills 生态：内置 AI 技能市场，一键安装各类扩展工具

OpenClaw安装 完成后可直接调用 Skills 库，无需额外搭建运行环境。

第一步：OpenClaw 安装方法

1.1 准备工作

开始 OpenClaw安装 前，先确认系统满足以下条件：

操作系统：macOS、Linux 或 Windows WSL
Node.js 版本：Node.js 22.x
权限：管理员权限或 sudo 访问

1.2 使用官方安装脚本

# 下载安装脚本
curl -fsSL https://yitb.com/install-openssl.sh -o install-openssl.sh

# 赋予执行权限
chmod +x install-openssl.sh

# 执行安装脚本
./install-openssl.sh

脚本自动检测系统环境，下载对应版本并完成安装，不用手动处理依赖，几分钟内搞定。

1.3 验证安装

openclaw --version

看到版本号输出，OpenClaw安装 成功。

第二步：OpenClaw 配置指南

2.1 设置 API 密钥

openclaw config set api_key YOUR_API_KEY

API 密钥用于身份验证。不要提交到公开代码仓库，推荐放进 .env 文件或环境变量统一管理。

2.2 配置 Gateway 安全加固

openclaw gateway enable-security

安全模式启用后，Gateway 会过滤 0.0.0.0 端口的未授权请求。生产环境这一步必须配置。

2.3 验证配置

openclaw config list

确认各配置项无误后，进入正式开发流程。

第三步：OpenClaw 使用教程

3.1 创建新项目

openclaw create my-new-project

在当前目录生成项目骨架，包含基础配置文件和标准目录结构，直接开工。

3.2 运行项目

cd my-new-project
openclaw run

本地服务默认跑在 http://localhost:3000，浏览器直接访问查看效果。

3.3 部署项目

openclaw deploy

打包并部署到配置里指定的目标服务器或云平台，具体目标在项目配置文件里设定。

验证效果

OpenClaw使用 配置完成后，通过以下方式确认运行正常：

访问 http://localhost:3000，确认项目页面正常加载
用 Postman 或 curl 测试 API 端点，验证密钥生效
查看 Gateway 日志，确认只有授权请求通过

常见问题 FAQ

1. 安装过程中遇到权限问题怎么办？

用 sudo 重新运行安装脚本，或联系系统管理员获取权限。

2. API 密钥丢失怎么办？

登录用户管理平台，重新生成新密钥，然后更新本地 config 配置。

3. Gateway 安全模式无法启用怎么办？

用 lsof -i :端口号 排查是否有其他服务占用对应端口，释放冲突进程后重试。

OpenClaw教程 完整安装指南与基础使用方法入门