【AI加油站】Openclaw龙虾专题三：OpenClaw完全使用手册精华版：本地AI助手的全方位指南（附下载）

注：国外龙虾有风险，安装需谨慎！！！

2026年最火开源AI助手，从零到一玩转本地部署与自动化

引言

2026年初，一个名为OpenClaw的开源项目在GitHub上迅速走红，短短一个多月收获超18万Star，成为近年来增长最快的AI项目之一。它不仅仅是一个聊天机器人，更是一位能直接操作用户电脑、执行复杂任务的“数字员工”。无论你是个人用户、团队协作者还是开发者，OpenClaw都能为你打开AI自动化的大门。

本文将基于官方手册，为你详细梳理OpenClaw的核心功能、玩法攻略、国内网络使用技巧、本地部署步骤以及安全最佳实践，助你快速上手并深入挖掘这一强大工具。

第一章 OpenClaw简介

1.1 什么是OpenClaw？

OpenClaw（曾用名Clawdbot、Moltbot）是一款开源的个人AI助手平台，采用“本地优先”架构设计。它能在用户自己的设备上运行，通过WhatsApp、Telegram、飞书、钉钉等多种通讯平台与用户交互，不仅能对话问答，还能执行文件处理、浏览器控制、系统命令等任务。它的核心价值在于“从建议到行动”，真正实现AI助手的角色跃迁。

1.2 核心特性与优势

本地优先架构
所有核心功能在用户设备本地运行，数据存储在本地而非云端，带来四大优势：数据隐私（敏感信息不离设备）、离线可用（搭配本地模型可断网使用）、完全控制（自由定制）、零订阅费用（仅需模型API调用费用）。

多平台通讯集成
支持国际平台（Telegram、WhatsApp、Discord、Slack）和国内平台（飞书、钉钉、企业微信），让用户用最熟悉的工具与AI交互。其中Telegram稳定可靠，适合新手；飞书和钉钉则深度适配国内企业环境。

技能插件系统
通过“Skills”机制扩展能力，每个技能用自然语言描述（SKILL.md），无需编程即可创建。技能支持热重载，社区ClawHub已贡献超3000个技能，涵盖搜索、笔记、音乐控制、摘要等。

持久化记忆
采用Markdown文件存储用户偏好、对话历史，实现长期上下文连贯，可主动提醒待办、基于历史数据提供个性化建议。

1.3 发展历程与现状

OpenClaw于2026年1月首次发布，凭借其创新理念迅速引爆社区：

• 1月中旬Star突破10万

• 1月下旬更名为OpenClaw，Star达13万

• 2月中旬生态快速发展，Star超18万

活跃的社区生态包括数万开发者的Discord服务器、超3000技能的ClawHub市场，以及阿里云、腾讯云的一键部署方案。中文社区OpenClawCN也提供了本地化支持。

1.4 适用场景与用户群体

个人用户：知识管理、日程任务、信息聚合、文件处理、开发辅助。
团队协作：智能客服、数据报表、运维监控、内容创作、流程自动化。
开发者：技能开发、插件扩展、集成测试、原型验证。

第二章 海量玩法攻略

2.1 基础功能使用

首次启动需运行配置向导：
openclaw onboard --install-daemon
向导会引导完成GitHub身份认证、AI模型配置（选择提供商并设置API Key）、通讯平台选择、守护进程安装。

基本交互方式有三种：

• Web控制台：浏览器访问http:// 或运行openclaw dashboard

• 即时通讯：在已配置的聊天平台与机器人对话

• 命令行：openclaw message send --target [用户ID] --message "你好"

常用命令包括openclaw status查看状态、openclaw doctor诊断修复、openclaw logs查看日志等。

2.2 文件与文档处理

OpenClaw能通过自然语言指令完成各类文件操作：

• 创建文件：“在桌面上创建一个名为project-ideas.md的文件，内容包含三个AI创业项目想法”

• 批量处理：“把Downloads文件夹里所有的PDF文件移动到Documents/PDF目录，并按日期重命名”

• 内容提取：“提取今天会议纪要中的待办事项”

内置文档处理技能覆盖常见格式：

• Word文档：创建、编辑、格式转换

• PDF操作：读取、合并、拆分、填写表单

• PPT演示文稿：制作PPT、添加图表

• Excel表格：数据处理、图表生成

• Markdown：文档编写、格式转换

案例：每周一上午9点自动读取销售数据，生成带图表的销售报告，保存为Word并发送到销售群；或每天凌晨2点自动整理Downloads文件夹，按类型分类，删除30天前的临时文件。

2.3 浏览器自动化

通过安装浏览器技能（openclaw skills install browser），OpenClaw可控制浏览器执行：

• 网页访问与截图：“打开https://example.com，截取首页截图保存到screenshots文件夹”

• 数据抓取：“访问竞争对手产品页，提取价格、规格和评价，生成对比表格”

• 表单填写：“打开登录页，输入用户名密码并登录”

在服务器环境可配置无头模式。典型应用包括价格监控（每小时检查价格，低于500元发通知）、网站监控（每5分钟检查官网可用性）。

2.4 系统命令执行

