OpenClaw 安装使用全攻略:5分钟养出你的数字员工

🦞 OpenClaw 安装使用全攻略：5分钟养出你的数字员工

——npm/pnpm 全局安装 + 交互式配置向导 + 上手实操指南

▲ OpenClaw支持Windows、Mac、Linux多平台部署

上篇文章我们介绍了OpenClaw是什么。今天直接上干货：从Node.js环境准备到npm全局安装，从交互式配置向导到第一条指令测试，全程给出具体命令和真实路径。无论你是Windows、Mac还是Linux用户，跟着这篇教程，5分钟内你的「小龙虾」就能开始干活。

一、安装前准备（必做避坑）

1.1 系统要求

OpenClaw支持主流操作系统，具体要求如下：

系统	要求
Telegram	⭐ 简单：@BotFather创建Bot获取Token
微信	⭐⭐ 中等：通过插件安装微信Bot
Discord	⭐ 简单：Developer Portal创建Bot
Slack	⭐⭐ 中等：Slack API创建App获取Token
飞书	⭐⭐ 中等：飞书开放平台创建企业应用

以Telegram为例配置：

1. 在Telegram搜索 @BotFather → 发送 /newbot → 输入Bot名称 → 复制返回的Token

2. 在openclaw.json的channels.telegram.token填入Token

3. 重启Gateway：openclaw gateway restart

4. 向你的Bot发送消息，即可开始交互

▲ 手机端通过聊天App远程操控OpenClaw

5.4 自然语言指令示例

以下是一些新手友好的入门命令，直接发送给Agent即可：

📁 文件管理类

「把桌面所有PDF按日期分类到Documents文件夹」
「将Downloads里的图片批量重命名为日期+序号格式」
「找出电脑里大于500MB的文件，按大小排序」

📧 办公自动化类

「帮我检查未读邮件，把标题含『发票』的标记为重要」
「读取桌面report.xlsx，生成一份数据摘要发到我微信」
「把本周日历里所有会议提前15分钟设置提醒」

💻 开发辅助类

「在当前目录创建一个Python脚本，功能是批量压缩图片」
「检查这个项目的依赖是否有安全漏洞，给出修复建议」
「把这段代码重构为更高效的版本，并添加中文注释」

六、Skills技能管理：扩展小龙虾的能力

6.1 安装官方Skills

OpenClaw自带skill-creator工具，也支持从ClawHub安装社区技能。常用命令：

openclaw skills list

查看已安装技能

openclaw skills install @clawhub/web-search

安装网页搜索技能

openclaw skills install @clawhub/github

安装GitHub操作技能

openclaw skills install @clawhub/healthcheck

安装系统健康检查技能

6.2 自主创建技能

使用内置的skill-creator工具创建自定义技能：

openclaw skill-create my-skill

OpenClaw会引导你完成：定义技能名称与描述 → 编写执行代码 → 本地测试调试 → 封装为SKILL.md文件。创建成功后，该技能会出现在skills目录下，随时可调用。

▲ CLI技能安装界面：选择要部署到的Agent

七、进阶优化：让它越用越顺手

7.1 编辑记忆文件，定制专属助理

OpenClaw的人格和记忆都存储在Markdown文件中，直接编辑即可改变行为：

~/.openclaw/workspace/SOUL.md

修改语气、性格、自称

~/.openclaw/workspace/USER.md

添加你的职业、偏好

~/.openclaw/workspace/AGENTS.md

定义工作规则

~/.openclaw/workspace/TOOLS.md

添加自定义API

保存后重启Gateway立即生效：openclaw gateway restart

7.2 接入本地大模型（离线使用）

如果你担心隐私或网络不稳定，可以接入Ollama本地模型：

Step 1：安装Ollama → ollama.com下载对应系统版本

Step 2：拉取模型：ollama pull llama3 或 ollama pull qwen2.5

Step 3：在openclaw.json的models中配置：

{

“models”: {

“default”: “ollama/llama3”,

“providers”: {

“ollama”: { “baseUrl”: “http://localhost:11434” }

}

优点：完全离线，数据不出设备，零API费用。

缺点：本地模型能力通常弱于云端大模型，复杂任务可能效果打折。

7.3 版本更新与渠道切换

OpenClaw更新非常频繁，保持最新版能获得最新功能和安全修复：

npm update -g openclaw

更新到最新稳定版

openclaw update –channel stable

切换到稳定版渠道

openclaw update –channel beta

切换到测试版渠道

openclaw update –channel dev

切换到开发版渠道

更新后建议运行 openclaw doctor 检查兼容性。

八、常见问题排查

遇到任何问题时，先运行诊断命令：

openclaw doctor

doctor命令会全面检查环境、配置、依赖、权限等，并给出具体的修复建议。这是排错的第一站。

问题	解决方案
node: command not found	Node.js未安装或环境变量未配置。重新安装Node.js 24，重启终端。
EACCES permission denied	npm全局目录无写入权限。修改npm prefix到用户目录，勿用sudo。
openclaw: command not found	安装成功但PATH未包含。检查which openclaw，添加bin目录到PATH。
Gateway启动失败	端口被占用或配置错误。检查18789端口占用，运行openclaw doctor。
模型无响应	API Key错误或额度用完。检查Key有效性，查看余额，更换模型。
Channel连接失败	Token错误或网络问题。重新获取Token，检查防火墙，确认enabled都为true。
Skills安装失败	网络或依赖缺失。切换npm镜像源，或手动安装依赖。

结语：你的数字员工已就位

恭喜你，按照本教程操作，你已经成功通过npm安装了OpenClaw，运行了交互式配置向导，并学会了通过命令行、Web界面和聊天平台与Agent交互。

从整理文件到发送邮件，从编写代码到管理日程，OpenClaw正在把AI从「建议者」变成「执行者」。而你只需要像指挥助理一样，用自然语言下达指令。

后续你可以继续探索：接入更多Skills、对接企业微信/飞书、配置自动化工作流、甚至让它学习你独特的操作习惯。Agent OS的时代，从养一只小龙虾开始。

如果遇到问题，欢迎在评论区留言，或访问GitHub官方仓库 github.com/OpenClaw/OpenClaw 查看文档与社区讨论。推荐关注 awesome-openclaw-tutorial 中文教程仓库，持续更新最新玩法。