跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashNode.jsAI

OpenClaw 本地优先 AI 智能体部署与使用指南

综述由AI生成OpenClaw 是一款本地优先的开源 AI 智能体,支持通过自然语言指令直接操作电脑、执行命令及处理文件。其数据本地存储,隐私可控,可接入多种 IM 渠道。文章介绍了其核心定位、办公自动化、个人效率及开发辅助等功能,并提供本地、Docker 及云端三种部署方案,涵盖环境要求、安装步骤、模型配置及权限管理,最后列出常见问题排查方法。

黑客帝国发布于 2026/4/6更新于 2026/5/2132 浏览

OpenClaw 简介

OpenClaw(原 Clawdbot/Moltbot)是本地优先、开源、强执行能力的 AI 智能体,能在常用 IM 里用自然语言指挥它直接操作电脑、执行命令、处理文件、自动化任务,数据本地存储、隐私可控。

一、核心定位

  • 本地优先的 AI 代理:数据/会话/凭证默认存在本地 ~/.openclaw,不依赖云端,隐私自主。
  • 有'手'的 AI:区别于纯聊天 AI,它能执行真实操作(文件、终端、浏览器、定时任务)。
  • 多渠道统一入口:接入 Telegram、Discord、Slack、钉钉、飞书等,在聊天里发指令即可。
  • 开源可扩展:MIT 协议,社区 700+ 技能插件,支持自定义开发。

与纯聊天 AI 的区别

对比项纯聊天 AI(ChatGPT/Claude)OpenClaw
输出文本/建议文本 + 真实动作(改文件、发消息、跑命令)
数据云端存储本地/自托管
执行能力无/只读文件、终端、浏览器、定时任务(需授权)
交互渠道单应用统一接入 10+IM
隐私不可控完全可控

二、主要功能

1. 办公自动化

  • 邮件/日程:自动读未读、筛选重要、回复模板、会议纪要生成。
  • 文档处理:PDF 转 Word、批量重命名、数据提取、周报/日报自动生成。
  • 协作管理:GitHub Issue 监控、飞书/钉钉群消息自动处理、任务提醒。

2. 个人效率工具

  • 浏览器自动化:填表、爬虫、网页监控、自动比价、航班值机。
  • 文件管理:整理桌面、批量压缩/解压、搜索/替换、备份同步。
  • 定时任务:每日简报、待办提醒、定时执行脚本、数据巡检。

3. 技术开发利器

  • 代码辅助:生成/调试/重构、API 测试、日志分析、部署自动化。
  • 服务器管理:远程执行命令、环境巡检、日志监控、备份恢复。
  • 本地工具链:终端命令执行、Git 操作、Docker 管理、数据清洗。

4. 生活服务助手

  • 信息搜集:热点分析、比价、资料整理、报告生成。
  • 通知处理:手机通知读取、自动回复、物流跟踪、日程同步。
  • 跨设备协同:电脑/手机/服务器统一控制,任务无缝流转。

三、部署方案

方案 A:本地一键部署(推荐新手/个人)

1. 环境要求
  • Node.js ≥22、2GB+ RAM、双核 CPU
  • 系统:macOS / Linux / Windows(WSL2 推荐)
2. 一键安装
# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
# Windows(WSL2)
wsl --install curl -fsSL https://openclaw.ai/install.sh | bash
3. 初始化配置(关键)
# 启动向导,自动配置模型、IM、守护进程
openclaw onboard --install-daemon

步骤:选择 AI 模型(GPT-4/Claude/通义千问/Ollama 本地模型)→ 输入 API Key → 选择 IM 渠道(Telegram/Discord 等)→ 授权登录 → 安装系统服务(开机自启)。

4. 启动与验证
# 查看状态
openclaw gateway status
# 前台启动(测试)
openclaw gateway run
# 后台服务管理
sudo systemctl start openclaw
sudo systemctl enable openclaw
5. 访问与使用
  • Web 管理端:http://localhost:18789
  • IM 渠道:在 Telegram/Discord 发消息,助手自动回复执行
  • CLI:openclaw agent --message "帮我整理桌面文件"

方案 B:Docker 容器化部署(服务器/多环境)

1. 安装 Docker
# Ubuntu/Debian
sudo apt update && sudo apt install docker.io -y
sudo systemctl start docker && sudo systemctl enable docker
2. 拉取并启动容器
# 拉取官方镜像
docker pull openclaw/openclaw:stable
# 启动容器(映射端口、挂载数据、设置 API Key)
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  -e OPENAI_API_KEY=你的 OpenAI Key \
  -e CLAUDE_API_KEY=你的 Claude Key \
  --restart always \
  openclaw/openclaw:stable
3. 验证与配置
# 进入容器
docker exec -it openclaw bash
# 初始化配置
openclaw onboard
# 退出容器
exit

方案 C:阿里云一键部署(云端/企业/免本地维护)