OpenClaw可直接执行终端命令，实现深度系统集成：

• 系统信息：“查看当前CPU和内存使用情况”

• 软件安装：“安装Node.js 18版本”

• Git操作：“克隆仓库到workspace，切换到dev分支”

高级开发者可用它搭建自动化部署流水线（拉取代码、测试、构建、部署）或代码审查。
安全提醒：此功能风险极高，建议在沙箱环境运行，或严格限制可执行命令范围。

2.5 通讯平台集成

以Telegram为例：

1. 在Telegram中搜索@BotFather创建机器人，获取Bot Token

2. 运行openclaw configure选择Telegram渠道，输入Token完成配置

飞书集成需创建企业自建应用，配置权限（如接收消息、读取群聊）和事件订阅（im.message.receive_v1），获取App ID和App Secret后在OpenClaw中配置。钉钉类似，需创建企业内部应用，获取AppKey和AppSecret，并配置回调地址（若用Webhook方式）。

2.6 技能插件系统

每个技能包含SKILL.md描述文档，可选tools/脚本和prompts/模板。技能来源优先级：工作区技能 > 本地技能 > 内置技能。常用推荐技能包括：

• serpapi：联网搜索

• github：GitHub操作

• obsidian：笔记管理

• notion：团队协作

• spotify-player：音乐控制

• summarize：内容摘要

安装命令：clawhub search 关键词，clawhub install 技能名称；查看已安装：openclaw skills list；更新：clawhub update 技能名称。

2.7 高级应用场景

个人知识库构建：通过安装obsidian或notion技能，配置存储路径，启用RAG功能，让AI基于知识库回答问题。
自动化工作流：如每天早上8点抓取科技新闻头条，生成摘要发到邮箱；每10分钟监控数据库连接数，超阈值告警。
多智能体协作：部署多个OpenClaw实例分别负责研究、写作、审核，通过共享记忆协同工作。
智能家居控制：结合智能家居API（如PhilipsHue），实现“我要睡觉了”指令调暗灯光、关闭窗帘。

第三章 国内网络使用

3.1 国内部署环境准备

OpenClaw在国内使用无需梯子，得益于：

• 代码托管在国内可访问的镜像源

• 支持国内大模型API（阿里云百炼、智谱AI等）

• 通讯平台支持飞书、钉钉、企业微信

建议配置国内npm镜像源加速下载：

npm config set registry

curl -fsSL | bash

3.2 模型选择与配置

推荐国内模型：

• GLM-4.7（智谱AI）：中文能力强，适合通用任务、编程

• Qwen-Max（阿里云）：长文本支持好，适合文档处理

• DeepSeek-V3（DeepSeek）：性价比高

• ERNIE-Bot（百度）：中文理解深入，适合内容创作

阿里云百炼配置：

1. 登录阿里云控制台，进入百炼服务，创建API Key

2. 在OpenClaw配置文件openclaw.json中添加：

{  "agents": { "defaults": { "model": "qwen-max" } },  "models": {    "providers": {      "aliyun": {        "apiKey": "your-api-key",        "baseUrl": "https://dashscope.aliyuncs.com/api/v1"      }    }  }}

智谱AI配置类似，只需更改model为zhipu/glm-4.7和baseUrl。

本地模型部署（Ollama）：

curl -fsSL | shollama pull qwen2.5-coder:14b

配置中设置model: "ollama/qwen2.5-coder:14b"和Ollama的baseUrl。注意硬件要求：7B模型建议16GB内存，14B建议32GB，32B建议64GB。

3.3 通讯平台接入

以飞书为例详细步骤：

1. 访问飞书开放平台，创建企业自建应用（机器人类型）

2. 在权限管理中添加im:message、im:message:send_as_bot、im:chat:readonly等权限

3. 事件订阅选择长连接方式，添加事件im.message.receive_v1

4. 获取App ID和App Secret，在OpenClaw配置中输入
   钉钉接入需创建企业内部应用，获取AppKey和AppSecret，并配置回调URL（如http://your-server:8000/dingtalk/webhook）。企业微信则需CorpID、AgentID和Secret，并设置可信域名和IP白名单。

3.4 常见问题与解决

• 安装脚本下载失败：使用国内镜像源或手动下载后本地执行。

• 模型API超时：检查网络、API Key、账户余额，尝试切换模型。

• 飞书机器人不回复：检查事件订阅是否为长连接，是否添加了正确事件，验证AppID/Secret，确保网关运行。

• 钉钉回调验证失败：确认URL可公网访问，端口开放，签名计算正确。

• 性能优化：模型响应慢可选择更快模型、优化提示词、使用流式输出；内存占用高可限制并发、定期清理缓存、使用Docker限制资源。

第四章 本地部署指南

4.1 系统要求与环境准备

硬件要求：

• 最低：2核CPU、4GB内存、10GB存储、1Mbps网络

• 推荐：4核CPU、8GB内存、50GB SSD、10Mbps网络

• 高性能：8核+ CPU、16GB+内存、100GB+ SSD、100Mbps+网络

软件依赖：Node.js 22+、npm、Git（可选）、Docker（可选）。
前置检查：node --version 应显示v22.x或更高。

