OpenClaw中文教程：安装、部署、配置与使用指南

OpenClaw 是一款开源 AI 助手平台，支持 WhatsApp、Telegram、飞书、微信等多平台接入，并可调用代码执行、联网搜索、浏览器自动化等 Skills。本页把 OpenClaw 是什么、怎么安装、怎么部署、怎么配置、怎么开始使用整合到一个页面里，适合第一次接触 OpenClaw 的个人用户、开发者和团队管理员快速上手。

🦞

OpenClaw

Your Personal AI Assistant - The Lobster Way

100K+ GitHub Stars

13000+ 社区 Skills

50+ 消息平台

MIT 开源协议

GitHub 仓库官方网站

一键安装命令

curl -fsSL https://get.openclaw.ai | bash

适用于 macOS / Linux。Windows 用户可直接看下方“安装教程”部分，完成安装后继续看“配置教程”。

认识 OpenClaw 快速上手安装教程部署教程配置教程常见问题

OpenClaw 是什么

先理解它的定位、核心概念和适合场景，再决定怎么安装和部署

💬

多平台消息接入

支持 WhatsApp、Telegram、Slack、Discord、飞书、微信、企业微信等消息平台，让你在熟悉的聊天环境里直接调用 AI 助手。

🧠

多模型兼容

兼容 Claude、GPT、Gemini、LLaMA、通义千问等主流模型，也支持通过 Ollama 接入本地模型，适合兼顾成本、性能和隐私的场景。

🔌

Skills 插件生态

通过 ClawHub 扩展联网搜索、代码执行、浏览器自动化、文件处理等能力，不需要自己从零写完整 Agent 工作流。

🔒

开源自托管

MIT 协议开源，可本地部署，也可放到云服务器或 Docker 环境中长期运行，适合对控制权和数据安全有要求的用户。

核心概念

Agent（代理）

负责理解指令、规划步骤并调用模型与 Skills 执行任务，是 OpenClaw 的核心执行单元。

Skills（技能）

插件系统。每个 Skill 赋予 OpenClaw 一种额外能力，例如联网搜索、代码运行、浏览器自动化或文件处理。

Transports（传输层）

消息接入层。OpenClaw 通过它连接 WhatsApp、Telegram、飞书、微信等不同平台。

ClawHub

社区技能市场，用来搜索、安装和管理 Skills，帮助你快速扩展现成功能。

适合谁用

开发者：需要远程写代码、跑脚本、查日志、自动化处理任务

运营与内容人员：需要联网搜索、整理资料、生成内容、批量处理信息

团队管理员：需要在飞书、Slack、企业微信群里部署共享 AI 助手

个人效率用户：希望在聊天软件里直接调用 AI 完成提醒、总结、查询和自动化流程

OpenClaw 快速上手

按这个顺序做，通常 10 到 20 分钟可以完成第一次可用配置

确认安装成功

先在终端执行 openclaw --version，确认命令可用。首次上手建议先选择最省事的安装方式，再回头优化部署方式。

初始化配置

执行 openclaw init 或 openclaw config，先填入大模型 API Key，再决定连接哪些消息平台。

接入消息平台

在配置文件的 transports 部分填写 Telegram Bot Token、飞书 App ID / Secret、企业微信参数或 WhatsApp 连接方式。

安装必要 Skills

推荐先装 web-search、code-runner、browser-auto 这类最常用技能，让 OpenClaw 能查信息、执行代码和操作网页。

发送第一条真实任务

启动服务后，在已接入的平台里发送一条实际需求，例如“帮我查今天的天气”“写一段 Python 排序代码并解释”“把这段文案改写成公告风格”。

常用命令速查表

openclaw start

启动 OpenClaw 服务

openclaw stop

停止当前服务

openclaw status

查看运行状态

openclaw config

打开配置文件

openclaw skills install web-search

安装联网搜索 Skill

openclaw logs -f

实时查看运行日志

🌐

web-search

联网搜索能力，适合查询时事、补充资料、为回答附上最新背景信息。

💻

code-runner

代码执行能力，让 OpenClaw 不止能写代码，还能帮你验证脚本结果和运行片段。

📄

file-manager

文件读写与管理能力，适合整理文档、生成报告、处理批量文本与配置文件。

🌐

browser-auto

浏览器自动化能力，可打开网页、截图、填写表单、执行网页任务。

OpenClaw 安装教程

