【OpenClaw学习记录】

OpenClaw学习记录一、OpenClaw 核心介绍1.1 什么是 OpenClawOpenClaw龙虾是2025-2026年爆火的开源自主AI智能体框架由奥地利程序员Peter SteinbergerPSPDFKit创始人开发曾用名Clawdbot、Moltbot最终定名OpenClaw。1.2 核心特点本地部署隐私安全数据无需上传云端全程在本地设备运行杜绝隐私泄露风险。全闭环任务执行支持“语言指令→AI自主规划→调用工具/本地操作→结果反馈”全流程自动化。多模型兼容支持Claude、GPT-4o、Ollama、国内百炼/DeepSeek等主流大模型。可插拔技能系统内置文件操作、终端命令、邮件、浏览器、数据库等技能支持自定义扩展。多渠道交互支持Telegram、飞书、Discord等聊天窗口远程指挥也可通过Web控制台操作。1.3 核心能力与应用场景核心能力典型应用场景文件自动化整理桌面、分类文档、批量重命名、数据统计代码开发生成代码、调试脚本、运行程序、管理项目办公自动化写周报/文案、生成表格、整理会议纪要、收发邮件信息处理网页抓取、数据汇总、生成图表、翻译文档远程控制通过飞书/Telegram远程操控电脑执行任务二、部署前环境准备2.1 系统要求Windows10/11 64位推荐WSL2子系统兼容性更好。macOS12Intel/Apple Silicon均支持。LinuxUbuntu 20.04、Debian、CentOS等。2.2 硬件要求最低配置双核CPU、4GB内存、200MB空闲磁盘。推荐配置四核CPU、8GB内存、500MB空闲磁盘处理复杂任务更流畅。2.3 核心依赖Node.jsv18必须推荐v22 LTS版本。网络安装时需联网下载依赖运行后可离线本地模型模式。2.4 国内网络优化国内用户需提前配置镜像源避免安装超时或失败# 配置npm淘宝镜像npmconfigsetregistry https://registry.npmmirror.com# 配置pnpm镜像推荐pnpmconfigsetregistry https://registry.npmmirror.com三、三种部署方案从新手到进阶方案一一键脚本部署自动检测并安装Node.js、依赖全程无需手动配置环境。3.1.1 WindowsPowerShell管理员身份以管理员身份打开PowerShell开始菜单搜索PowerShell右键“以管理员身份运行”。执行国内镜像一键脚本解决网络超时iwr-useb https://open-claw.org.cn/install-cn.ps1|iex等待2-5分钟出现OpenClaw installed successfully即安装完成。3.1.2 macOS/Linux/WSL2终端打开终端macOSTerminalLinux系统终端。执行国内镜像一键脚本curl-fsSLhttps://open-claw.org.cn/install-cn.sh|bash等待安装完成输出版本号即成功。方案二npm全局安装自定义配置适合有基础的用户可自由切换版本、修改配置。安装Node.jsv22推荐用nvm管理版本nvm install 22→nvm use 22。全局安装OpenClaw国内版适配飞书npminstall-gopenclaw-cnlatest验证安装openclaw--version# 输出版本号如openclaw 2026.4.15即成功方案三Docker容器部署生产/隔离环境适合服务器部署环境隔离、一键启停、不污染本地系统。安装Docker并启动官网下载对应系统版本。拉取OpenClaw镜像dockerpull openclaw/openclaw:2026.4.15启动容器映射端口、挂载配置dockerrun-d\--nameopenclaw\-p18789:18789\-eTZAsia/Shanghai\-v~/.openclaw:/root/.openclaw\openclaw/openclaw:2026.4.15进入容器初始化dockerexec-itopenclawbashopenclaw init--fullexit四、初始化配置核心绑定大模型开启技能安装完成后通过onboard向导完成初始化全程交互式操作。4.1 启动配置向导openclaw onboard4.2 关键配置步骤步骤1选择大模型服务商国内首选阿里百炼、DeepSeek、火山方舟网络稳定、无需代理。海外可选Claude 3.5 Sonnet、GPT-4o需配置代理或中转。步骤2填写API Key百炼阿里云控制台→百炼大模型→创建应用→复制API Key。DeepSeek官网注册→API管理→创建密钥→复制保存。粘贴Key时注意空格复制后直接粘贴避免手动输入错误。步骤3开启核心技能文件管理读写、整理、分类本地文件必开。终端执行运行命令、脚本、程序谨慎授权避免高危操作。网页搜索联网获取信息、抓取内容必开。飞书集成绑定飞书机器人远程指挥国内用户首选交互方式。步骤4设置Web控制台端口默认端口18789可自定义需放行防火墙。4.3 配置文件说明配置文件默认路径~/.openclaw/config.json可手动修改{model:baichuan,apiKey:你的API Key,skills:[file,terminal,search,feishu],port:18789}五、启动与访问OpenClaw5.1 启动服务openclaw start成功提示 Lobster engine running ✅ Connected to 飞书 ✅ Web console: http://localhost:187895.2 验证服务状态方式1命令行检查openclaw doctor# 所有项目显示✅即正常方式2浏览器访问打开浏览器输入http://localhost:18789输入初始化时生成的Token登录Web控制台。5.3 停止/重启服务# 停止openclaw stop# 重启openclaw restart六、新手快速上手第一个任务6.1 交互方式二选一Web控制台直接在聊天框输入指令。飞书添加绑定的机器人为好友发送指令。6.2 测试指令文件整理把桌面所有图片整理到“桌面图片”文件夹。代码生成写一个Python爬虫抓取某网站标题并保存到txt。办公辅助生成一份本周工作周报包含工作总结、问题、下周计划。6.3 任务执行流程发送指令→龙虾AI解析需求→自主规划步骤。调用对应技能文件/终端/搜索→自动执行操作。完成后反馈结果→生成报告/文件。七、常见问题与避坑指南Q1安装时网络超时/下载失败解决方案执行镜像配置命令→重新安装。npmconfigsetregistry https://registry.npmmirror.comQ2Windows PowerShell提示“禁止运行脚本”解决方案执行命令解除限制→重新安装。Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSignedQ3启动后无法访问Web控制台排查步骤检查端口是否放行防火墙→高级设置→放行18789端口。确认服务运行openclaw doctor→所有✅。地址正确http://localhost:18789非https。Q4大模型调用失败/返回错误排查步骤检查API Key是否正确无空格、未过期。确认模型服务商网络连通国内用户优先百炼/DeepSeek。检查余额API Key对应账户是否有余额。八、进阶技能扩展与本地模型部署8.1 安装社区技能社区精选技能库https://github.com/VoltAgent/awesome-openclaw-skills。安装命令openclaw skillinstall技能名称8.2 部署本地模型完全离线安装Ollamahttps://ollama.com/支持Windows/macOS/Linux。拉取本地模型ollama pull deepseek-r1:7b配置OpenClaw使用本地模型openclaw configsetmodel ollama:deepseek-r1:7b重启服务openclaw restart→完全离线运行。