OpenClaw安装操作指南，详细教程，小白也能安装、配置、修复技术问题

官方资料

• 官方文档：https://docs.openclaw.ai
• 官方安装指南：https://docs.openclaw.ai/install

OpenClaw简介

OpenClaw 是一个开源的 AI Agent 框架，它能够 24*7 不间断地在你的电脑上工作。与 ChatGPT 这类对话工具完全不同，OpenClaw 拥有“眼睛和手”：它可以控制浏览器、编写代码、阅读文件、执行命令，甚至在你睡觉时主动完成任务，它是“一款真正能落地干活的AI”。

OpenClaw之所以爆火，是因为它解决了过去三年AI工具的一个核心痛点：AI只会说，不会做。
对于传统大语言模型来说，它就像是一个顾问或客服，你问一句，它也就答一句，有时候还可能出现“幻觉”、胡言乱语，或者是忘记之前的对话。
而对于OpenClaw这样的AI智能体框架，它更像一个坐在你电脑前的员工，能自行在电脑上完成你安排的任务，将我们从复制粘贴、多软件切换等重复或繁琐的工作中解放出来。

同时，通过框架层面的设计，OpenClaw在理论上能拥有更稳定的长期记忆， 能记住你的偏好、系统环境和历史任务。你还可以根据需要给它取名、定规则、调教技能，让工作的完成结果更贴合个人需求，这被网友戏称为“养虾”。

OpenClaw 四层架构全景图：Gateway（耳朵）→ Agent（大脑）→ Skills（双手）→ Memory（记忆）

这四层架构协同工作，让 OpenClaw 不再是一个简单的工具，而是一个具备”感知—思考—行动—记忆”完整闭环的智能体（Agent）。它的出现，标志着 AI 正式从 *“对话时代”* 迈入了 *“执行时代”*。

核心特性

• 执行能力：不仅能回答问题，还能实际操作电脑（读写文件、执行命令、打开应用等）
• 全天候运行：24/7 待命，睡眠时也能执行任务（参考4.3设置）
• 持久记忆：可以一直记住之前的对话上下文
• 主动服务：可以主动发起对话和提醒
• 开源免费：数据完全本地化
• 多平台支持：可以通过手机聊天软件，通过对话方式驱动电脑上的 OpenClaw
• • 国际：WhatsApp、Telegram、Discord、Slack、iMessage
• • 国内：飞书、钉钉

本地部署的优势

本地部署意味着 OpenClaw 运行在你桌面上的物理设备上。这种方式有四个核心优势：

（1）设置更简单。

本地安装只需要一行命令，而 VPS 部署需要配置服务器、网络、安全规则等复杂步骤。

（2）默认安全。

在本地环境中，你的数据不会离开你的设备。VPS 部署则需要大量额外工作来确保安全性，包括配置防火墙、设置访问控制、加密通信等。

（3）更好的集成。

本地运行时，OpenClaw 可以直接访问你的文件系统、应用程序和工作流。你可以在屏幕上实时看到它的工作过程，这比在浏览器中查看远程终端要直观得多。

（4）完整功能。

VPS 部署只能获得 OpenClaw 约 20% 的能力。许多高级功能，如直接控制本地应用、访问剪贴板、与桌面环境交互等，在云端根本无法实现。

OpenClaw能做的事情和你用电脑能做的完全一样——包括发邮件、投简历、甚至做交易。这意味着：

⚠️权限风险：它默认在用户权限下运行，如需执行高风险操作（如），需显式声明

⚠️模型安全：它依赖外部大模型（GPT-4、Claude、通义千问等），API密钥需妥善保管

建议先在隔离环境测试，再用于生产场景。

⚠️注意事项：

使用成本高

建议：OpenClaw这类智能体无疑是通向通用人工智能（AGI）和全自动化办公的重要里程碑，但目前仍然存在不可忽视的功能缺陷和安全风险。如果是程序开发者或AI的狂热爱好者，OpenClaw绝对是一个值得把玩的对象；但如果只是希望找个工具能帮你改改周报、翻译一下文档，平时也对编程、开发一窍不通，那大可以暂时放弃“养虾”的念头，安心享受DeepSeek、Kimi们所带来的便利吧。

一定要注意：

比如本地电脑上的邮件全删事件，钱包支付，浏览器中保存的账号密码，APIKey泄露，文件操作，误删等等

问题防范：硬件环境为办公电脑、安装好后编写提示词限制：不要随便删除文件，系统文件严禁删除必要时必须询问我同意后再进行操作

数据问题：使用大模型交互的所有数据都有数据泄露的风险（模型安全边界）

全部私有化部署基本可解决所有问题——大模型+桌面系统

选择大厂模型：字节、阿里云、kimi

按请求次数计费的token

https://bailian.console.aliyun.com/cn-beijing/?spm=5176._47.overview_recent.1.53032cc9ZCwzHK&tab=coding-plan#/efm/index

powershell安装python、visualstudio

nodejs安装

安装以下软件打开科学上网工具，避免github无法访问报错，npm包无法下载报错

opencode安装

openclaw安装

https://openclaw.ai/

curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

npm install -g openclaw@latest –force

