LogoAI225导航
AI项目

OpenClaw 完整指南:开源个人 AI Agent 框架

从零介绍开源个人AI Agent框架OpenClaw的完整使用流程,涵盖安装部署、模型接入、Telegram等聊天平台、Tools工具、Skills扩展、自动化任务以及VPS+Tailscale远程部署,帮助你在自己的设备上搭建可执行实际任务的长驻个人AI助手

AI225编辑
发布日期:2026-08-22

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
  • Google
  • 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 官方文档将 doctorgateway statusdashboard 等作为常用的安装和故障排查入口。


十、OpenClaw 的配置文件在哪里?

默认配置文件:

~/.openclaw/openclaw.json

默认工作空间:

~/.openclaw/workspace/

工作空间通常会保存 Agent 使用的文件、说明文件和 Skills。

例如:

~/.openclaw/
├── openclaw.json
├── credentials/
├── workspace/
│   ├── AGENTS.md
│   ├── SOUL.md
│   ├── TOOLS.md
│   └── skills/
└── ...

官方文档说明,Workspace 是 Agent 的主要工作区域,而 AGENTS.mdSOUL.mdTOOLS.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 发私信时:

  1. OpenClaw 不会直接处理请求
  2. 会生成配对码
  3. 你确认后才能允许这个用户继续使用

官方文档说明,配对码默认有效期为 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 更新速度较快,后续版本可能调整命令、模型、渠道或配置项,实际使用时建议以官方文档为准。

文章目录

相关文章

AI Agent开发入门:构建智能自动化系统

详细介绍AI Agent的概念、开发框架、实现步骤和实际应用场景,帮助开发者构建能够自主执行复杂任务的智能系统

2025-10-13

开源工作流自动化神器 n8n 深度介绍

详细介绍n8n开源工作流自动化工具,支持自托管、AI Agent构建、可视化节点编排,是Zapier的强大替代方案

2025-12-29

解锁 AI 的自主性:深入解读 AutoGPT 及其最新平台化演进

深入解读AutoGPT项目,从命令行工具到AI代理平台的演进,介绍AutoGPT Builder、Forge、Server等核心组件,以及如何构建自主AI智能体

2025-12-28

BrowserOS:开源、隐私优先的Agentic浏览器,让AI帮你自动上网

详细介绍BrowserOS,这是一个基于Chromium深度定制的开源浏览器,内置原生AI Agent框架,支持自然语言指令自动点击、抓取数据、填写表单

2025-12-25

Gemini CLI:Google 开源的终端 AI 代理工具,让 Gemini 直接进入你的命令行

详细介绍Gemini CLI,这是Google开源的终端AI代理工具,支持Gemini 2.5 Pro模型,提供代码编写、问题求解、任务管理等功能

2025-12-24