OpenClaw 使用指南：从安装到上手的个人 AI 助手

我的刀盾
6 阅读10分钟

OpenClaw（开放龙虾）是一款可在你自己电脑上运行的个人 AI 助手，不仅能聊天，还能真正帮你干活：清空收件箱、发邮件、管理日历、值机、控制浏览器与系统等。本文结合 OpenClaw 官网 与社区实践，整理一份从安装、配置到日常使用的完整指南。

摘要

OpenClaw 是开源、可本地/自托管运行的个人 AI 框架，支持 WhatsApp、Telegram、Discord、Slack 等聊天入口，具备持久记忆、浏览器控制、系统访问和可扩展的 Skill 插件。本文从本地部署、Skill 选择、连接 VSCode/Cursor 三方面入手，涵盖一键安装与部署要点、首次配置（onboard）、新手优先安装的 20 个技能及分步建议、网关与仪表盘启动、与 IDE 的集成方式，以及使用时的注意事项与风险提示。

一、OpenClaw 是什么？

官方定位：在个人设备（Mac、Windows、Linux）上本地运行的开源 AI 助手框架，支持多模型调度与自定义扩展，核心是「私有化部署 + 自动化执行」。

可以把它理解成：一个住在你电脑里的「全能助理」——不依赖云端服务器，24 小时待命，能执行你下的指令，并随着使用逐渐记住你的习惯。项目由 Peter Steinberger 及社区维护，前身包括 Clawdbot、Moltbot，现名 OpenClaw，独立运营，非 Anthropic 官方产品。

与 ChatGPT 等云端 AI 的对比可以概括为：

对比项云端 AI（如 ChatGPT）OpenClaw
运行位置云服务器你自己的电脑
访问本地文件一般不可支持
操作电脑/浏览器不支持支持
长时间自动执行任务不支持支持
数据与隐私上传到服务商本地处理、私有

一句话：ChatGPT 像「会聊天的顾问」，OpenClaw 像「有手有脚、能真干活的助理」。

二、它能做什么？

  • 聊天入口：通过 WhatsApp、Telegram、Discord、Slack、Signal、iMessage 等与它对话，支持私聊和群聊。
  • 持久记忆：记住你的偏好与上下文，越用越贴合你的使用方式。
  • 浏览器控制：打开网页、填表、点击、提取数据，可配合 Playwright 等实现自动化。
  • 系统与文件：读写信件、执行 shell 命令、运行脚本，可全权限或沙箱模式，由你选择。
  • 技能与插件：通过社区 Skill 或自建扩展能力，它甚至可以为自己编写新技能并热加载。

因此，它适合：日常代办、邮件/日历整理、信息检索与摘要、自动化脚本触发、与 Claude Code / Cursor 等开发工具配合使用等场景。

三、本地部署

3.1 一键安装（推荐）

macOS / Linux（首次运行可能需要管理员权限安装 Homebrew 等）：

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

Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 -OutFile install.ps1; ./install.ps1

国内用户若官方脚本较慢，可尝试社区提供的安装脚本（请自行确认来源可信）：

  • Mac / Linux：curl -fsSL https://clawd.org.cn/install.sh | bash
  • Windows：iwr -useb https://clawd.org.cn/install.ps1 -OutFile install.ps1; ./install.ps1

一键脚本会处理 Node.js 及依赖，装好后可直接进行下一步。

3.2 使用 npm 安装

已安装 Node.js 时，可全局安装：

npm i -g openclaw
# 或使用 pnpm
pnpm add -g openclaw

3.3 从源码安装（可 hack 版本）

git clone https://github.com/openclaw/openclaw.git
cd openclaw && pnpm install && pnpm run build
# 使用本地构建的 CLI
pnpm run openclaw onboard

3.4 本地部署要点

  • 运行环境：OpenClaw 跑在你自己的机器上（Mac、Windows、Linux），数据与推理可在本机完成，无需把对话上传到第三方服务器。
  • 持久运行：若希望 24 小时待命，可在一台常开电脑或服务器上部署，保持 openclaw gateway 与相关进程常驻；也可用 systemd、Docker 或 PM2 等做进程守护。
  • 网关与端口：对外或跨设备访问时，依赖 openclaw gateway（如 --port 18789），确保防火墙或内网穿透（如 Cloudflare Tunnel）放行对应端口。
  • 模型与成本：本地部署不改变「调用远程 API」时的计费方式；若使用本地模型，则主要占用本机算力，无 API 费用。