以管理员身份打开dos窗口

直接安装会报错，因为 OpenClaw 依赖的 库需要通过 SSH 从 GitHub 克隆，但你的系统没有配置 GitHub SSH 密钥。

配置 Git 使用 HTTPS 代替 SSH

git config –global url.“https://github.com/”.insteadOf “ssh:///”

如果安装失败过，找到文件目录手动删除缓存文件

使用预构建二进制文件（跳过编译）

powershell

安装成功，运行

openclaw onboard

如果是购买阿里云百炼的token直接修改apikey，复制配置文件到agent目录下进行替换即可

https://bailian.console.aliyun.com/cn-beijing/?spm=5176._47.overview_recent.1.53032cc9ZCwzHK&tab=coding-plan#/efm/index

openclaw配置文件配置：

auth-profiles.json

{
“version”: 1,
“profiles”: {
“alibaba-cloud:default”: {
“type”: “api_key”,
“provider”: “alibaba-cloud”,
“key”: “sk-sp-XXXXXXXXXXXX”
}
},
“lastGood”: {
“alibaba-cloud”: “alibaba-cloud:default”
},
“usageStats”: {
“alibaba-cloud:default”: {
“lastUsed”: 71,
“errorCount”: 0,
“lastFailureAt”: 27
}
}
}

models.json

{
“providers”: {
“alibaba-cloud”: {
“baseUrl”: “https://coding.dashscope.aliyuncs.com/v1”,
“api”: “openai-completions”,
“models”: [
{
“id”: “qwen3-max-2026-01-23”,
“name”: “qwen3-max-thinking”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: ,
“maxTokens”: 65536
},
{
“id”: “qwen3.5-plus”,
“name”: “qwen3.5-plus”,
“reasoning”: false,
“input”: [
“text”,
“image”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: ,
“maxTokens”: 65536
},
{
“id”: “qwen3-max”,
“name”: “qwen3-max”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: ,
“maxTokens”: 65536
},
{
“id”: “qwen3-max-2025-09-23”,
“name”: “qwen3-max-2025-09-23”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: ,
“maxTokens”: 65536
},
{
“id”: “qwen3-max-preview”,
“name”: “qwen3-max-preview”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: ,
“maxTokens”: 65536
},
{
“id”: “qwen-plus”,
“name”: “qwen-plus”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: ,
“maxTokens”: 32768
},
{
“id”: “qwen-flash”,
“name”: “qwen-flash”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: ,
“maxTokens”: 32768
},
{
“id”: “qwen3-omni-flash”,
“name”: “qwen3-omni-flash”,
“reasoning”: false,
“input”: [
“text”,
“image”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: 65536,
“maxTokens”: 16384
},
{
“id”: “qwen3-vl-plus”,
“name”: “qwen3-vl-plus”,
“reasoning”: false,
“input”: [
“text”,
“image”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: ,
“maxTokens”: 32768
},
{
“id”: “qwen3-coder-plus”,
“name”: “qwen3-vl-plus”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: ,
“maxTokens”: 65536
},
{
“id”: “qwen-plus-us”,
“name”: “qwen-plus-us”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: ,
“maxTokens”: 32768
},
{
“id”: “qwen-flash-us”,
“name”: “qwen-flash-us”,
“reasoning”: false,
“input”: [
“text”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: ,
“maxTokens”: 32768
},
{
“id”: “qwen3-vl-flash-us”,
“name”: “qwen3-vl-flash-us”,
“reasoning”: false,
“input”: [
“text”,
“image”
],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: ,
“maxTokens”: 32768
}
],
“apiKey”: “sk-sp-XXXXXXXXXXXXXXXXXXXXXXXX”
}
}
}

飞书配置

插件安装命令：

https://open.feishu.cn/

权限管理导入导出：

}

事件回调

设置为长连接

常用命令速查

核心命令

服务管理

插件管理

设备管理

模型管理

最火20个Skills排行：
1、gog（Gmail/日历/Drive一键管）
2、youtube-full（视频摘要神器）
3、gemini-cli（AI研究助手）
4、coding-agent（写代码不求人）
5、weather（每日天气推送）
6、apple-reminders（待办提醒）
7、spotify/apple-music（语音控制音乐）
8、twitter（自动发推管理）
9、clickup（项目管理）
10、todoist（任务清单）
11、jira（工作流转）
12、obsidian（笔记整理）
13、slack（消息管理）
14、fal-ai（AI生图）
15、elevenlabs（文字转语音）
16、polymarket（预测市场）
17、n8n（工作流自动化）
18、linear（团队协作）
19、context7（文档查询）
20、cron-natural（定时任务）

gog + weather + reminders 每天早晨8:30自动推送日程+天气+邮件摘要！

我本地已经安装配置好了openclaw现在想使用openclaw技能 gog + weather + reminders 每天早晨8:30自动推送日程+天气+邮件摘要！请先帮我安装相关技能，并检查配置整合技能实现该功能

openclaw问题修复：

opencode中操作openclaw进行修复，opencode如果免费token用完也需要选择模型进行配置apikey

示例：

将openclaw控制台的硬件token替换为以下这段:

npx clawhub@latest install github