OpenClaw 完整教程：从安装到使用（官方脚本版）

1. 引言

OpenClaw 是一个强大的开源工具，它能够帮助用户高效地管理和操作云资源。对于许多开发者和运维人员来说，掌握 OpenClaw 可以极大地提升工作效率。本教程将带你从零开始，使用官方提供的脚本，一步步完成 OpenClaw 的安装、配置与基本使用，让你快速上手。

2. 环境准备

在开始安装之前，请确保你的系统满足以下基本要求：

操作系统：推荐使用 Ubuntu 20.04+ 或 CentOS 7+ 等主流 Linux 发行版。
网络环境：确保服务器能够正常访问互联网，以便下载安装脚本和依赖包。
用户权限 ：你需要拥有 sudo 权限来执行安装命令。
依赖工具 ：系统需预装 curl 或 wget 工具，用于下载脚本。

你可以使用以下命令检查 curl 是否已安装：

bash 复制代码

curl --version

如果未安装，可以使用包管理器进行安装：

bash 复制代码

# Ubuntu/Debian
sudo apt update && sudo apt install curl -y

# CentOS/RHEL
sudo yum install curl -y

3. 安装 OpenClaw（官方脚本版）

OpenClaw 官方提供了便捷的一键安装脚本，这是最推荐的方式，可以自动处理依赖和环境配置。

3.1 下载并执行安装脚本

打开终端，执行以下命令以下载并运行官方安装脚本：

bash 复制代码

curl -fsSL https://raw.githubusercontent.com/openclaw/installer/main/install.sh | sudo bash

或者，如果你更习惯使用 wget：

bash 复制代码

wget -qO- https://raw.githubusercontent.com/openclaw/installer/main/install.sh | sudo bash

3.2 安装过程解析

脚本执行过程中会进行以下操作：

检测系统环境：自动识别你的操作系统和架构。
下载二进制文件：从官方源下载适用于你系统的最新版 OpenClaw 可执行文件。
安装至系统路径 ：将可执行文件移动到 /usr/local/bin 或类似目录，确保你可以在任何位置直接使用 openclaw 命令。
创建配置文件目录 ：在 /etc/openclaw/ 下创建默认的配置文件目录。

安装成功后，终端会显示类似 OpenClaw installed successfully! 的提示。

3.3 验证安装

安装完成后，运行以下命令验证 OpenClaw 是否安装成功：

bash 复制代码

openclaw version

如果能看到版本号信息，说明安装已成功。

4. 基础配置

安装完成后，我们需要进行一些基础配置，让 OpenClaw 能够连接到你的云服务商。

4.1 初始化配置文件

运行初始化命令，它会为你生成一个默认的配置文件模板：

bash 复制代码

openclaw init

该命令会在 ~/.openclaw/config.yaml 路径下生成配置文件。

4.2 配置云服务商凭证

编辑配置文件 ~/.openclaw/config.yaml，添加你的云服务商凭证。以阿里云为例，配置如下：

yaml 复制代码

providers:
  - name: aliyun
    type: alicloud
    access_key_id: "YOUR_ACCESS_KEY_ID"
    access_key_secret: "YOUR_ACCESS_KEY_SECRET"
    region: "cn-hangzhou"

请务必将 YOUR_ACCESS_KEY_ID 和 YOUR_ACCESS_KEY_SECRET 替换为你自己的 AccessKey 信息。你可以在云服务商的控制台安全中心创建和管理 AccessKey。

4.3 测试连接

配置完成后，使用以下命令测试与云服务商的连接是否正常：

bash 复制代码

openclaw provider list

如果配置正确，你将看到已配置的云服务商信息。

5. 核心功能与使用示例

OpenClaw 提供了丰富的命令来管理云资源。以下是一些常用的操作示例。

5.1 管理云服务器（ECS）

列出所有实例：
bash 复制代码
```
openclaw ecs list
```

启动一个实例：

bash 复制代码

openclaw ecs start --instance-id "i-xxxxxxxxxxxxx"

停止一个实例：

bash 复制代码

openclaw ecs stop --instance-id "i-xxxxxxxxxxxxx"

5.2 管理对象存储（OSS）

列出所有存储空间（Bucket）：
bash 复制代码
```
openclaw oss list
```

上传文件：

bash 复制代码

openclaw oss upload --bucket "my-bucket" --file "/path/to/local/file.txt" --key "remote/path/file.txt"

下载文件：

bash 复制代码

openclaw oss download --bucket "my-bucket" --key "remote/path/file.txt" --file "/path/to/local/file.txt"

5.3 管理域名解析（DNS）

添加一条 DNS 记录：

bash 复制代码

openclaw dns add --domain "example.com" --rr "www" --type "A" --value "1.2.3.4"

6. 进阶技巧

使用环境变量：为了避免在配置文件中明文存储敏感信息，你可以使用环境变量来传递 AccessKey。
bash 复制代码
```
export ALICLOUD_ACCESS_KEY_ID="YOUR_ACCESS_KEY_ID"
export ALICLOUD_ACCESS_KEY_SECRET="YOUR_ACCESS_KEY_SECRET"
openclaw ecs list
```
批量操作 ：结合 Shell 脚本，你可以轻松实现批量管理。例如，批量停止所有名称中包含 test 的实例。
查看帮助 ：任何时候，你都可以使用 --help 参数来获取命令的详细用法。
bash 复制代码
```
openclaw --help
openclaw ecs --help
```

7. 常见问题与排错

问题：openclaw: command not found
- 解决：安装可能未成功或未将 OpenClaw 添加到 PATH。请重新运行安装脚本，或检查 /usr/local/bin 是否在 PATH 中。
问题：连接云服务商失败，提示认证失败
- 解决：请检查 config.yaml 中的 access_key_id 和 access_key_secret 是否正确，以及该 AccessKey 是否拥有操作相关资源的权限。
问题：执行命令时提示权限不足
- 解决：某些操作（如启动、停止实例）需要更高的权限。请确保你使用的 AccessKey 关联的 RAM 角色拥有相应的权限。

8. 总结

通过本教程，你已经学会了如何使用官方脚本安装 OpenClaw，并掌握了其基础配置和核心功能的使用方法。OpenClaw 的强大之处在于其统一的命令行接口，让你能够高效地管理多云环境。建议你多查阅官方文档，探索更多高级功能，以充分发挥其潜力。