4.2 Windows部署

• 安装Node.js：官网下载LTS版本或使用nvm-windows

• 安装OpenClaw：PowerShell（管理员）执行

iwr -useb | iex

• 国内用户用https://clawd.org.cn/install.psi

• 运行配置向导：openclaw onboard --install-daemon，按提示登录GitHub、配置API Key、选择通讯平台、安装系统服务

• 启动服务：openclaw gateway start，或打开Web控制台openclaw dashboard

推荐在WSL2中部署，体验更佳。

4.3 macOS部署

使用Homebrew安装Node.js，然后运行安装脚本。Mac Mini用户可禁用睡眠保持运行：

sudo pmset -a sleep 0 displaysleep 0 disksleep 0caffeinate -d -i -s &

Apple Silicon芯片运行本地模型效率更高，M1/M2建议7B-13B模型，M2 Pro/M3 Pro可运行14B-32B。

4.4 Linux部署

Ubuntu/Debian：

curl -fsSL | sudo -E bash -sudo apt install -y nodejscurl -fsSL | bashopenclaw onboard --install-daemon

4.5 Docker部署

官方镜像：docker pull openclaw/openclaw:latest
运行容器示例：

docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw openclaw/openclaw:latest

使用Docker Compose更便捷，可配置环境变量和重启策略。国内用户可使用阿里云镜像加速或社区汉化版镜像。

4.6 云服务器部署

阿里云、腾讯云提供一键部署的轻量应用服务器镜像，购买后自动完成部署。其他云平台如华为云、DigitalOcean、Railway也可手动部署，起步价低至5美元/月。

4.7 配置与优化

配置文件~/.openclaw/openclaw.json包含agents、models、gateway、skills等设置。
性能优化：可配置模型故障转移（primary+fallbacks）、定期清理日志、限制记忆保留时长。
备份与恢复：定期备份~/.openclaw/目录，使用tar命令打包，可设置定时任务自动备份。

第五章 安全与最佳实践

5.1 主要安全风险

• 远程代码执行：暴露的实例可能被攻击者利用

• 提示词注入：恶意指令诱导AI执行危险操作

• 凭证泄露：API Key、Token等敏感信息被盗

• 供应链攻击：第三方技能可能包含恶意代码

• 数据泄露：聊天记录、文件被未授权访问

典型攻击场景包括公网未认证的OpenClaw实例（超4.2万个实例存在漏洞）、PDF中嵌入隐藏指令窃取凭证、恶意技能窃取数据。

5.2 安全加固措施

• 网络安全：不将默认端口18789暴露公网，使用VPN或内网访问，修改默认端口

• 系统安全：创建专用用户运行，避免root；使用Docker隔离，限制容器权限

• 应用安全：及时更新，只安装可信技能，审查技能代码，定期检查更新

5.3 权限管理

遵循最小权限原则：限制文件系统可访问目录、网络可访问域名、可执行命令。
配对验证：默认对未知用户生成配对码，需手动批准：

openclaw pairing list telegramopenclaw pairing approve telegram [配对码]

可配置允许列表，只允许特定用户访问。

5.4 监控与审计

启用详细日志记录，配置日志轮转防止磁盘占满。监控高频API调用、大量文件操作、异常网络请求、系统命令执行等异常行为。定期审计开放的端口、已安装技能、凭证安全、系统更新。

安全最佳实践总结：

• 不在生产环境直接运行OpenClaw

• 使用Docker或虚拟机隔离

• 定期备份和更新

• 监控和审计所有操作

• 遵循最小权限原则

附录：常用命令速查与资源

常用命令：

• openclaw --version：查看版本

• openclaw status：查看状态

• openclaw doctor：诊断修复

• openclaw logs --follow：查看实时日志

• openclaw skills list：列出已安装技能

• clawhub search 关键词：搜索技能

• openclaw channels status：查看通讯平台状态

故障排除：

• 端口被占用：lsof -i:18789，更换端口

• 模型无响应：检查API Key、余额、网络，切换模型

• 通讯平台不回复：检查通道状态、凭证、事件订阅，重启Gateway

官方资源：

• GitHub：https://github.com/openclaw/openclaw

• 文档：https://docs.openclaw.ai

• 技能市场：https://clawhub.ai

中文社区：

• OpenClaw CN：https://clawd.org.cn

• 中文文档：https://docs.clawd.org.cn

• Discord社区：https://discord.gg/clawd

云厂商方案：阿里云、腾讯云提供一键部署镜像。
相关工具：Ollama（本地模型）、ClawHub（技能市场）、AgentSkills（技能标准）。

结语

OpenClaw将AI从“建议者”变为“行动者”，其本地优先、多平台集成、技能生态等特性，使其成为个人和团队不可或缺的数字助手。无论你追求数据隐私、自动化效率，还是探索AI应用开发，OpenClaw都值得深入尝试。加入活跃的社区，发掘更多玩法，开启你的AI自动化之旅！

扫码加入星球社区人工智能产业链联盟（见原手册），与更多爱好者交流探讨。

【AI加油站】第八部：《模式识别（第四版）-模式识别与机器学习》（附下载）