# Aethir Claw 详细部署指南

### 本指南涵盖内容

| 🖥️ 购买与配置         | 🔑 API Key             | ⚡ AethirClaw 配置 |
| ----------------- | ---------------------- | --------------- |
| 云服务器实例购买、SSH 密钥配置 | 注册 LLM 平台账号并获取 API Key | 安装、配置模型、频道与浏览器  |

***

## 1. 前置准备

### 1.1 购买云服务器实例

访问 [https://claw.aethir.com](https://claw.aethir.com/)，登录后购买云服务器实例。

**操作步骤：**

1. 在 **"Plans"** 页面，点击 **"+ New Instance"**，选择偏好的区域和实例规格，然后点击 **"Get Started"** 完成购买。
2. 确认配置后，选择**按月**或**按年**付款，点击 **"Proceed to Checkout"**。
3. 在结算页面，如有折扣码可在 **"Promo Code"** 栏填写，否则留空。选择支付方式完成交易。

<figure><img src="/files/NbZ10NRauwdySpXrrrOz" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/KKRPNvNgbAbhG7XVmatI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/6yOLveJ1038RFpiblUpA" alt=""><figcaption></figcaption></figure>

### 1.2 生成 SSH 密钥并配置公钥

在本地机器上生成 SSH 密钥。打开本地电脑的命令行终端。如果你的机器上已有 SSH 密钥，可跳过此步骤。

***

**第一步：检查 `.ssh` 目录是否存在**

生成 SSH 密钥前，先确认系统中是否已有 SSH 密钥目录。

**Windows**

```
dir %USERPROFILE%\.ssh
```

**Mac / Linux**

```
ls -la ~/.ssh
```

* 如果看到文件或目录列表 → `.ssh` 目录已存在
* 如果看到 File Not Found → 目录不存在

***

**1.1 创建 `.ssh` 目录（如不存在）**

如果 `.ssh` 目录不存在，手动创建：

**Windows**

```
mkdir %USERPROFILE%\.ssh
```

**Mac / Linux**

```
mkdir -p ~/.ssh
```

***

**1.2 进入 `.ssh` 目录**

**Windows**

```
cd %USERPROFILE%\.ssh
```

**Mac / Linux**

```
cd ~/.ssh
```

***

**第二步：生成 SSH 密钥**

如果本地已有 SSH 密钥，可跳过第一步，直接从这里开始。

1. 打开命令提示符，进入 SSH 密钥目录：

```bash
cd C:\Users\%UserName%\.ssh
```

```bash
cd ~/.ssh
```

2. 生成 SSH 密钥（根据需要替换邮箱地址和文件名）：

```bash
ssh-keygen -t ed25519 -f aethir-claw -C "aethir-claw@aethir.com"
```

3. 提示输入 passphrase 时，按两次 **Enter** 跳过（不设密码），或输入 passphrase 以提高安全性。
4. 当前目录下会生成两个文件：

| 文件                | 说明                            |
| ----------------- | ----------------------------- |
| `aethir-claw`     | **私钥** — 妥善保管，切勿分享或复制到其他设备。   |
| `aethir-claw.pub` | **公钥** — 将其内容复制到 SSH Keys 页面。 |

<figure><img src="/files/m2F59mycG5yO77BHXAeH" alt=""><figcaption></figcaption></figure>

**第二步 — 将公钥添加到云服务器**

1. 在 `.ssh` 目录中找到 `aethir-claw.pub` 文件，用记事本（或任意文本编辑器）打开，复制全部内容。

也可以直接在终端获取公钥内容：

**Linux/macOS：**

```bash
cat filename.pub
```

或使用默认路径：`cat ~/.ssh/id_rsa.pub`

**Windows（命令提示符/PowerShell）：**

```powershell
type filename.pub
```

2. 在 AethirClaw 网页控制台，依次进入：**SSH Keys → Add your first key → Add Public Key**。将 `.pub` 文件的完整内容粘贴到 Public Key 输入框。
3. 购买云实例后，进入 **My Instances**，点击对应实例。在弹出的 **"Configure SSH Access"** 窗口中，点击 **"Deploy Keys"**，选择刚才配置的密钥，点击 **"Deploy Key"** 完成 SSH 密钥配置。
4. 在云服务器 Dashboard 的 **SSH Keys** 标签下，确认密钥已列出。可添加多个密钥或删除现有密钥。**配置 SSH 密钥后才能进行 SSH 访问。**

<figure><img src="/files/Th0MI1ZDxztvEbbrtzSO" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/DL07odEKWofaePpz9B2t" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/7ODPhe3HO6A4Qod2XgWR" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/8M5xJyrFuM1lMP5eLTgj" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/MHsouepDzVhHsWjS8jTM" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/jNyVQYfx6Zun0VfJd720" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ksVmjogt71mRHIH8rwg7" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**⚠ 重要** — 必须在实例上配置至少一个 SSH 密钥后，才能通过 SSH 访问云服务器。
{% endhint %}

### 1.3 注册 LLM 平台账号并获取 API Key

OpenClaw 需要来自大语言模型平台的 API Key（或 OAuth 授权）。请在以下平台中注册账号并申请 API Key，完成后再继续后续步骤。

<table><thead><tr><th>平台</th><th width="329">网址</th><th>备注</th></tr></thead><tbody><tr><td>OpenRouter</td><td><a href="https://openrouter.ai/">https://openrouter.ai/</a></td><td>推荐——聚合多种模型</td></tr><tr><td>智谱 AI（BigModel）</td><td><a href="https://bigmodel.cn/usercenter/proj-mgmt/apikeys">https://bigmodel.cn/usercenter/proj-mgmt/apikeys</a></td><td></td></tr><tr><td>通义千问（阿里云百炼）</td><td><a href="https://bailian.console.aliyun.com/cn-beijing/?tab=model#/api-key">https://bailian.console.aliyun.com/cn-beijing/?tab=model#/api-key</a></td><td></td></tr><tr><td>NVIDIA</td><td><a href="https://build.nvidia.com/">https://build.nvidia.com/</a></td><td></td></tr><tr><td>Gemini（Google）</td><td><a href="https://aistudio.google.com/api-keys">https://aistudio.google.com/api-keys</a></td><td></td></tr><tr><td>OpenAI</td><td><a href="https://openai.com/api/">https://openai.com/api/</a></td><td></td></tr><tr><td>xAI</td><td><a href="https://x.ai/api">https://x.ai/api</a></td><td></td></tr></tbody></table>

{% hint style="info" %}
**✔ 提示** — OpenRouter 是最简单的起点，一个 API Key 即可访问数十种模型（OpenAI、Anthropic、Google 等）。
{% endhint %}

***

## 2. AethirClaw 快速配置

### 2.1 通过 SSH 远程连接云服务器

在实例上配置 SSH 密钥后，AethirClaw 控制台会提供一条可直接使用的 SSH 命令。复制并在命令提示符中运行即可连接。

<figure><img src="/files/yyAcGQOVFBgWSWCdA50k" alt=""><figcaption></figcaption></figure>

**SSH 命令结构：** `ssh -i <private-key-file.pem> -p 10136 abc@98.98.111.3`

| 参数                          | 操作说明                         |
| --------------------------- | ---------------------------- |
| `-i <private-key-file.pem>` | 替换为实际的私钥文件名，例如 `aethir-claw` |
| `-p 10136 abc@98.98.113.3`  | **请勿修改** — IP、端口和用户名均由系统自动分配 |

**连接方式：**

```bash
# 先进入 SSH 密钥所在目录（Windows 示例）：
cd C:\Users\Administrator\.ssh

# 运行从控制台复制的 SSH 命令（以下为示例）：
ssh -i aethir-claw -p 10136 abc@98.98.113.3
```

<figure><img src="/files/fIuii8dTHEa28arDZlnJ" alt=""><figcaption></figcaption></figure>

### 2.2 远程桌面访问（RDP）

远程桌面（RDP）访问需要先建立 SSH 加密隧道，再通过 RDP 客户端连接。

**第一步 — 创建 SSH 隧道**

```bash
# 使用 SSH 建立加密隧道：
ssh -i aethir-claw -L <localport>:localhost:3389 abc@<public-ip> -p <port>
```

| 参数                       | 说明                         |
| ------------------------ | -------------------------- |
| `-i aethir-claw`         | 如私钥文件名不同，请相应替换             |
| `<localport>`            | 选择任意可用本地端口，例如 `13390`      |
| `localhost:3389`         | **请勿修改** — 这是云服务器上的 RDP 端口 |
| `<public-ip>` 和 `<port>` | 在云服务器实例的 **Network** 标签下查找 |
| `abc`                    | 用户名固定为 `abc`，无需修改          |

**第二步 — 通过 RDP 客户端连接**

隧道建立后，打开 RDP 客户端，连接 `localhost:<localport>`（例如 `localhost:13390`）。

| 操作系统        | RDP 客户端                                            |
| ----------- | -------------------------------------------------- |
| **Linux**   | Remmina                                            |
| **macOS**   | Microsoft Remote Desktop（从 App Store 下载）           |
| **Windows** | Microsoft Remote Desktop — 按 `Win+R` 输入 `mstsc` 启动 |

### 2.3 OpenClaw 向导——安装与配置

通过 SSH 连接后，运行 OpenClaw 初始化向导：

```bash
# openclaw 初始化大约需要 30 秒
openclaw onboard
```

{% hint style="info" %}
**ℹ 注意** — 使用方向键在选项间导航，空格键选择/取消，**Enter** 键确认并进入下一步。
{% endhint %}

<figure><img src="/files/ZYWCxXzLs8yostsb0kR9" alt=""><figcaption></figcaption></figure>

**按照下表选择推荐配置：**

| 配置项                                                           | 推荐设置                        |
| ------------------------------------------------------------- | --------------------------- |
| I understand this is powerful and inherently risky. Continue? | 选择 **"Yes"**                |
| Onboarding mode                                               | 选择 **"QuickStart"**         |
| Model/Auth Provider                                           | 选择 **"Skip for now"**——稍后配置 |
| Filter models by provider                                     | 选择 **"All providers"**      |
| Default model                                                 | 使用默认配置                      |
| Select channel (QuickStart)                                   | 选择 **"Skip for now"**——稍后配置 |
| Search provider                                               | 选择 **"Skip for now"**——稍后配置 |
| Configure skills now? (recommended)                           | 选择 **"No"**——稍后配置           |
| Enable hooks?                                                 | 选择 **"Skip for now"**       |

{% hint style="success" %}
**✔ 提示** — 完成后会显示 **"Onboarding complete..."**，基础配置结束。接下来可继续配置模型和频道。
{% endhint %}

<figure><img src="/files/eimI60C5u6RW4FzELHsA" alt=""><figcaption></figcaption></figure>

### 2.4 配置模型

需要用到 1.3 节中获取的 API Key。运行配置向导，选择对应的模型服务商。

模型配置可多次执行，支持配置多个模型以实现路由/切换。

```bash
# 在 SSH 命令行窗口中运行配置向导：
openclaw configure
```

**按照下表操作（以 OpenRouter 为例）：**

| 配置项                                      | 推荐设置                                                   |
| ---------------------------------------- | ------------------------------------------------------ |
| Where will the Gateway run?              | 选择：**Local (this machine ... ws\://127.0.0.1:18789)**  |
| Select sections to configure             | 选择：**Model**                                           |
| Model/auth provider                      | 选择与 1.3 节 API Key 对应的服务商，例如 **OpenRouter**             |
| How do you want to provide this API key? | 选择：**Paste API key now**                               |
| Enter API key                            | 粘贴已获取的 API Key                                         |
| Models in /model picker (multi-select)   | 选择所需模型，建议使用默认配置                                        |
| Confirmation message                     | `...Updated ~/.openclaw/openclaw.json` — API Key 已保存 ✓ |
| Select sections to configure (follow-up) | 选择 **"Channels"** 继续，或选择 **"Continue"** 退出             |

### 2.5 配置频道（Channels）

频道将 OpenClaw 与消息平台（Telegram、WhatsApp 等）连接。按需配置各个频道。

```bash
# 在 SSH 命令行窗口中运行配置向导：
openclaw configure
```

| 配置项              | 推荐设置                                          |
| ---------------- | --------------------------------------------- |
| Channels         | 选择 **"Configure/link (Add/update channels)"** |
| Select a channel | 选择目标平台，例如 **Telegram (Bot API)**——推荐新手首选      |

**支持的频道：**

|                     |                        |                      |
| ------------------- | ---------------------- | -------------------- |
| Telegram (Bot API)  | WhatsApp (QR link)     | Discord (Bot API)    |
| IRC (Server + Nick) | Google Chat (Chat API) | Slack (Socket Mode)  |
| Signal (signal-cli) | iMessage (imsg)        | LINE (Messaging API) |
| 飞书 / Lark           | Nostr (NIP-04 DMs)     | Microsoft Teams      |
| Mattermost (plugin) | Nextcloud Talk         | Matrix (plugin)      |
| BlueBubbles (macOS) | Zalo (Bot API)         | Zalo (Personal)      |
| Synology Chat       | Tlon (Urbit)           |                      |

**每次配置频道后，重启网关：**

```bash
# 检查 openclaw-gateway 是否正在运行：
ps -ef | grep openclaw-gateway

# 如果找到进程（例如 PID 370），先停止它：
kill -9 370

# 以 nohup 模式启动网关（终端关闭后继续运行）：
nohup openclaw gateway > nohup.out 2>&1 &
```

#### 2.5.1 Telegram 频道配置

{% stepper %}
{% step %}

#### 打开 Telegram，搜索 BotFather

打开 Telegram，搜索 **BotFather**——官方机器人管理账号。
{% endstep %}

{% step %}

#### 发送 `/newbot`

发送 `/newbot`，为机器人起名，并选择以 `"bot"` 结尾的唯一用户名。
{% endstep %}

{% step %}

#### 复制 Token

BotFather 会返回一个 Token，复制 `"HTTP API:"` 后面的部分。示例：

```
xxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxx（token）
```

{% endstep %}

{% step %}

#### 在 SSH 窗口中粘贴 Token

在 SSH 窗口中运行配置向导，选择：**Local → Channels → Telegram**，然后粘贴 Token：

```bash
openclaw configure
```

{% endstep %}

{% step %}

#### 发送 `/start`

返回 Telegram，打开你的机器人聊天窗口，发送 `/start`，你将收到一串配对码：

```
OpenClaw: access not configured.
Your Telegram user id: 7580661075
Pairing code: 386VF25L
Ask the bot owner to approve with: openclaw pairing approve telegram 386VF25L
```

{% endstep %}

{% step %}

#### 审批配对

在 SSH 窗口中执行配对审批：

```bash
openclaw pairing approve telegram <PAIRING-CODE>
```

{% endstep %}

{% step %}

#### 测试消息

Agent 现已在 Telegram 上线。返回 Telegram，找到你的机器人，发送消息测试。
{% endstep %}
{% endstepper %}

#### 2.5.2 WhatsApp 频道配置

{% stepper %}
{% step %}

#### 运行配置向导

在 SSH 窗口中运行：

```bash
openclaw configure
```

{% endstep %}

{% step %}

#### 选择 Gateway 运行位置

提示 **"Where will Gateway run?"** 时，选择：**Local (this machine ... ws\://127.0.0.1:18789)**
{% endstep %}

{% step %}

#### 生成 QR code

在 **"Select sections to configure"** 中，选择：**Channels → WhatsApp → Generate a QR code**。
{% endstep %}

{% step %}

#### 扫描二维码

在手机上打开 WhatsApp → 点击右上角三个点 **(⋮)** → **Linked devices** → 扫描二维码。
{% endstep %}

{% step %}

#### 确认手机号

确认你的 WhatsApp 手机号：**三个点 → Settings → User profile → Phone**。
{% endstep %}

{% step %}

#### 完成授权

在终端输入手机号，完成 WhatsApp 授权：

```bash
openclaw channels login --channel whatsapp
```

{% hint style="success" %}
**✔ 提示** — 打开 WhatsApp 给自己发一条消息测试，Agent 会回复——例如：*"以下是本周 AI 领域的十大新闻摘要。"*
{% endhint %}
{% endstep %}
{% endstepper %}

#### 2.5.3 飞书频道配置

完整的飞书配置文档请参考：<https://docs.openclaw.ai/zh-CN/channels/feishu>

### 2.6 OpenClaw 控制台（可选）

启动控制面板，测试对话并查看 Agent、Skills、节点等信息。

```bash
openclaw dashboard
```

复制显示的 Dashboard URL，在本地浏览器中打开。

### 2.7 启用内置 Skills ⚡ 重要

云服务器预装了常用 Skills，执行以下命令一键全部启用：

```bash
sh /preclaw/pre_skills.sh
```

{% hint style="warning" %}
**⚠ 重要** — 请在完成初始配置后执行此步骤，一条命令激活所有预装 Skills。
{% endhint %}

**将激活以下 14 个内置 Skills：**

| #  | Skill               | #  | Skill                  |
| -- | ------------------- | -- | ---------------------- |
| 1  | skill-vetter        | 2  | Agent Browser          |
| 3  | Tavily Web Search   | 4  | find-skills            |
| 5  | weather             | 6  | self-improving-agent   |
| 7  | summarize           | 8  | Proactive Agent        |
| 9  | gog                 | 10 | Clawsec                |
| 11 | Multi Search Engine | 12 | ontology               |
| 13 | GitHub              | 14 | office-automation-test |

执行完成后，已激活的 Skills 将显示在 OpenClaw 控制台的 **Skills** 页面。

### 2.8 配置 Chrome 浏览器

配置 Chrome，使 OpenClaw 能够通过浏览器进程访问网络资源。

```bash
# 配置命令：
openclaw config set browser.defaultProfile "openclaw"
openclaw config set browser.headless true
openclaw config set browser.noSandbox true
openclaw config set browser.executablePath "/usr/bin/chromium"

# 验证：
openclaw gateway        # 启动网关
openclaw browser start  # 启动浏览器
openclaw browser open https://google.com  # 打开 Google 网址
```

### 2.9 OpenClaw 命令速查表

**核心/配置**

| 命令                    | 说明      |
| --------------------- | ------- |
| `openclaw tui`        | 启动终端界面  |
| `openclaw dashboard`  | 打开控制面板  |
| `openclaw onboard`    | 初始全局配置  |
| `openclaw setup`      | 初始化配置文件 |
| `openclaw configure`  | 交互式配置   |
| `openclaw config get` | 查看当前配置  |
| `openclaw config set` | 设置配置项   |

**频道（Channels）**

| 命令                           | 说明                        |
| ---------------------------- | ------------------------- |
| `openclaw channels add`      | 添加频道                      |
| `openclaw channels login`    | 登录频道（WhatsApp、Telegram 等） |
| `openclaw channels list`     | 列出已连接频道                   |
| `openclaw channels logout`   | 退出频道                      |
| `openclaw message send`      | 发送消息                      |
| `openclaw message broadcast` | 广播消息                      |
| `openclaw status`            | 查看状态（频道健康状态、近期会话）         |

**网关（Gateway）**

| 命令                                          | 说明            |
| ------------------------------------------- | ------------- |
| `openclaw gateway status`                   | 网关状态          |
| `openclaw gateway status --deep`            | 详细网关状态        |
| `openclaw gateway status --json`            | JSON 格式网关状态   |
| `openclaw gateway install`                  | 安装网关          |
| `nohup openclaw gateway > nohup.out 2>&1 &` | 后台启动网关（nohup） |
| `openclaw gateway stop`                     | 停止网关          |
| `openclaw health`                           | 查看网关健康状态      |

**Skills 与插件**

| 命令                                | 说明                  |
| --------------------------------- | ------------------- |
| `openclaw skills`                 | Skills 管理（安装、更新、删除） |
| `openclaw skills install <skill>` | 安装 Skill            |
| `openclaw skills list`            | 列出已安装 Skills        |
| `openclaw plugins`                | 插件管理                |

**Agent 与会话**

| 命令                   | 说明         |
| -------------------- | ---------- |
| `openclaw sessions`  | 列出会话历史     |
| `openclaw memory`    | 搜索记忆内容     |
| `openclaw agents`    | 管理独立 Agent |
| `openclaw cron`      | 定时任务管理     |
| `openclaw cron list` | 查看定时任务     |
| `openclaw cron add`  | 添加定时任务     |

**浏览器**

| 命令                        | 说明           |
| ------------------------- | ------------ |
| `openclaw browser`        | 控制浏览器（自动化）   |
| `openclaw browser status` | 浏览器状态        |
| `openclaw browser start`  | 启动 AI 专用浏览器  |
| `openclaw nodes`          | 管理已连接节点（手机等） |
| `openclaw node`           | 单节点控制        |

**诊断与维护**

| 命令                       | 说明           |
| ------------------------ | ------------ |
| `openclaw doctor`        | 诊断问题并自动修复    |
| `openclaw doctor --fix`  | 自动修复问题       |
| `openclaw logs`          | 查看日志         |
| `openclaw logs --follow` | 实时日志跟踪       |
| `openclaw update`        | 更新 CLI       |
| `openclaw reset`         | 重置配置（保留 CLI） |
| `openclaw uninstall`     | 完全卸载         |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aethir.com/aethir-claw-cn/aethir-claw-xiang-xi-bu-shu-zhi-nan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.