OpenClaw 快速上手

恋喵大鲤鱼2026-03-23 9:13

文章目录

1.简介

OpenClaw 是一个开源的、本地优先的自主AI智能体框架，被广泛称为"AI龙虾"。

其核心价值在于将 AI 从被动的"聊天工具"转变为能够主动连接各类平台并执行任务的"数字员工"。

OpenClaw 就是给AI大模型装上了"手和脚"，让它从"只会聊天"变成"能干活的数字员工"，24小时替你跑流程、管文件、处理杂事。

核心定位与特点

维度 说明
开源属性 完全开源，代码公开，用户可自由部署和修改
本地优先 支持在个人电脑或私有服务器上运行，数据完全本地化，隐私可控
自主执行 具备任务拆解、规划、调用工具、自我纠错的完整行动能力
长期记忆 持久化记忆能力，能记住用户偏好和历史交互，越用越"懂"你
多渠道接入 支持飞书、钉钉、企业微信、Telegram、WhatsApp 等主流IM平台

核心架构

OpenClaw 采用 Gateway 网关架构，作为会话、路由和渠道连接的唯一事实来源：
聊天应用

飞书/企微/微信等
Gateway网关
AI智能体

Claude/GPT/DeepSeek等
Skills技能系统
Web控制界面

核心组件 功能说明
Gateway网关 连接多个聊天平台，管理会话和消息路由，默认地址 http://127.0.0.1:18789/
AI智能体 支持Claude、GPT、Gemini、DeepSeek、通义千问等十余家模型提供商
Skills技能系统 可插拔的能力扩展单元，通过纯文本 SKILL.md 文件定义
ClawHub技能市场 官方技能注册表，已收录超过13,729个社区技能

核心功能

  1. 本地文件管理：自动整理指定目录文件、分类归档，效率可提升81%以上
  2. 跨工具协同：联动微信、钉钉、WPS等软件完成复杂任务链
  3. 浏览器自动化：打开网页、截图、填写表单等操作
  4. 日程管理：微信截图秒变日历事件
  5. 定时任务：网站监控、AI日报自动生成与推送
  6. 代码生成与调试：编写、修改、测试代码

市场热度与影响

指标 数据
GitHub星标 超过33万（截至2026年3月），超越 Linux 和 React，成为开源史上增速最快的软件项目
社区技能数量 超过1w+
国内"云养虾"社区 用户超10万
AI Agent社交网络 Moltbook平台已有超过3.2万个AI Agent注册

部署方式

OpenClaw 支持多种部署方案：

部署方式 适用场景 成本参考
本地npm安装 个人电脑，需要 Node.js 22+ 环境 免费，但需自行承担模型API费用
Docker部署 环境隔离、便于迁移 免费
阿里云一键部署 国内用户，预装通义千问模型 约9.9元/月起
腾讯云一键部署 企微/QQ生态用户 约17元/月起
百度云体验版 低成本试错 0.01元/月体验
火山引擎套餐 飞书深度集成用户 19.8元/月（含服务器+模型）

成本构成

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元/月，包含多家模型自由切换。

安全风险与防护

主要风险

  • 权限过高：OpenClaw需要较高的系统权限才能执行任务，一旦被恶意利用，可能导致设备被控制或数据泄露
  • 提示词注入攻击：恶意指令可能诱导智能体执行危险操作
  • 恶意技能 ：2026年初"ClawHavoc"供应链攻击事件中，ClawHub上约20% 的技能被确认为恶意
  • API Key泄露：配置不当可能导致模型调用密钥被盗刷

安全防护建议

  1. 最小权限原则：从低权限开始，按需逐步放权
  2. 网络隔离：避免将默认端口暴露于公网，通过VPN访问
  3. 审查技能源码：安装第三方技能前务必审查
  4. 设置监护人：关键操作由人工复核，如深圳"政务龙虾"配有在编公务员作为"监护人"

2.快速开始

安装 OpenClaw

shell 复制代码 
npm install -g openclaw@latest

初始化向导

shell 复制代码 
# 仅配置
openclaw onboard

# 配置 + 安装系统后台服务（开机自启，生产推荐）
openclaw onboard --install-daemon

启动 Gateway 网关

shell 复制代码 
openclaw gateway start

# 如果启动有问题，可以查看 gateway 状态，然后进一步定位
openclaw gateway status

打开 Web 控制台

shell 复制代码 
# 启动浏览器打开控制台
openclaw dashboard

# 或手动打开浏览器访问
http://127.0.0.1:18789

完整的安装和开发环境设置请参阅快速开始。

3.配置 Model

TODO

4.配置 Channel

OpenClaw 支持多种消息渠道作为与 AI 智能体交互的入口，可以在初始化向导时配置，也可以单独配置。

以下是主流 Channel（渠道）概览。

渠道 状态 主要用途 配置难度
Telegram ✅ 生产可用 私聊、群组机器人 ⭐ 简单
Discord ✅ 生产可用 服务器频道、私信 ⭐⭐ 中等
WhatsApp ✅ 支持 个人/群组聊天 ⭐⭐ 中等
QQ ✅ 支持 私聊、群聊（需沙箱） ⭐⭐ 中等
飞书 ✅ 支持 企业通讯 ⭐⭐ 中等
钉钉 ✅ 支持 企业通讯 ⭐⭐ 中等
Slack ✅ 支持 工作区集成 ⭐⭐ 中等
iMessage ✅ 支持 Apple 设备 ⭐⭐⭐ 复杂
Signal ✅ 支持 加密通讯 ⭐⭐ 中等

下面以 Telegram 为例，给出配置指引。其他 Channel 可自行研究。