1. 创建实例
  1. 登录阿里云 → 轻量应用服务器 → 创建实例
  2. 地域:中国香港(免备案)/新加坡/美国
  3. 镜像:应用镜像 → 搜索 OpenClaw(稳定版)
  4. 规格:2vCPU+2GiB+40GiB(基础)/ 2vCPU+4GiB+60GiB(推荐)→ 支付创建
2. 安全组配置(必须)
  • 实例详情 → 安全组 → 添加规则 → 放行 18789 端口(TCP)
3. 配置模型与访问
  1. 实例详情 → 应用详情 → 一键放通端口
  2. 配置百炼/OpenAI/Claude API Key → 执行命令写入
  3. 生成访问 Token → 记录公网 IP 与 Token
4. 访问
  • Web 端:http://你的公网 IP:18789
  • IM:绑定 Telegram/Discord,远程控制

四、部署后必做配置

1. 模型配置(核心)

# 列出支持的模型
openclaw models list
# 设置默认模型
openclaw config set default.model gpt-4o

2. IM 渠道绑定(以 Telegram 为例)

# 登录 Telegram
openclaw channels login telegram
# 按提示输入 Bot Token(@BotFather 获取)

3. 权限与安全(重要)

  • 默认沙箱:工具执行默认沙箱隔离,主机执行需显式授权
  • 权限控制:openclaw permissions 配置工具权限
  • 数据加密:本地数据 AES-256 加密,凭证安全存储

4. 技能安装(扩展能力)

# 搜索技能
openclaw skills search "文件管理"
# 安装技能
openclaw skills install file-organizer

五、常见问题与排错

  1. 端口占用:lsof -i :18789 查看占用进程,kill 后重启
  2. 模型调用失败:检查 API Key 是否正确、余额是否充足、网络是否通畅
  3. IM 连接异常:重新登录渠道,openclaw channels status 查看状态
  4. 执行权限不足:使用 sudo 或配置用户权限,避免直接用 root 运行

六、学习资源

  • 官方文档:openclaw.ai/docs
  • GitHub:github.com/openclaw/openclaw

目录

  1. OpenClaw 简介
  2. 一、核心定位
  3. 与纯聊天 AI 的区别
  4. 二、主要功能
  5. 1. 办公自动化
  6. 2. 个人效率工具
  7. 3. 技术开发利器
  8. 4. 生活服务助手
  9. 三、部署方案
  10. 方案 A:本地一键部署(推荐新手/个人)
  11. 1. 环境要求
  12. 2. 一键安装
  13. macOS / Linux
  14. Windows(WSL2)
  15. 3. 初始化配置(关键)
  16. 启动向导,自动配置模型、IM、守护进程
  17. 4. 启动与验证
  18. 查看状态
  19. 前台启动(测试)
  20. 后台服务管理
  21. 5. 访问与使用
  22. 方案 B:Docker 容器化部署(服务器/多环境)
  23. 1. 安装 Docker
  24. Ubuntu/Debian
  25. 2. 拉取并启动容器
  26. 拉取官方镜像
  27. 启动容器(映射端口、挂载数据、设置 API Key)
  28. 3. 验证与配置
  29. 进入容器
  30. 初始化配置
  31. 退出容器
  32. 方案 C:阿里云一键部署(云端/企业/免本地维护)
  33. 1. 创建实例
  34. 2. 安全组配置(必须)
  35. 3. 配置模型与访问
  36. 4. 访问
  37. 四、部署后必做配置
  38. 1. 模型配置(核心)
  39. 列出支持的模型
  40. 设置默认模型
  41. 2. IM 渠道绑定(以 Telegram 为例)
  42. 登录 Telegram
  43. 按提示输入 Bot Token(@BotFather 获取)
  44. 3. 权限与安全(重要)
  45. 4. 技能安装(扩展能力)
  46. 搜索技能
  47. 安装技能
  48. 五、常见问题与排错
  49. 六、学习资源
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 从零开始:OpenClaw安装+飞书机器人全流程配置指南(附踩坑实录)
  • Git 使用指南:从安装到连接 GitHub
  • VSCode Copilot 插件卡顿问题解决方案
  • CentOS 下五种 Python 定时发送邮件方案实战
  • JVM 内存模型详解:运行时数据区结构解析
  • Vue 项目前端国际化 i18n 实现指南
  • VibeThinker-1.5B:轻量模型如何实现高阶推理突破
  • cocotb平台用VCS仿Xilinx FPGA
  • Android 开发中 Cursor AI 配置与实践技巧
  • Python 网络爬虫基础与通用模板实现
  • 深入理解 Python 对象模型:一切皆对象的底层逻辑
  • 企业投融资模式与法律风险分析
  • ASR 自动语音识别原理与 Whisper 模型详解
  • Python FastAPI 入门实战:从环境搭建到核心功能
  • MonkeyCode 全流程 AI 编程协作工具技术解析
  • Llama-3.2-3B 部署优化:Ollama 上下文窗口与 Token 限制配置
  • 实现一行或多行文本溢出省略效果的常用方法
  • SkyWalking Python 应用分布式追踪实战指南
  • 随机链表深拷贝:三步法详解与代码实现
  • 基于 Spring Boot 的学生成绩管理系统设计与实现

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online