四、首次配置：onboard

安装完成后，在终端执行：

openclaw onboard

按提示完成基本配置，例如：

  • 选择/配置 AI 模型（如 Anthropic、OpenAI 或本地模型）。
  • 绑定通讯渠道（如 Telegram、Discord 等），获取并填写 Token 或 Webhook。
  • 必要时配置 API Key、代理等。

完成后，即可在对应聊天应用里与你的「龙虾」对话。

五、Skill 选择与推荐

能力主要由 Skill 扩展。新手常见问题是装了一堆技能却不知道先装什么、怎么排序。下面按「先有用、再全面」的原则，给出适合首批安装的 20 个技能及分步建议（参考 最适合新手先装的 20 个 OpenClaw Skills）。

5.1 新手优先：20 个推荐技能速览

Skill核心用途更适合谁推荐优先级ClawHub 示例
tavily-search联网搜索、查资料、验事实所有新手极高tavily-search
skill-vetter安装前安全审查、排雷所有新手极高skill-vetter
summarize总结网页、PDF、视频、长文内容与研究用户极高summarize
ontology / agent-memory长期记忆、上下文连续长周期用户高ontology / agent-memory
self-improving-agent记录错误并持续优化想长期深用的人高self-improving-agent
proactive-agent主动拆解和推进任务想提升执行感的人高proactive-agent
github仓库、Issue、PR 查询与协作开发者高github
gogGmail、Calendar、Drive、Docs办公用户高gog
find-skills搜索与推荐技能，扩展能力新手探索期高find-skills
weather快速测试、建立正反馈所有新手中weather
filesystem搜索、读取、整理本地文件文档重度用户中高filesystem
fetch抓网页正文、取公开内容调研和采集用户中高markdown-fetch
browser真实浏览器操作、点击、翻页需要动态网页操作的人中高browsh
python数据处理、脚本、分析数据与自动化用户高python
shell系统命令、批处理、工具链开发者与效率用户高shell
notion知识库、数据库、项目同步内容与知识管理用户中高notion
slack团队消息、提醒、进度同步团队协作用户中slack
calendar日程创建、提醒、时间安排办公与管理用户中高calendar
email邮件阅读、总结、跟进高频邮件用户中高porteden-email
pdf提取 PDF 正文、表格与重点文档密集型用户中高pdf

安装方式（以 ClawHub 上的技能名为例）：

clawhub install <技能名>

5.2 建议安装顺序（分三步，避免一次装太多）

  • 第一步：先补基础能力
    优先装：skill-vetter、tavily-search、weather、fetch。目标是把系统跑通、能联网、能快速验证一次成功体验。

  • 第二步：再补执行能力
    接着装：summarize、proactive-agent、self-improving-agent、filesystem、pdf。这时会明显感到 Agent 从「会回答」变成「会做事」。

  • 第三步：按场景补能力

    • 偏开发：github、ontology 或 agent-memory、python、shell、browser
    • 偏办公与内容：gog、ontology 或 agent-memory、notion、calendar、email
    • 还在探索：find-skills、slack

5.3 新手容易踩的坑

  1. 装得太多：技能过多会导致决策混乱、调用变慢、成本上升。建议先稳定用好 3～5 个最常用的。
  2. 一上来就玩高级编排：先跑顺基础工作流，再考虑复杂代理链和多工具协同。
  3. 忽视权限与安全：安装前看来源，使用前看权限，定期清理与更新；可优先装 skill-vetter 做安全审查。
  4. 不围绕真实任务选技能：先想清楚自己最重复、最痛的动作是什么，再按任务选技能，而不是按「别人说好用」来堆。

六、常用命令

# 启动网关（默认端口示例，可按需改）
openclaw gateway --port 18789

# 另开一个终端启动仪表盘
openclaw dashboard

# 停止网关
openclaw gateway stop

# 运行诊断，排查环境与配置问题
openclaw doctor

# 重新配置模型等
openclaw configure

使用流程建议：先 openclaw gateway --port 18789，再新开终端执行 openclaw dashboard，然后在聊天应用或仪表盘中与助手交互。

七、连接 VSCode / Cursor

