![]()
文章目录
- 1.简介
- 2.核心定位与特点
- 3.核心架构
- 4.核心功能
- 5.市场热度与影响
- 6.部署方式
- 7.成本构成
- 8.安全风险与防护
- 3.常用命令
- 2.1 安装与初始化
- 2.2 配置管理
- 2.3 Gateway 服务管理（核心）
- 2.4 消息与智能体交互
- 2.5 技能（Skills）管理
- 2.6 多智能体管理
- 2.7 日志与调试
- 2.8 更新与维护
- 2.9 快速参考卡片
- 参考文献
1.简介
OpenClaw 是一个开源的、本地优先的自主AI智能体框架，被广泛称为“AI龙虾”。
其核心价值在于将 AI 从被动的“聊天工具”转变为能够主动连接各类平台并执行任务的“数字员工”。
OpenClaw 就是给AI大模型装上了“手和脚”，让它从“只会聊天”变成“能干活的数字员工”，24小时替你跑流程、管文件、处理杂事。
2.核心定位与特点
| 维度 | 说明 |
|---|
| 开源属性 | 完全开源，代码公开，用户可自由部署和修改 |
| 本地优先 | 支持在个人电脑或私有服务器上运行，数据完全本地化，隐私可控 |
| 自主执行 | 具备任务拆解、规划、调用工具、自我纠错的完整行动能力 |
| 长期记忆 | 持久化记忆能力，能记住用户偏好和历史交互，越用越“懂”你 |
| 多渠道接入 | 支持飞书、钉钉、企业微信、Telegram、WhatsApp 等主流IM平台 |
3.核心架构
OpenClaw 采用Gateway 网关架构，作为会话、路由和渠道连接的唯一事实来源：
| 核心组件 | 功能说明 |
|---|
| Gateway网关 | 连接多个聊天平台，管理会话和消息路由，默认地址http://127.0.0.1:18789/ |
| AI智能体 | 支持Claude、GPT、Gemini、DeepSeek、通义千问等十余家模型提供商 |
| Skills技能系统 | 可插拔的能力扩展单元，通过纯文本SKILL.md文件定义 |
| ClawHub技能市场 | 官方技能注册表，已收录超过13,729个社区技能 |
4.核心功能
- 本地文件管理：自动整理指定目录文件、分类归档，效率可提升81%以上
- 跨工具协同：联动微信、钉钉、WPS等软件完成复杂任务链
- 浏览器自动化：打开网页、截图、填写表单等操作
- 日程管理：微信截图秒变日历事件
- 定时任务：网站监控、AI日报自动生成与推送
- 代码生成与调试：编写、修改、测试代码
5.市场热度与影响
| 指标 | 数据 |
|---|
| GitHub星标 | 超过33万（截至2026年3月），超越 Linux 和 React，成为开源史上增速最快的软件项目 |
| 社区技能数量 | 超过1w+ |
| 国内“云养虾”社区 | 用户超10万 |
| AI Agent社交网络 | Moltbook平台已有超过3.2万个AI Agent注册 |
6.部署方式
OpenClaw 支持多种部署方案：
| 部署方式 | 适用场景 | 成本参考 |
|---|
| 本地npm安装 | 个人电脑，需要Node.js 22+环境 | 免费，但需自行承担模型API费用 |
| Docker部署 | 环境隔离、便于迁移 | 免费 |
| 阿里云一键部署 | 国内用户，预装通义千问模型 | 约9.9元/月起 |
| 腾讯云一键部署 | 企微/QQ生态用户 | 约17元/月起 |
| 百度云体验版 | 低成本试错 | 0.01元/月体验 |
| 火山引擎套餐 | 飞书深度集成用户 | 19.8元/月（含服务器+模型） |
7.成本构成
OpenClaw本身免费开源，主要成本来自模型API调用：
| 模型 | 输入价格 | 适用场景 |
|---|
| DeepSeek-V3.2.2 | $0.14/百万tokens | 极致省钱，性价比最高 |
| GLM-5 | $0.80/百万tokens | 代码能力强 |
| Claude Sonnet 4.6 | $3.00/百万tokens | Agent任务效果最佳 |
成本优化建议：采用“混合最优”方案——复杂任务用Claude Sonnet，日常对话用DeepSeek，心跳任务用免费模型，通过Fallback链自动调度。国内云厂商提供的Coding Plan包月套餐最低可至7.9元/月，包含多家模型自由切换。
8.安全风险与防护
主要风险
- 权限过高：OpenClaw需要较高的系统权限才能执行任务，一旦被恶意利用，可能导致设备被控制或数据泄露
- 提示词注入攻击：恶意指令可能诱导智能体执行危险操作
- 恶意技能：2026年初“ClawHavoc”供应链攻击事件中，ClawHub上约20%的技能被确认为恶意
- API Key泄露：配置不当可能导致模型调用密钥被盗刷
安全防护建议
- 最小权限原则：从低权限开始，按需逐步放权
- 网络隔离：避免将默认端口暴露于公网，通过VPN访问
- 审查技能源码：安装第三方技能前务必审查
- 设置监护人：关键操作由人工复核，如深圳“政务龙虾”配有在编公务员作为“监护人”
3.常用命令
直接运行openclaw或openclaw -h|--help会显示帮助信息。
根据官方文档和社区实践，OpenClaw 的命令按功能可以分为以下几大类。
下面是常用命令速查表：
2.1 安装与初始化
| 命令 | 说明 |
|---|
npm install -g openclaw@latest | 全局安装 OpenClaw（需 Node.js ≥22） |
openclaw --version | 查看版本号 |
openclaw onboard | 初始化向导（引导配置 AI 模型、API Key、消息渠道） |
openclaw onboard --install-daemon | 初始化并安装为后台守护进程（开机自启） |
openclaw init | 创建配置文件和工作区~/.openclaw/ |
2.2 配置管理
| 命令 | 说明 |
|---|
openclaw config get | 查看完整配置 |
openclaw config get models.default | 查看默认模型 |
openclaw config set models.default <model> | 设置默认模型 |
openclaw config set providers.deepseek.apiKey "<key>" | 配置 API Key |
openclaw configure | 交互式配置向导 |
openclaw doctor | 诊断配置问题 |
openclaw doctor --fix | 自动修复常见配置错误 |
openclaw models | 列出可用模型 |
openclaw models set <model> | 切换模型 |
2.3 Gateway 服务管理（核心）
| 命令 | 说明 |
|---|
openclaw gateway start | 后台启动（守护进程模式，推荐日常使用） |
openclaw gateway stop | 停止服务 |
openclaw gateway restart | 重启服务 |
openclaw gateway status | 查看运行状态（检查是否正常） |
openclaw gateway | 前台运行（调试用，关闭终端即退出） |
openclaw gateway --port 19000 | 指定端口启动，默认 18789 |
openclaw gateway install | 安装为系统服务（开机自启） |
openclaw health | 健康检查 |
openclaw dashboard | 打开 Web 控制台（浏览器访问 http://127.0.0.1:18789） |
2.4 消息与智能体交互
| 命令 | 说明 |
|---|
openclaw tui | 启动终端交互模式（在命令行里对话） |
openclaw agent --message "..." | 直接运行智能体（单次任务） |
openclaw agent --to +861234567890 --message "..." | 发送消息到指定号码/渠道 |
openclaw message send --to <target> --message "..." | 发送消息 |
/reset或/clear | 在聊天窗口中清空会话上下文 |
/status | 查看当前会话状态（模型、token 等） |
2.5 技能（Skills）管理
| 命令 | 说明 |
|---|
clawhub search "<keyword>" | 在 ClawHub 搜索技能 |
clawhub install <skill-slug> | 安装技能 |
clawhub list | 查看已安装技能 |
clawhub update --all | 更新所有技能 |
openclaw skill list | 查看已挂载的技能 |
openclaw skill add <name> | 添加技能模块 |
2.6 多智能体管理
| 命令 | 说明 |
|---|
openclaw agents add <id> --workspace <path> | 创建新智能体并分配工作区 |
openclaw agents list --bindings | 查看智能体及绑定状态 |
openclaw config get agents | 验证智能体配置 |
2.7 日志与调试
| 命令 | 说明 |
|---|
openclaw logs --follow | 实时查看日志 |
journalctl --user -u openclaw-gateway.service -f | Linux 系统日志（systemd） |
openclaw status | 查看整体状态（渠道、认证等） |
openclaw status --all | 完整状态报告 |
openclaw gateway probe | 探测 Gateway 连通性 |
openclaw channels status --probe | 检查消息渠道连接状态 |
2.8 更新与维护
| 命令 | 说明 |
|---|
openclaw update | 检查并更新 CLI |
npm update -g openclaw | 手动更新（npm 方式） |
openclaw update --channel beta | 切换到 beta 频道 |
2.9 快速参考卡片
| 场景 | 常用命令 |
|---|
| 首次安装 | openclaw onboard --install-daemon |
| 日常启动 | openclaw gateway start |
| 查看状态 | openclaw gateway status |
| 打开控制台 | openclaw dashboard |
| 出问题修复 | openclaw doctor --fix |
| 安装技能 | clawhub search xxx→clawhub install xxx |
| 终端对话 | openclaw tui |
| 切换模型 | openclaw models set <model> |
| 查看日志 | openclaw logs --follow |
| 重启服务 | openclaw gateway restart |
💡提示：所有命令都可以加-h|--help查看详细用法，例如openclaw gateway -h|--help。
如果你刚开始接触 OpenClaw，建议从openclaw onboard --install-daemon开始，按向导完成配置后，用openclaw gateway status确认服务正常，然后用openclaw dashboard打开 Web 界面开始体验。
参考文献
OpenClaw — Personal AI Assistant
