一、说明

1.1 官方文档

适用于任何操作系统的 AI 智能体 Gateway 网关，支持 WhatsApp、Telegram、Discord、iMessage 等。

发送消息，随时随地获取智能体响应。通过插件可添加 Mattermost 等更多渠道。

1.2架构说明

**多渠道接入 (Channels)**：支持 WhatsApp、Telegram、Discord 等，将复杂的指令交互转化为日常的即时通讯。
**中枢控制 (Gateway)**：作为系统的大脑，负责状态管理、模型路由及 MCP 协议分发。
**技能扩展 (Skills)**：原生支持 MCP（Model Context Protocol），可无缝对接文件系统、浏览器、Shell 等上百种工具。
**持久化记忆 (Memory)**：交互历史与知识库均以 Markdown 或向量库形式存储于本地，实现“越用越懂你”的个性化进化。

1.3 openClaw任务处理流程

意图解析：LLM 分析指令，判断是否需要调用外部工具。
工具调度：Gateway 通过 MCP 协议激活对应的本地 Skill。
反馈与记忆：执行结果反馈给 LLM，并同步更新本地记忆库，完成任务闭环。

二、本地部署

网上的部署方案很多，主要有两个，一个是本地部署，另一个是云服务部署。本地部署可以直接部署也可以进行docker部署。这里介绍本地的直接部署：

2.1 前置依赖

openclaw依赖Nodejs 22+版本以上，所以先升级Nodejs

Mac 用户（推荐用 Homebrew）：

# 如果没装过 Homebrew，先安装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node

Windows用户

去 Node.js 官网下载安装包：https://nodejs.org/zh-cn/download

安装时注意勾选 **”Add Node.js to PATH”**。

Linux用户

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# CentOS/RHEL
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo yum install -y nodejs

2.2 安装步骤

1. 安装openclaw

macos/linux

1	curl -fsSL https://openclaw.ai/install.sh \| bash

windows

# 安装openclaw
npm install -g openclaw

# 查看版本
openclaw -v

2. 配置向导

1	openclaw onboard --install-daemon

--install-daemon 参数的作用：

认证配置：用 GitHub 账号登录验证身份
网关设置：配置 Gateway 服务，包括 AI 模型选择和 API Key
安装守护进程：把 OpenClaw Gateway 注册为系统服务，开机自启

详情如下：

模型认证方式-skip

模型选择先跳过

配置消息发送渠道，这里跳过:

配置skill这里先不配置

hooks都选。

下来就部署好了:

访问：

http://127.0.0.1:18789/ 既可看到
控制台命令 openclaw tui

如果有提示需要设备配对，执行一下命令行：

设备配对

1
2
3

openclaw devices list

openclaw devices approve {requestId}

三、使用前置

3.1、配置模型

给openclaw装上大脑。Openclaw通过配置可以选取不同的模型。

Openclaw非常耗token，轻度使用2天2.8m token.采用硅基流动，实名认证后免费领16元token 薅个羊毛。硅基流动（siliconflow）是模型提供商，提供几十种模型选择。

https://cloud.siliconflow.cn/i/dvezuUDJ

一定要邀请码：dvezuUDJ

注册并填入验证码

实名认证：

认证完成后在余额充值里会看到：

得到apikey后修改模型：

可以通过向导配置模型，也可以通过配置文件进行配置。这里通过配置文件 ~/.openclaw/openclaw.json：

在 models -> providers 节点下添加 siliconflow 服务商，把“siliconflow”部分粘贴进去

hljs

"models": {
  "providers": {
    "siliconflow": {
      "baseUrl": "https://api.siliconflow.cn/v1",
      "apiKey": "sk-你的硅基流动API密钥",
      "api": "openai-completions",
      "models": [
        {
          "id": "Pro/zai-org/GLM-4.7",
          "name": "Silicon GLM 4.7",
          "contextWindow": 128000,
          "maxTokens": 8192
        },
        {
          "id": "deepseek-ai/DeepSeek-V3",
          "name": "DeepSeek V3",
          "contextWindow": 64000,
          "maxTokens": 4096
        }
      ]
    }
  }
}

在 agents -> defaults 中声明模型的使用路径，并可设置别名。修改model、models

hljs