按平台选择安装方式。对大多数用户来说，先装起来并跑通第一条消息比纠结最佳部署方式更重要。

系统要求

macOS 12 及以上，支持 Intel 和 Apple Silicon
建议内存 4GB 以上，磁盘空间 500MB 以上
具备网络访问能力，方便拉取安装脚本和依赖

方式一：一键安装脚本

curl -fsSL https://get.openclaw.ai | bash

方式二：Homebrew 安装

brew install openclaw

方式三：npm 安装

npm install -g openclaw

系统要求

Windows 10 / 11
需要 Node.js 18+ 运行环境
建议使用 PowerShell 执行安装命令

方式一：npm 安装

先从 Node.js 官网安装 LTS 版本，再在 PowerShell 中运行：

npm install -g openclaw

方式二：WSL2 安装

如果已配置 WSL2，可在 Linux 子系统里直接使用一键安装脚本：

curl -fsSL https://get.openclaw.ai | bash

如果遇到执行策略限制，可在 PowerShell 中运行 Set-ExecutionPolicy RemoteSigned 后重试。

系统要求

主流 Linux 发行版，如 Ubuntu、Debian、CentOS
建议已安装 curl、bash、systemd
云服务器部署时建议独立目录存放配置与日志

方式一：一键安装脚本

curl -fsSL https://get.openclaw.ai | bash

方式二：npm 安装

npm install -g openclaw

方式三：Docker 体验

docker pull openclaw/openclaw

安装后初始化

运行 openclaw --version 确认安装成功。

运行 openclaw init 进入初始化向导，先配置模型提供商和 API Key。

使用 openclaw config 补充消息平台凭据，完成后再启动服务。

安装注意事项

macOS 首次运行可能被系统拦截，需要在“安全性与隐私”中允许执行。

Windows 建议使用 PowerShell 而不是 CMD，避免路径与权限问题。

Linux 服务器环境建议尽早配合 systemd 或 Docker 管理进程，而不是长期手工前台运行。

如果你不希望污染本机环境，可以直接选择 Docker 方案。

OpenClaw 部署教程

部署重点不是“装上去”，而是让服务稳定、可恢复、可维护，并且不把敏感配置暴露出去。

三种部署方式对比

对比项	本地部署	云服务器	Docker
成本	最低	有服务器成本	依赖宿主机环境
在线时长	设备开机时可用	适合 7x24 小时	适合长期运行
技术门槛	最低	中等	中等
适用场景	个人体验	稳定个人使用 / 团队	环境隔离 / 运维统一

本地部署步骤

1. 完成安装并初始化配置

优先把 API Key 和消息平台凭据填好，避免部署完仍无法连通。

2. 启动守护进程

openclaw start --daemon

3. 查看日志确认连接成功

openclaw logs -f

云服务器部署步骤

1. 登录服务器并安装 OpenClaw

curl -fsSL https://get.openclaw.ai | bash

2. 初始化并编辑配置

openclaw init

3. 使用 systemd 管理服务

sudo openclaw service install

4. 启动并设置开机自启

sudo systemctl enable --now openclaw

Docker 部署步骤

1. 拉取镜像

docker pull openclaw/openclaw

2. 准备配置目录

mkdir -p ./openclaw-config

3. 启动容器

docker run -d --name openclaw --restart=unless-stopped -v $(pwd)/openclaw-config:/app/config openclaw/openclaw

🔒

配置文件权限

建议把配置文件权限设为 600，避免 API Key 泄露，也不要把含敏感信息的配置目录直接提交到 Git。

🛡

限制访问来源

在配置中设置 allowed_users 或对应白名单，只允许指定账号、手机号或用户 ID 与 OpenClaw 交互。

🔧

更新与备份

定期更新版本，备份配置目录、Skills 和历史数据；长期运行环境建议配合 logrotate 管理日志。

📊

日志监控

遇到连接失败、Skill 异常、模型调用报错时，第一时间看 openclaw logs，比盲目改配置更有效。

OpenClaw 配置教程

配置分三层：模型、消息平台、Skills。先让模型可用，再决定消息入口，最后补能力扩展。

配置 AI 模型 API Key

运行 openclaw config 打开配置文件，在 llm 部分填入提供商、模型和 API Key。

Claude（Anthropic）

llm:
  provider: anthropic
  model: claude-sonnet-4-6
  api_key: sk-ant-xxxxxxxxxxxxx

GPT（OpenAI）