把 OpenClaw 和日常开发环境打通后，可以「在 IDE 里聊天、让助手操作代码与项目」，或「用手机/聊天软件远程触发 Cursor 做代码任务」。常见几种方式如下。

7.1 Cursor Bridge（用 Cursor 当大脑，带出 OpenClaw 技能）

通过 Cursor Bridge 插件，把 OpenClaw 的技能（飞书、Slack、GitHub 等）用 Model Context Protocol (MCP) 桥接到 Cursor，在 Cursor 里也能调用这些能力，新装的插件可被自动发现。

  • 安装示例：openclaw plugins install openclaw-cursor-bridge
  • 适用：希望在同一 IDE 里既写代码，又用 OpenClaw 的通讯与集成能力。

7.2 cursor-agent（OpenClaw 调用本机 Cursor Agent CLI）

cursor-agent 让 OpenClaw 直接调用本机的 Cursor Agent CLI，而不是自己写代码执行。支持：

  • 命令模式（如 /cursor）：你主动发命令触发 Cursor 执行。
  • Tool 模式：由 AI 判断需要写代码或改项目时自动调用。

好处是项目上下文一致：会加载同一套 .cursor/rules、AGENTS.md 和 MCP 配置，适合「在 Telegram/WhatsApp 里说一句，让 Cursor 在本地改代码、跑测试」的场景（例如手机远程排查问题）。

7.3 OpenClaw Node for VSCode / Cursor

在 VS Code 扩展市场 或 Cursor 扩展里安装 OpenClaw Node，把 IDE 变成 OpenClaw 的一个 Node 端点，提供 40+ 命令，例如：

  • 文件操作、编辑、导航
  • 语言服务（跳定义、查引用、悬停等）
  • Git、测试、调试
  • 与 Cursor Agent CLI 集成

这样在 IDE 内即可与 OpenClaw 网关通信，完成读写文件、执行命令、调用 Agent 等操作。项目可参考：xiaoyaner-home/openclaw-vscode（或社区 fork 如 MaoTouHU/openclaw-vscode）。

7.4 远程聊天 / WebSocket 连接

通过 WebSocket 连接 OpenClaw Gateway，在 VSCode 侧边栏提供聊天界面，支持令牌认证与自动重连。适合「在办公室电脑开 IDE，在家里或手机侧通过同一 OpenClaw 实例对话、远程操控 IDE」的场景。

小结：若主要想在 IDE 里用 OpenClaw 能力，装 OpenClaw Node 或 Cursor Bridge；若主要想 从聊天 App 远程驱动 Cursor 写代码，用 cursor-agent 或配合 Cursor CLI 的 Skill 更合适。

八、使用与入口

  • 聊天应用：在已配置的 WhatsApp、Telegram、Discord 等中直接发消息，助手会按上下文与技能执行任务。
  • Companion App（Beta）：macOS 15+ 可下载菜单栏伴侣应用，与 CLI 配合使用，见 官网 下载页。
  • 仪表盘：通过 openclaw dashboard 在浏览器中管理会话与基础设置。
  • VSCode / Cursor：见上一节，按需选择 Bridge、cursor-agent 或 OpenClaw Node 扩展。

九、注意事项与风险

  1. 并非完全免费：OpenClaw 本身开源免费，但调用 Anthropic、OpenAI 等模型 API 会产生费用，使用本地模型则主要消耗本机资源。
  2. 能力有边界：复杂任务仍需人工审核与干预，不要完全依赖自动化做关键决策。
  3. 权限与隐私：助手可访问文件、执行命令、控制浏览器，部署时要注意权限范围（全盘访问 vs 沙箱），并妥善保管 API Key 与通讯 Token。
  4. 环境要求：建议具备基本命令行与 Node.js 使用能力，遇到报错可先执行 openclaw doctor 并根据文档或社区反馈排查。

十、参考与延伸

总结：OpenClaw 把「个人 AI 助手」从「只聊天」推进到「能自动执行任务」，且数据与算力可在本机或自建环境中完成。从本地部署入手安装与网关、按Skill 选择分步装好首批 20 个推荐技能、再按需连接 VSCode/Cursor，即可在聊天软件和 IDE 里拥有一个可扩展、可记忆、能动手干活的私人助理。使用过程中注意权限与成本，先装对再装多，即可持续用好这只「龙虾」。

avatar
文章
阅读
粉丝