步骤 1：创建 Telegram Bot

  1. 打开 Telegram，搜索 @BotFather
  2. 发送 /newbot，按提示输入机器人名称和用户名（用户名必须唯一且以bot或Bot 结尾）
  3. 复制保存返回的 API Token ，格式如：1234567890:ABCdefGHIJklmnop-QRSTuvw

步骤 2：OpenClaw 设置 Telegram Bot Token

shell 复制代码 
openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.botToken "你的bot_token"

验证配置：

shell 复制代码 
openclaw config get channels.telegram

配置信息也可在配置文件~/.openclaw/openclaw.json手动查看。

步骤 3：配置访问策略

  • 方案 A：只允许你自己使用（推荐）

先用 openclaw status 或日志找到你的 Telegram 用户 ID，然后：

bash 复制代码 
openclaw config set channels.telegram.dmPolicy allowlist
openclaw config set channels.telegram.allowFrom '["你的用户ID"]'
  • 方案 B：使用配对模式（允许新用户申请）
bash 复制代码 
openclaw config set channels.telegram.dmPolicy pairing
  • 方案 C：完全开放（任何人都能用，有风险）
bash 复制代码 
openclaw config set channels.telegram.dmPolicy open

步骤 4：群聊配置（可选）

如果机器人要加入群聊：

bash 复制代码 
openclaw config set channels.telegram.groupPolicy allowlist
openclaw config set channels.telegram.groupAllowFrom '["群组ID1", "群组ID2"]'
openclaw config set channels.telegram.requireMention true

步骤 5：重启 Gateway 使配置生效

bash 复制代码 
openclaw gateway restart

步骤 6：验证渠道状态

bash 复制代码 
openclaw channels status

应该看到 Telegram 渠道显示 connected 或 ready。

5.常用命令

直接运行 openclaw 或 openclaw -h|--help会显示帮助信息。

根据官方文档和社区实践，OpenClaw 的命令按功能可以分为以下几大类。

下面是常用命令速查表：

安装与初始化

命令 说明
npm install -g openclaw@latest 全局安装 OpenClaw（需 Node.js ≥22）
openclaw --version 查看版本号
openclaw onboard 初始化向导（引导配置 AI 模型、API Key、消息渠道）
openclaw onboard --install-daemon 初始化并安装为后台守护进程（开机自启）
openclaw init 创建配置文件和工作区 ~/.openclaw/

配置管理

命令 说明
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> 切换模型

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）

消息与智能体交互

命令 说明
openclaw tui 启动终端交互模式（在命令行里对话）
openclaw agent --message "..." 直接运行智能体（单次任务）
openclaw agent --to +861234567890 --message "..." 发送消息到指定号码/渠道
openclaw message send --to <target> --message "..." 发送消息
/reset 或 /clear 在聊天窗口中清空会话上下文
/status 查看当前会话状态（模型、token 等）

技能（Skills）管理

命令 说明
clawhub search "<keyword>" 在 ClawHub 搜索技能
clawhub install <skill-slug> 安装技能
clawhub list 查看已安装技能
clawhub update --all 更新所有技能
openclaw skill list 查看已挂载的技能
openclaw skill add <name> 添加技能模块

多智能体管理

命令 说明
openclaw agents add <id> --workspace <path> 创建新智能体并分配工作区
openclaw agents list --bindings 查看智能体及绑定状态
openclaw config get agents 验证智能体配置

日志与调试

命令 说明
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 检查消息渠道连接状态

更新与维护

命令 说明
openclaw update 检查并更新 CLI
npm update -g openclaw 手动更新（npm 方式）
openclaw update --channel beta 切换到 beta 频道

快速参考卡片

场景 常用命令
首次安装 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 界面开始体验。

小结

TODO

参考文献

OpenClaw --- Personal AI Assistant

相关推荐
ofoxcoding2 小时前
2026 大模型 API 价格一览：GPT-5/Claude 4.6/Gemini 3/DeepSeek V3 费率实测对比
gpt·ai
belldeep2 小时前
AI: 介绍 微软 BitNet 下载、安装、使用说明
人工智能·microsoft·ai·bitnet
xiaoxue..2 小时前
大模型全栈技术图谱：LLM → Token → Context → Prompt → Tool → MCP → Agent → Skill
人工智能·ai·大模型
-许平安-2 小时前
MCP项目笔记四（Transport）
开发语言·c++·笔记·ai·mcp
倾心琴心2 小时前
【agent辅助热仿真学习】实践1 hotspot 热仿真代码流程学习
ai·agent·芯片·热仿真·求解
猿小猴子2 小时前
主流 AI IDE 之一的 华为云码道「CodeArts」 介绍
ide·人工智能·ai·华为云
knqiufan10 小时前
PingCraft：从需求文档到可追踪工作项的 Agent 实践之路
ai·llm·agent·pingcode
xixixi7777716 小时前
2026 年 03 月 20 日 AI+通信+安全行业日报（来更新啦）
大数据·人工智能·安全·ai·大模型·通信
智算菩萨17 小时前
【Generative AI For Autonomous Driving】1 生成式AI重塑自动驾驶的技术浪潮与体系化挑战
论文阅读·人工智能·深度学习·机器学习·ai·自动驾驶
热门推荐
01GitHub 镜像站点02Qwen3.5 开源全解析：从 0.8B 到 397B，代际升级 + 全场景选型指南03围棋-html版本04小黑课堂计算机二级WPSoffice题库软件下载安装教程（2026年3月最新版）05班级宠物园部署指南06OpenClaw 使用和管理 MCP 完全指南07OpenClaw Control UI安全上下文访问配置08UV安装并设置国内源09AI 编程三剑客：Spec-Kit、OpenSpec、Superpowers 深度对比与实战指南10“wsl --install -d Ubuntu-22.04”下载慢，中国地区离线安装 Ubuntu 22.04 WSL方法（亲测2025年5月6日）