OpenClaw

OpenClaw 是由 Peter Steinberger（PSPDFKit 创始人）开发的开源个人 AI 助手项目。与传统网页版 ChatGPT 或 Claude 不同，OpenClaw 直接运行在你常用的聊天软件里——你在 WhatsApp 发消息，它在 WhatsApp 回复；你在 Discord 提问，它在 Discord 解答。还支持对接飞书、QQ、钉钉等国内平台。

关键理解：OpenClaw 不是一个 AI 模型，而是一个「AI 网关」——它负责连接你的聊天软件和 AI 大模型 API，让 AI 能力无缝融入日常沟通工具。

特性	OpenClaw	传统 AI 聊天
使用方式	在常用聊天软件内使用	需要打开专门网页
对话记忆	跨平台持久记忆	每次对话独立
主动推送	支持定时提醒和主动通知	只能被动响应
数据存储	本地 Markdown 文件	存储在云端
定制能力	完全可编程 Skills 系统	有限的自定义选项

OpenClaw 官方文档

---

安装 OpenClaw

Linux / macOS：

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

Windows PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

替代方式（npm 全局安装）：

npm install -g openclaw@latest

验证安装：

openclaw --version

---

配置 AI Gateway API

启动配置向导：

openclaw onboard

向导会引导你完成：AI 模型配置、工作目录设置、渠道启用（TG / 飞书 / 钉钉 / 企业微信等）、守护进程安装。

选择 Quick Start，然后选择 Custom Provider，填写以下信息：

字段	值
Base URL	https://aigateway.link/v1
API Key	sk-你的令牌
Compatibility Mode	GPT / DS / Gemini 等选 OpenAI-compatible；Claude 系列选 Anthropic-compatible
Model	如 claude-sonnet-latest、deepseek-latest、gpt-latest

配置完成后，openclaw 会自动启动 gateway。如果未自动启动，手动执行：

openclaw gateway

高级：手动添加自定义模型（JSON 配置）

Claude 模型（Anthropic 协议）：

{
  "provider": "aigateway",
  "base_url": "https://aigateway.link/v1",
  "api": "anthropic-messages",
  "api_key": "sk-你的令牌",
  "model": {
    "id": "claude-sonnet-latest",
    "name": "claude-sonnet-latest"
  }
}

GPT / DeepSeek / Gemini（OpenAI 协议）：

{
  "provider": "aigateway",
  "base_url": "https://aigateway.link/v1",
  "api": "openai-completions",
  "api_key": "sk-你的令牌",
  "model": {
    "id": "claude-sonnet-latest",
    "name": "claude-sonnet-latest"
  }
}

---

对接 Telegram

配置向导中选择 Telegram 通道后，需要输入 TG 机器人的 token 密钥。

获取 TG Bot Token：

1. 打开 Telegram，搜索并进入 @BotFather
2. 点击 Start，创建一个新机器人（/newbot）
3. 根据提示设置机器人名称和用户名
4. 创建成功后，BotFather 会发送一个 bot token，复制粘贴到 openclaw 即可

---

对接飞书

飞书接入有两种方式：

方式	优点	适用场景
官方插件（推荐）	一键安装、权限完整、持续维护	新用户首选，功能最全
手动创建应用	权限可精细控制	有特殊权限需求时

⚠️ 安全提示：此插件通过飞书接口连接了你的工作数据——消息、文档、日历、联系人。建议先用个人账号测试，AI 代发的飞书消息以你的名义发出，发出后即成事实，涉及重要操作务必「先预览，再确认」。

方式一：飞书官方插件（推荐）

第一步：确认 OpenClaw 版本

openclaw --version
# Linux/macOS 需 ≥ 2026.2.26；Windows 需 ≥ 2026.3.2
# 版本不够则升级：
npm install -g openclaw

第二步：安装飞书插件

npx -y @larksuite/openclaw-lark install

安装过程中可选择「新建机器人」（扫码一键创建）或「关联已有机器人」（输入 App ID 和 App Secret）。

第三步：完成用户授权

在飞书对话框中发送：

/feishu auth

第四步：验证安装

/feishu start

返回版本号即代表安装成功。让 OpenClaw 学习新能力：

学习一下我安装的新飞书插件，列出有哪些能力。

更新飞书插件：

npx -y @larksuite/openclaw-lark@latest install

方式二：手动创建飞书应用

1. 登录飞书开放平台，点击「创建企业自建应用」
2. 填写应用名称（如「AI 助手」），添加「机器人」能力，复制 App ID 和 App Secret
3. 进入「事件与回调」，将事件配置和回调设置的订阅方式均设为长连接，添加「接收消息」事件
4. 进入「权限管理」，通过「批量导入/导出权限」导入所需权限
5. 创建新版本并发布，在飞书客户端配对机器人

---

飞书高级配置

开启流式输出（推荐）：

openclaw config set channels.feishu.streaming true

开启多任务并行（话题独立上下文）：

openclaw config set channels.feishu.threadSession true

群组回复模式：

# 仅响应 @ 机器人的消息（推荐）
openclaw config set channels.feishu.requireMention true --json

# 不用 @，所有消息都回复（大群慎用）
openclaw config set channels.feishu.requireMention false --json

---

常见问题诊断

在飞书对话中发送以下指令自检：

指令	说明
/feishu start	确认是否安装成功，返回版本号
/feishu doctor	检查配置是否正常
/feishu auth	批量完成用户授权

终端诊断工具：

npx @larksuite/openclaw-lark doctor        # 检查问题
npx @larksuite/openclaw-lark doctor --fix  # 尝试自动修复
npx @larksuite/openclaw-lark info          # 查看版本和配置

---

实用资源

资源	链接
OpenClaw 官方文档	docs.openclaw.ai
Skills 广场（500+ 扩展技能）	clawhub.ai