llm:
  provider: openai
  model: gpt-4o
  api_key: sk-xxxxxxxxxxxxx

本地模型（Ollama）

llm:
  provider: ollama
  model: llama3:8b
  base_url: http://localhost:11434

建议：优先用环境变量保存 API Key，例如 export OPENCLAW_LLM_API_KEY=你的Key，避免把密钥明文写进配置文件。

接入消息平台

在 transports 部分填入平台凭据。先接入一个你最常用的平台，跑通后再扩展到其他入口。

飞书

transports:
  feishu:
    enabled: true
    app_id: cli_xxxxxxxxxxxxx
    app_secret: xxxxxxxxxxxxx
    verification_token: xxxxxxxxxxxxx

企业微信

transports:
  wecom:
    enabled: true
    corp_id: xxxxxxxxxxxxx
    agent_id: 1000002
    secret: xxxxxxxxxxxxx

transports:
  telegram:
    enabled: true
    bot_token: xxxxxxxxxxxxx

安装和配置 Skills

Skills 决定 OpenClaw 能不能联网、能不能执行代码、能不能操作浏览器。先装最常用的，再按场景逐步扩展。

安装联网搜索 Skill

openclaw skills install web-search

安装代码执行 Skill

openclaw skills install code-runner

安装浏览器自动化 Skill

openclaw skills install browser-auto

建议：先装联网搜索、代码执行、文件管理和浏览器自动化四类基础 Skills，再根据业务场景继续扩展。

🔑

密钥管理

推荐使用环境变量、密钥管理服务或加密配置，不要把 API Key 长期硬编码在仓库里。

⚙

多模型兜底

为高价值任务准备第二模型作为备用方案，主模型不可用时可以自动切换，避免整套服务停摆。

👥

权限控制

为不同用户或频道设置白名单和权限，限制高风险 Skill 的调用范围，避免误操作。

📱

平台选择

飞书和企业微信适合团队；Telegram 配置最轻；WhatsApp 适合海外个人用户，但稳定性要看接入方式。

OpenClaw 常见问题

这些问题基本覆盖了 OpenClaw 教程、安装、部署、配置这几类搜索意图

OpenClaw 是什么？和 Clawdbot、Moltbot 是什么关系？ ▼

OpenClaw 是一个开源 AI 助手平台，最早经历过 Clawdbot 和 Moltbot 两个历史名称，后续统一为 OpenClaw。它的核心能力是把大模型、Skills 和消息平台整合起来，让你通过聊天入口直接触发自动化任务。

OpenClaw 怎么安装最快？ ▼

macOS 和 Linux 用户通常直接执行一键安装脚本最快；Windows 用户一般通过 Node.js + npm 安装最省事。如果只是想先体验，用最短路径把命令跑通即可，后续再切换部署方式。

OpenClaw 部署在本地、云服务器还是 Docker 更合适？ ▼

个人体验优先本地部署；需要 7x24 小时在线和稳定消息入口时选云服务器；想隔离环境、便于迁移和统一运维时选 Docker。关键不是“哪种更高级”，而是你是否需要长期在线和是否方便维护。

OpenClaw 配置时最先要填什么？ ▼

先填大模型 API Key，因为模型不可用时其他配置都无法验证。第二步再接入一个消息平台，第三步再装 Skills。这个顺序最容易快速定位问题出在哪一层。

OpenClaw 支持哪些模型和消息平台？ ▼

模型方面支持 Claude、GPT、Gemini、LLaMA 以及通过 Ollama 接入的本地模型；消息平台方面支持 WhatsApp、Telegram、飞书、微信、企业微信、Slack、Discord 等多种常见入口。

OpenClaw 的 Skills 有哪些值得先安装？ ▼

新手优先安装 web-search、code-runner、file-manager、browser-auto。这四类基本覆盖信息检索、代码执行、文件处理和网页操作，是最常见的生产力组合。

OpenClaw 适合没有编程基础的人吗？ ▼

基础使用是可以的。只要会按教程运行命令、填写 API Key、复制平台凭据，就能把 OpenClaw 跑起来。真正需要技术基础的部分主要集中在自定义 Skills、服务器部署和复杂工作流编排。

为什么不再把安装、部署、配置拆成单独页面？ ▼

因为这几个页面本质上都属于同一软件主题下的不同任务阶段。把它们合在一个高信息密度的 SSR 页面里，更方便用户按顺序完成“了解产品 → 安装 → 部署 → 配置 → 开始使用”的完整路径。