"agents": {
  "defaults": {
    "model": {
      "primary": "siliconflow/Pro/zai-org/GLM-4.7" 
    },
    "models": {
      "siliconflow/Pro/zai-org/GLM-4.7": {
        "alias": "glm"
      },
      "siliconflow/deepseek-ai/DeepSeek-V3": {
        "alias": "deepseek"
      }
    }
  }
}

这里配置了GLM 4.7、DeepSeek-V3

（注：”primary”的值需要添加前缀 siliconflow/（如上图配置的providers名字），xxx为从硅基流动上粘贴下来的模型id）

操作目的	对应指令
强制重启服务	openclaw gateway stopschtasks /Run /TN “openclaw Gateway”
测试模型连接	openclaw agent –agent main –message “你好”
修复环境配置	openclaw doctor –fix
查看实时日志	openclaw logs –follow

3.2、skill相关

1、skills安装

skill安装可以通过向导进行配置，也可以通过命令安装。

Skills 的加载有优先级机制，高优先级会覆盖低优先级的同名 Skill：

Skills 通过 ClawHub（OpenClaw 的公共技能注册表）来管理。安装命令是 clawhub：


# 安装一个技能（会装到 ./skills 或 ~/.openclaw/skills 目录下）
clawhub install <skill-slug>

# 更新所有已安装的技能
clawhub update --all

# 扫描并同步技能
clawhub sync --all

推荐Skills清单

生产力类

Skill	功能	适用场景
daily-report	自动生成日报	每天写日报的打工人
meeting-notes	会议纪要整理	会议记录员
email-digest	邮件摘要	邮件太多的用户

2、自建skill

步骤 1：创建目录

# 进入你的 OpenClaw 工作区
cd ~/.openclaw/workspace
# 创建技能目录
mkdir -p skills/weather-reporter
# 进入技能目录
cd skills/weather-reporter

步骤 2：编写 SKILL.md

创建 SKILL.md 文件：

---
name: weather-reporter
description: 智能天气播报员，用生动的语言播报天气状况
---

# 天气播报员 Skill

当用户询问天气时，按以下流程播报：

## 播报流程

1. **获取天气数据**
   - 调用天气 API 获取当前天气
   - 记录：温度、湿度、风速、天气状况

2. **生成播报文案**
   - 用生动、拟人化的语言
   - 加入场景感（如"阳光正好，适合出门散步"）
   - 根据天气给出建议（穿衣、带伞等）

3. **格式化输出**
   - 使用 emoji 增强可读性
   - 结构清晰：今日天气 → 出行建议 → 温馨提示

## 示例输出

> 🌤️ 今日天气播报
>
> 天气：晴朗，微风拂面
> 温度：22°C，体感舒适
> 湿度：65%，空气清新
>
> 🚶 出行建议：
> - 阳光正好，适合户外活动
> - 轻薄外套即可，注意防晒
> - 风力较小，骑行很惬意
>
> 💡 温馨提示：今天是晒被子/洗车的好日子哦~ ☀️

## 注意事项

- 避免使用专业术语，用生活化语言
- 每条播报控制在 200 字以内
- 保持温暖、亲切的语气

步骤 3：刷新技能列表

在 OpenClaw 对话中输入：

刷新技能列表

或重启 Gateway：

1	openclaw gateway restart

步骤 4：测试你的 Skill

现在，你可以测试这个 skill 了：

用户：

查一下福州今天的天气

AI（使用 weather-reporter skill）：

🌤️ 福州今日天气 (2026 年 2 月 27 日)

当前状况 (15:45)

🌡️ 温度: 20.1°C

💧 湿度: 82%

💨 风速: 9.9 km/h

☁️ 天气: 多云

今日预报

📈 最高温: 21.2°C

📉 最低温: 14.5°C

🌧️ 天气: 有雨 (天气代码 63 表示降雨)

温馨提示: 今天福州有雨，出门记得带伞！气温适中，但湿度较高，体感可能会有些闷热。

3.3、飞书对接

步骤1.打开飞书开发者后台

创建企业应用，输入应用名称

这里新增了应用。

步骤2.添加应用能力

步骤3.编辑机器人名称

步骤4.权限配置

步骤5.导入以下json数据

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "contact:contact.base:readonly",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}