OpenClaw 是一个开源的个人 AI Agent(智能体)框架。它不是单纯的 AI 聊天网页,而是可以运行在自己的电脑、服务器等设备上,并通过一个 Gateway(网关)统一连接大模型、工具、消息平台、浏览器以及其他设备,让 AI 真正能够“执行任务”,而不仅仅是回答问题。
截至 2026 年 8 月 22 日,OpenClaw 官方稳定版本为 2026.7.1-2;同时还有 beta 测试版本。本文以当前官方文档和稳定版本的使用方式为基础,介绍从零安装 OpenClaw,到接入模型、使用 Telegram、配置 Skills、执行命令、自动化任务以及远程部署的完整流程。
官方地址
官网:https://openclaw.ai/
官方文档:https://docs.openclaw.ai/
GitHub:https://github.com/openclaw/openclaw
一、OpenClaw 到底是什么?¶
可以把 OpenClaw 理解为一个运行在你自己的电脑或服务器上的 个人 AI Agent 中枢。
普通 AI 聊天工具主要解决的是:
用户提问 → AI 思考 → AI 回复
而 OpenClaw 更接近:
用户发任务 → Gateway 接收 → AI 调用模型 → AI 判断需要使用哪些工具 → 执行任务 → 返回结果
例如你可以让它:
- 阅读和修改本地文件
- 执行 Shell / PowerShell 命令
- 浏览网页
- 搜索互联网
- 操作浏览器
- 编写和修改代码
- 定时执行任务
- 监听 Webhook
- 通过 Telegram、Discord、WhatsApp 等聊天软件接收任务
- 调用其他设备上的能力
- 使用 Skills 扩展新的工作流程
- 根据不同 Agent 设置不同工作空间和权限
官方对 OpenClaw 的定位就是个人 AI 助手:模型、工具、消息渠道和设备通过一个 Gateway 统一连接。
因此,OpenClaw 最适合的不是“偶尔问几个问题”,而是希望拥有一个 长期在线、可以执行实际任务的个人 AI 助手 的用户。
二、OpenClaw 的核心架构¶
理解 Gateway,是理解 OpenClaw 的关键。
整个系统可以简单理解为:
┌──────────────────┐
│ AI 模型 │
│ OpenAI / Claude │
│ Gemini / Qwen ... │
└────────┬─────────┘
│
▼
┌────────────┐ ┌──────────────────┐ ┌───────────────┐
│ Telegram │─────▶│ │─────▶│ 本地文件 │
│ Discord │ │ Gateway │ │ Shell / Exec │
│ WhatsApp │─────▶│ │─────▶│ Browser │
│ 飞书 │ │ OpenClaw Agent │ │ Web Search │
│ Slack │─────▶│ │─────▶│ 其他工具 │
│ WebChat │ └────────┬─────────┘ └───────────────┘
└────────────┘ │
▼
┌──────────────────┐
│ 手机 / 电脑 / Node │
└──────────────────┘
官方架构中,Gateway 是整个系统的控制中心。它负责会话、认证配置、消息渠道和状态;其他客户端和设备则连接到 Gateway。默认情况下 Gateway 监听本机 127.0.0.1:18789。
这也带来一个重要特点:
模型不等于 OpenClaw。
OpenClaw 本身不是大模型,它负责把模型、工具、渠道和设备组织起来。你可以根据自己的情况选择 OpenAI、Anthropic、Google、OpenRouter、Qwen、Kimi、Ollama 等模型或模型服务。
三、OpenClaw 有哪些主要能力?¶
1. 多模型¶
OpenClaw 支持大量模型提供商,包括:
- OpenAI
- Anthropic
- OpenRouter
- Alibaba Model Studio
- Qwen
- Moonshot AI
- MiniMax
- Mistral
- xAI
- DeepSeek
- Ollama
- vLLM
- LM Studio
- NVIDIA
- Together AI
- Groq
- Hugging Face
- Cloudflare AI Gateway
官方模型目录目前已经覆盖非常多的提供商,并且可以使用 provider/model 的形式选择具体模型。
例如:
{
agents: {
defaults: {
model: {
primary: "anthropic/claude-opus-4-6"
}
}
}
}
不同模型的能力、价格、上下文窗口和工具调用能力都会不同。
对于真正需要执行任务的 Agent,官方建议优先选择当前提供商较新的旗舰模型,因为 Agent 会涉及工具调用、代码执行以及对复杂上下文的理解。
2. 多聊天平台¶
OpenClaw 的一个重要优势,就是可以把 AI 助手放到你原本使用的聊天软件里。
目前官方文档列出的渠道包括:
Telegram、Discord、WhatsApp、Slack、Microsoft Teams、Signal、Google Chat、iMessage、Matrix、LINE、Mattermost、Nextcloud Talk、Nostr、Twitch、Zalo、QQ、飞书、WebChat 等。
此外还有 WeChat、企业微信、元宝等渠道相关插件。需要注意,它们的维护方式并不完全一样,有些是 OpenClaw 核心或官方插件,有些则属于外部插件。
例如最容易上手的通常是 Telegram,因为只需要创建 Bot 并配置 Token,官方也把 Telegram 列为最快的渠道之一。
四、安装 OpenClaw¶
1. 系统要求¶
当前官方要求:
- Node.js 22.22.3 及以上
- Node.js 24.15 及以上
- Node.js 25.9 及以上
- Node.js 26 为当前推荐版本
Node 23 不受支持。官方安装脚本在系统没有合适的 Node.js 时,可以自动安装需要的运行环境。
支持:
- Windows
- macOS
- Linux
- WSL2
Windows 目前除了 PowerShell CLI 安装方式,还提供原生 Windows Hub 应用;Windows Hub 可以提供安装、托盘状态、聊天、Node 模式和本地 MCP 等功能。
五、Windows 安装方法¶
如果你使用 Windows,最简单的方法之一是直接打开 PowerShell:
iwr -useb https://openclaw.ai/install.ps1 | iex
官方安装脚本会检测系统环境、安装需要的 Node.js,并启动 OpenClaw 的引导流程。
安装完成后,可以检查:
openclaw --version
再检查 Gateway:
openclaw gateway status
六、macOS / Linux / WSL2 安装¶
在终端执行:
curl -fsSL https://openclaw.ai/install.sh | bash
安装完成后,通常会自动进入 onboarding(新手引导)。
也可以手动执行:
openclaw onboard --install-daemon
这会完成初始化,并安装 Gateway 服务,使 OpenClaw 可以作为后台服务持续运行。
七、通过 npm 安装¶
如果你已经自行安装好了 Node.js,也可以直接使用 npm。
当前官方安装方式为:
npm install -g openclaw@latest --allow-scripts=openclaw
对于 npm 11.15 或更早版本,可以省略 --allow-scripts=openclaw。
安装后:
openclaw onboard --install-daemon
然后:
openclaw gateway status
最后打开控制面板:
openclaw dashboard
默认本地地址为:
http://127.0.0.1:18789/
八、第一次启动:Onboarding 新手引导¶
第一次安装后,最重要的命令就是:
openclaw onboard
当前新版 onboarding 已经不只是简单让你填写 API Key,而是会尝试检测:
- 已配置的模型
- 环境变量中的 API Key
- 已支持的本地 AI CLI
- Gateway 主机上可访问的 Ollama / LM Studio
- 部分已有的 AI Agent 环境
随后会测试候选模型的实际推理能力,成功后才保存对应模型和凭据。
如果检测不到已有配置,则会进入模型提供商选择流程,可以选择 OpenAI、Anthropic、xAI、Google、OpenRouter 等,再继续配置。
因此,新用户通常不需要一开始就手动修改 JSON 配置文件。
九、第一次启动后应该检查什么?¶
安装完成后,建议依次运行:
openclaw gateway status
查看 Gateway 状态。
然后:
openclaw dashboard
打开 Web 控制面板。
如果需要更深入检查:
openclaw doctor
CLI 官方文档将 doctor、gateway status、dashboard 等作为常用的安装和故障排查入口。
十、OpenClaw 的配置文件在哪里?¶
默认配置文件:
~/.openclaw/openclaw.json
默认工作空间:
~/.openclaw/workspace/
工作空间通常会保存 Agent 使用的文件、说明文件和 Skills。
例如:
~/.openclaw/
├── openclaw.json
├── credentials/
├── workspace/
│ ├── AGENTS.md
│ ├── SOUL.md
│ ├── TOOLS.md
│ └── skills/
└── ...
官方文档说明,Workspace 是 Agent 的主要工作区域,而 AGENTS.md、SOUL.md、TOOLS.md 等文件可以参与 Agent 的持续上下文和行为定义。
十一、如何选择和切换模型?¶
OpenClaw 使用:
provider/model
这样的格式标识模型。
例如:
openai/gpt-5.6
或者:
anthropic/claude-opus-4-6
具体模型是否可用取决于当前账户、提供商以及配置。
可以使用:
openclaw models
查看模型相关信息。
也可以通过 onboarding 重新配置:
openclaw onboard
对于 OpenAI,当前文档已经支持 GPT-5.6,并区分 API Key 和 ChatGPT/Codex 订阅认证路径。
十二、OpenClaw 可以使用本地模型吗?¶
可以。
官方模型目录包含:
- Ollama
- LM Studio
- vLLM
- SGLang
- 以及其他本地或自托管模型路线
例如,如果你的服务器已经运行 Ollama,就可以让 OpenClaw 使用本地模型,而不是全部请求外部 API。
但这里有一个非常重要的问题:
“能运行模型”和“适合作为 Agent 模型”不是一回事。
Agent 不仅要回答问题,还需要:
- 理解工具描述
- 正确调用工具
- 处理工具返回值
- 编写代码
- 操作浏览器
- 根据执行结果继续下一步
所以对于 OpenClaw,不能只看模型参数量,还应该重点关注工具调用、代码能力、上下文能力以及实际稳定性。
十三、给 OpenClaw 配置 Telegram¶
Telegram 是目前比较适合新手测试 OpenClaw 的渠道。
官方文档将 Telegram 列为最快的渠道之一。
基本流程:
第一步:创建 Telegram Bot¶
在 Telegram 中找到:
@BotFather
创建机器人并获得 Bot Token。
第二步:在 OpenClaw 中添加 Telegram¶
可以使用:
openclaw channels add
根据提示选择 Telegram 并填写 Bot Token。
也可以使用配置文件进行更细致的配置。
第三步:重启 Gateway¶
部分插件或渠道安装、启用后需要重新启动 Gateway。
第四步:与机器人聊天¶
启动完成后,你就可以通过 Telegram 给自己的 OpenClaw 发消息。
这样就完成了最直观的 Agent 形态:
手机 Telegram
↓
Telegram Bot
↓
OpenClaw Gateway
↓
AI 模型
↓
工具 / 浏览器 / 文件 / Shell
↓
返回 Telegram
十四、微信能不能使用 OpenClaw?¶
可以使用,但这里很容易因为过时信息而产生误解,最常见的就是误以为“OpenClaw 原生支持微信”。
按照当前官方渠道页面,WeChat 并不是 OpenClaw 核心内置渠道,而是通过外部 openclaw-weixin 插件接入,企业微信同样属于外部插件路线。也就是说,目前微信和企业微信都需要依靠第三方插件才能接入 OpenClaw。
对于希望长期运行的用户,安装第三方插件前最好检查插件来源、版本、代码及权限,因为插件本质上可以扩展 OpenClaw 的运行能力。
十五、OpenClaw 的 Tools 是什么?¶
Tools 可以理解为 Agent 的“手”。
模型本身只负责思考,而 Tool 负责真正执行操作。
官方提供的工具类别包括:
- Shell / Exec
- 文件读写
- Web Search
- Web Fetch
- Browser
- Process
- Message
- Image Generation
- 会话和 Agent 管理
- 设备节点能力
例如:
用户:
帮我检查这个项目最近有没有 Git 提交,并运行测试。
Agent:
1. 进入项目目录
2. 执行 git log
3. 查看最近修改
4. 执行测试命令
5. 分析测试结果
6. 向用户汇报
这就是典型的 Agent 工作方式。官方 Tools 文档也明确指出,工具是 Agent 读取数据、修改文件、运行命令、浏览网页和操作其他系统的执行接口。
十六、Exec:让 OpenClaw 真正执行命令¶
OpenClaw 的 exec 工具可以运行 Shell 命令。
例如:
pwd
ls
git status
Windows 下则可以涉及 PowerShell 等命令。
但是需要特别注意:
Exec 不是普通的只读工具。
官方明确说明,Exec 可以创建、修改、删除文件,其权限范围取决于当前主机、Sandbox 和工具策略。
因此不要为了“方便”直接把所有权限全部打开。
十七、Exec 权限模式¶
OpenClaw 当前提供不同的 Exec 安全模式,例如:
deny
allowlist
ask
auto
full
含义大致可以理解为:
| 模式 | 作用 |
|---|---|
deny | 禁止执行 |
allowlist | 仅允许白名单命令 |
ask | 不在允许范围时询问用户 |
auto | 自动审核后处理,必要时请求用户 |
full | 不设置执行审批门槛 |
官方还支持针对单个会话使用:
/exec
调整当前会话的执行策略。
十八、为什么 OpenClaw 一定要重视安全?¶
因为 OpenClaw 和普通 AI 聊天机器人最大的区别,就是:
它可以真的做事情。
如果 Agent 有:
文件访问
+
Shell
+
浏览器
+
网络
+
消息发送
+
服务器权限
那么一旦权限配置过大,风险会远大于普通聊天 AI。
例如:
用户 → Telegram
↓
恶意输入 / Prompt Injection
↓
AI
↓
exec
↓
删除文件 / 读取密钥 / 执行恶意命令
所以 OpenClaw 官方安全模型非常强调:
不应该假设模型永远不会被操纵,而应该让模型即使被操纵,影响范围也受到限制。
官方建议通过 Gateway 认证、DM 配对、Allowlist、Tool Policy、Sandbox 和 Exec 审批等措施降低风险。
十九、DM Pairing:避免陌生人直接控制你的 Agent¶
OpenClaw 当前支持多种 DM 访问策略:
pairing
allowlist
open
disabled
其中默认的 pairing 最适合普通个人用户。
当陌生用户第一次向 Bot 发私信时:
- OpenClaw 不会直接处理请求
- 会生成配对码
- 你确认后才能允许这个用户继续使用
官方文档说明,配对码默认有效期为 1 小时。
可以通过:
openclaw pairing list <channel>
查看待处理请求。
然后:
openclaw pairing approve <channel> <code>
批准。
对于私人 Agent,推荐 pairing 或 allowlist,而不是直接使用 open。
二十、Group 群聊应该怎样设置?¶
如果把 OpenClaw 放进 Telegram、Discord 等群组,更要注意权限。
一个很实用的策略是:
只有明确 @机器人时才触发。
官方配置中就支持:
requireMention
例如可以要求:
@openclaw 帮我检查今天的 GitHub Issue
才触发 Agent。
这样可以避免群里所有聊天都被输入到 Agent 上下文中,也能降低误触发风险。
二十一、Sandbox 是什么?¶
Sandbox 可以理解为给 Agent 设置一个“隔离环境”。
例如可以限制:
- Agent 可以访问哪些目录
- 可以使用哪些工具
- 是否可以执行命令
- 是否可以访问宿主机
- 是否可以控制浏览器
对于个人电脑上的简单测试,可以先使用较宽松的配置。
但如果是:
- VPS
- 公司服务器
- 生产环境
- 存有 SSH Key 的机器
- 存有 API Key 的机器
- 多人共用机器
建议认真设计 Sandbox 和工具权限。
官方也明确指出,Exec 审批并不等价于强隔离;如果真的需要抵御不受信任用户,应通过不同 OS 用户、不同主机或独立 Gateway 划分信任边界。
二十二、Browser:让 Agent 操作网页¶
OpenClaw 内置 Browser 能力,可以让 Agent 使用独立浏览器环境。
它可以:
- 打开网页
- 切换标签页
- 点击按钮
- 输入文字
- 获取网页内容
- 截图
- 下载文件
- 执行多步浏览器任务
一个非常重要的设计是:
OpenClaw 默认拥有自己的浏览器环境,而不是直接使用你的日常浏览器 Profile。
这可以降低 Agent 与个人浏览器数据互相影响的风险。官方 Browser 文档明确说明,openclaw Profile 是独立的 Agent 浏览器环境。
因此你可以让它执行:
打开网页 → 登录允许的服务 → 查找数据 → 下载文件 → 总结结果
而不需要把自己的日常浏览器完全交给 Agent。
二十三、Skills 是什么?¶
Skills 可以理解成 OpenClaw 的“技能包”。
它不是简单的插件,而是一组告诉 Agent:
“什么时候做这件事,以及应该怎样做。”
的 Markdown 指令和相关文件。
一个 Skill 通常包含:
SKILL.md
例如:
~/.openclaw/workspace/skills/
└── github/
└── SKILL.md
SKILL.md 中包含技能名称、描述和执行规则。
二十四、如何自己创建一个 Skill?¶
例如创建:
~/.openclaw/workspace/skills/hello-world/
然后创建:
SKILL.md
内容可以是:
---
name: hello-world
description: 一个简单的问候技能
---
# Hello World
当用户要求进行问候时,
使用 exec 执行:
echo "Hello from OpenClaw!"
这样 Agent 就可以根据 Skill 的描述,知道什么时候使用这个能力。
二十五、Skills 和 Plugins 有什么区别?¶
这是很多新用户容易混淆的地方。
可以简单理解为:
Skill:教 Agent 怎么完成某类任务。
Plugin:扩展 OpenClaw 本身的功能。
例如:
Skill
→ “如何整理 GitHub Issue”
Plugin
→ “增加一个新的聊天渠道”
→ “增加一个新的 Tool”
→ “增加 Browser 能力”
官方也说明,Plugin 可以自带 Skills;Skills 则有明确的加载优先级和权限控制机制。
二十六、安装第三方 Skills 要谨慎¶
社区生态是 OpenClaw 很重要的一部分,但也带来一个问题:
Skill 本身可能会要求 Agent 使用工具。
因此不能把所有第三方 Skill 都当作“无害的提示词”。
尤其需要注意:
- 是否来源可信
- SKILL.md 内容
- 是否调用 exec
- 是否读取本地文件
- 是否访问网络
- 是否安装额外依赖
- 是否要求访问 Token / Cookie
对于生产服务器,建议先检查 Skill 的内容,再决定是否安装。
二十七、自动化:让 OpenClaw 自己定时工作¶
OpenClaw 不只是“等你发消息”。
官方提供了 Automation 自动化机制,可以用于:
- 每天定时总结
- 每小时检查任务
- 定时生成日报
- 定时检查 GitHub
- 定时检查服务器
- 定时发送消息
- Webhook 触发任务
例如每天上午 7 点执行一次日报:
openclaw automations create "0 7 * * *" \
--name "Morning brief" \
--tz "America/Los_Angeles" \
--session isolated \
--announce
Automation 由 Gateway 调度,而且任务数据会持久化,因此 Gateway 重启后不会简单丢失已经创建的计划。
二十八、提醒任务¶
例如:
20 分钟后提醒我检查服务器。
可以创建一次性自动化任务。
官方支持:
openclaw automations add \
--name "Server check" \
--at "20m" \
--session main \
--system-event "检查服务器状态" \
--wake now
Automation 同时支持一次性时间、Cron 表达式、Webhook 等多种触发方式。
二十九、Heartbeat 和 Automation 不一样¶
OpenClaw 还有 Heartbeat。
可以简单理解为:
Automation:精确到某个时间点。
例如:
每天 9:00 发送日报。
Heartbeat:周期性检查。
例如:
每隔一段时间看看有没有需要处理的事情。
官方文档建议:
- 精确时间 → Automation
- 需要结合完整上下文进行周期检查 → Heartbeat
三十、Webhook:让外部系统触发 OpenClaw¶
OpenClaw 还支持 Webhook。
例如:
GitHub
↓
Webhook
↓
OpenClaw
↓
Agent
↓
分析 Issue / Commit / CI
↓
Telegram 通知
Webhook 通常应该配置专用 Token。
例如:
{
hooks: {
enabled: true,
token: "replace-with-dedicated-webhook-token",
path: "/hooks"
}
}
官方要求 Webhook 请求进行认证,并建议不要直接暴露没有认证的 Hook。
三十一、远程部署:把 OpenClaw 放到 VPS¶
如果希望 OpenClaw 24 小时在线,一个非常实用的方式是:
VPS / 家用服务器
↓
OpenClaw Gateway
↓
Tailscale / SSH
↓
电脑 / 手机
这样,即使你的笔记本关闭了,Agent 依然可以继续工作。
官方推荐的远程方式主要包括:
- Tailscale
- SSH Tunnel
- 可信 LAN / Tailnet
- 远程 Gateway
Gateway 默认只监听 Loopback,因此不建议为了方便直接把 18789 裸露到公网。
三十二、最简单的 SSH 远程方式¶
假设 OpenClaw 安装在服务器上。
客户端执行:
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
然后浏览器访问:
http://127.0.0.1:18789/
这样实际上访问的是远程服务器上的 OpenClaw Gateway。
官方把 SSH Tunnel 作为通用的远程访问方式。
三十三、为什么推荐 Tailscale?¶
如果你准备长期使用 OpenClaw,Tailscale 是非常实用的方案。
典型架构:
Tailscale
│
┌───────────────┼───────────────┐
│ │ │
手机 笔记本 VPS
│ │ │
└───────────────┴───────┬───────┘
│
OpenClaw Gateway
这样不用把 Gateway 端口直接暴露在公网。
官方远程访问文档也推荐在很多场景下保持:
gateway.bind = "loopback"
再通过 Tailscale Serve 或 SSH 等方式访问。
三十四、手机、电脑和 Node¶
OpenClaw 还可以连接其他设备作为 Node。
例如:
Gateway
│
├── PC
├── iPhone
└── Android
Node 属于外围设备,而不是新的 Gateway。
Gateway 负责:
- 会话
- 模型
- 渠道
- 状态
- Agent
Node 则负责提供设备本地能力。官方架构明确把 Gateway 定位为控制平面,把 Node 定位为远程执行和设备能力的一部分。
三十五、多 Agent 是什么?¶
OpenClaw 并不只能运行一个 Agent。
可以为不同任务建立不同 Agent,例如:
主 Agent
├── 日常助手
编程 Agent
├── 代码
├── Git
└── 测试
写作 Agent
├── 搜索
├── 资料整理
└── Markdown
服务器 Agent
├── 日志
├── Docker
└── 监控
不同 Agent 可以设置不同的工作空间、模型和 Skills,从而减少权限混在一起的情况。
这也是 OpenClaw 和普通“超级聊天机器人”明显不同的地方。
三十六、一个很实用的 OpenClaw 使用方案¶
对于普通个人用户,我比较推荐以下架构:
┌──────────────┐
│ OpenAI / Claude │
└──────┬───────┘
│
▼
手机 Telegram ──────▶ OpenClaw
│
┌────────────┼────────────┐
▼ ▼ ▼
Browser Files Exec
│ │ │
└────────────┼────────────┘
▼
Workspace
然后增加:
Cron / Automation
│
▼
每日任务
如果长期运行,再把 Gateway 放到:
VPS + Tailscale
这样可以获得一个真正意义上的 24 小时个人 AI Agent。
三十七、第一次安装时建议这样做¶
对于第一次体验 OpenClaw,不建议一开始就把所有功能都打开。
推荐按照下面顺序:
第一步¶
安装 OpenClaw:
openclaw.ai
第二步¶
完成:
openclaw onboard
第三步¶
确认:
openclaw gateway status
第四步¶
打开:
openclaw dashboard
第五步¶
先只使用 WebChat 测试。
第六步¶
再接入 Telegram。
第七步¶
确认聊天正常后,再逐步打开:
Browser
Files
Exec
Skills
Automation
Nodes
这样出现问题时,更容易定位到底是哪一个组件导致的。
三十八、常用命令速查¶
# 查看版本
openclaw --version
# 启动引导
openclaw onboard
# 引导并安装后台服务
openclaw onboard --install-daemon
# Gateway 状态
openclaw gateway status
# 打开 Web Dashboard
openclaw dashboard
# 深度检查
openclaw doctor
# 添加聊天渠道
openclaw channels add
# 查看模型
openclaw models
# 查看 CLI 帮助
openclaw --help
# 更新
openclaw update
OpenClaw 的 CLI 按功能划分了 onboarding、configure、config、doctor、dashboard、channels 等命令,建议初学者优先使用官方 CLI,而不是刚开始就手动修改大量底层配置。
三十九、常见问题¶
1. OpenClaw 是不是一个大模型?¶
不是。
OpenClaw 是 AI Agent 平台 / 个人 AI 助手系统,需要连接大模型才能进行推理。
2. OpenClaw 是不是收费软件?¶
OpenClaw 本身是开源项目,仓库和 npm 包使用 MIT License。真正产生费用的部分通常是你所使用的大模型 API、第三方服务或服务器资源。
3. 一定需要 API Key 吗?¶
需要一个可用的模型访问方式,但不一定必须是传统 API Key。
OpenClaw 当前支持多种认证方式,包括部分厂商的 OAuth / 订阅认证以及本地模型服务。
4. Windows 可以使用吗?¶
可以。
目前 Windows 有:
- 原生 Windows Hub
- PowerShell CLI
- WSL2 Gateway
等使用方式。
5. 可以安装在 VPS 上吗?¶
可以,而且非常适合长时间运行。
推荐:
Linux VPS
+
OpenClaw Gateway
+
Tailscale
或者:
Linux VPS
+
OpenClaw Gateway
+
SSH Tunnel
6. 可以使用 Ollama 吗?¶
可以。Ollama 在官方模型提供商目录中。
7. 可以用微信吗?¶
可以通过相关外部插件接入,但当前官方渠道页面并没有把微信列为 OpenClaw 核心内置渠道,因此安装前应该确认插件来源与兼容版本。
8. OpenClaw 能直接控制电脑吗?¶
可以通过工具、Exec、Browser、Node 等能力操作本地或连接设备,但实际能做什么取决于权限、工具策略、节点配置和运行环境。
因此:
“能不能执行”与“是否应该允许执行”是两个完全不同的问题。
四十、OpenClaw 最值得关注的地方¶
OpenClaw 真正有价值的地方,并不是“又增加了一个聊天机器人”。
它的核心价值在于把:
大模型
+
Tools
+
Browser
+
文件系统
+
Shell
+
聊天平台
+
Skills
+
Automation
+
设备
+
多 Agent
组合成一个可以长期运行的 AI 工作系统。
例如最终可以实现:
你在手机 Telegram 发:
“把今天 GitHub 上值得关注的 AI 项目整理一下,
生成 Markdown,
保存到我的项目目录,
然后把摘要发给我。”
↓
OpenClaw
↓
Web Search
↓
GitHub 数据
↓
AI 分析
↓
Markdown
↓
保存文件
↓
Telegram 返回结果
这已经不是传统意义上的聊天,而是一条由 Agent 自主完成的工作流。
四十一、给普通用户的入门建议¶
如果你第一次接触 OpenClaw,不建议一开始研究所有配置。
最值得按照这个顺序学习:
① 安装 OpenClaw
↓
② openclaw onboard
↓
③ Dashboard
↓
④ 接入一个模型
↓
⑤ Telegram
↓
⑥ Tools
↓
⑦ Browser / Exec
↓
⑧ Skills
↓
⑨ Automation
↓
⑩ VPS + Tailscale
等这条链路跑通以后,再研究:
多 Agent
Sandbox
Node
自定义 Plugin
Webhook
高级权限
模型 Failover
远程 Gateway
这样学习成本会低很多。
四十二、总结¶
OpenClaw 可以看作一个 自托管、可扩展、工具驱动的个人 AI Agent 平台。
它最核心的结构是:
OpenClaw Gateway
│
┌──────────────┼──────────────┐
│ │ │
Models Tools Channels
│ │ │
OpenAI / Claude Browser/Exec Telegram
Gemini / Qwen Files/Search Discord
Ollama / ... Skills WhatsApp
│ │ 飞书
└──────────────┼──────────────┘
│
Agents
│
Automation
│
Nodes
对于只是想“和 AI 聊天”的用户,ChatGPT、Claude、Gemini 等产品通常更加简单;但对于希望让 AI 操作文件、运行代码、浏览网页、连接聊天软件、定时工作并长期运行在自己的电脑或服务器上 的用户,OpenClaw 的价值会明显更大。
尤其是在 VPS + Tailscale + Telegram + 强模型 + Skills + Automation 组合起来以后,OpenClaw 可以逐渐从一个“AI 聊天助手”,变成真正意义上的 个人 AI 工作代理。
官方资源¶
- OpenClaw 官网:https://openclaw.ai/
- 官方文档:https://docs.openclaw.ai/
- GitHub 仓库:https://github.com/openclaw/openclaw
- 安装文档:https://docs.openclaw.ai/install
- 快速开始:https://docs.openclaw.ai/start/getting-started
- 模型配置:https://docs.openclaw.ai/providers/models
- 聊天渠道:https://docs.openclaw.ai/channels
- 安全文档:https://docs.openclaw.ai/security
- 远程访问:https://docs.openclaw.ai/gateway/remote
- Skills:https://docs.openclaw.ai/tools/skills
- Automation:https://docs.openclaw.ai/automation
- CLI:https://docs.openclaw.ai/cli
版本说明:本文按 2026 年 8 月 22 日 官方资料整理。当前 npm
latest稳定版本为 2026.7.1-2,同时存在 beta 版本;OpenClaw 更新速度较快,后续版本可能调整命令、模型、渠道或配置项,实际使用时建议以官方文档为准。