乐于分享
好东西不私藏

最新OpenClaw 新手指南,零成本安装,是否适合普通人?

最新OpenClaw 新手指南,零成本安装,是否适合普通人?

🚀安装效果

🚀是否适合普通人?不适合

安装的效果Windows电脑8G能正常安装,但是调用本地qwen2.5:7b模型速度有点慢,切换为16G电脑依然是慢,OpenClaw最基本的还是看LLM的能力,LLM的能力越强,它的能力越强,所以开源的模型意义不大,必须需要付费的模型。

如果购买token实现一些简单的Skills的能力还是很不错的工作助手,譬如搞一个定时任务每日9点汇总什么财经新闻;在GitHub上查询不错Skills的功能进行安装。

官方地址:https://clawhub.ai/skills?sort=downloads&nonSuspicious=true

baoyu开发的skills地址:https://github.com/JimLiu/baoyu-skills/blob/main/README.zh.md 有一个不错的一键发布公众号的能力

🚀什么是 OpenClaw?

OpenClaw 是一款个人 AI 助手,运行在你自己的设备上。它可以通过你已经在使用的通讯渠道(WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat 等)与你交互,还支持语音对话、Canvas 可视化等高级功能。

OpenClaw 是一个本地优先的 AI 助手网关,它的核心设计理念是:

  • 个人化
    :为你个人服务,而非企业级多用户系统
  • 本地运行
    :Gateway 运行在你的设备上(macOS、Linux、Windows WSL2)
  • 多渠道接入
    :支持几乎所有主流通讯平台
  • 功能丰富
    :浏览器控制、Canvas 可视化、语音交互、定时任务等

架构概览

WhatsApp/Telegram/Slack/Discord/GoogleChat/Signal/ iMessage /WebChat┌───────────────────────────────┐Gateway       (控制平面 - 核心)             ws://127.0.0.1:18789      │└──────────────┬────────────────┘├─AI 智能体 (Agent)├─CLI 命令行工具├─WebChat 网页界面├─ macOS/iOS/Android 客户端└─ 浏览器控制 (ChromeCDP)

📦安装指南

系统要求

  • Node.js ≥ 22
    (必须)
  • 操作系统
    :macOS、Linux、Windows (WSL2)
  • 包管理器
    :npm、pnpm 或 bun

快速安装(Windows)

打开 Windows PowerShell

按照三步走:node安装-ollama安装-模型下载-openclaw安装

  • node安装 注意版本号

# 下载地址:下载完成直接安装就行https://nodejs.org/dist/v22.12.0/node-v22.12.0-x64.msi
  • ollama下载 选择Windows版本

# 下载地址https://ollama.com/download/windows安装注意事项:最好安装到D盘,因为模型下载也需要存储
  • 选择一个开源模型下载

# 下载命令ollama pull qwen2.5:7b
#运行命令
ollama run qwen2.5:7b

  • 设置ollama存储模型的路径

  • 检查安装

# 查看node版本号node -v# 查看ollama版本号ollama -v
最后一步了 前面的准备环境已经准备好了,那就是开始安装龙虾
  • 下载openclaw
# 安装命令npm install -g openclaw@latest
  • 安装向导
    这一步比较麻烦,认真读一下英文,模型的配置和渠道最重要,模型配置key主要不写空,随便填写一个字符串就行,
    如其他的渠道和skills配置选择直接跳过就行 Skip for now。

# 安装向导命令 openclaw onboard --install-daemon

  • 开启网关

# 命令 openclaw gateway start

上面的就是正式完成安装 访问地址就行。

📁Workspace 工作空间

Workspace 是 OpenClaw 智能体的工作目录,也是它读取上下文、保存记忆、执行工具操作的唯一位置。

Workspace 结构

~/.openclaw/├── openclaw.json# 主配置文件├── workspace/# 默认工作空间│ ├── AGENTS.md# 操作指令和记忆│ ├── SOUL.md# 人格、边界、语气│ ├── TOOLS.md# 工具使用笔记│ ├── IDENTITY.md# 助手名称/头像/表情│ ├── USER.md# 用户信息│ ├── MEMORY.md# 长期记忆(仅主会话加载)│ └── skills/# 工作空间级技能├── agents/# 多智能体会话存储├── skills/# 全局技能└── credentials/# 凭证存储

核心文件说明

Workspace 核心文件及其用途说明
文件
用途
加载时机
AGENTS.md
操作指令、连续性规则、重要记忆
每会话首条消息
SOUL.md
人格定义、语气、边界
每会话首条消息
TOOLS.md
环境特定的工具说明
每会话首条消息
USER.md
用户信息、偏好、项目背景
每会话首条消息
IDENTITY.md
助手身份(名称、表情、头像)
每会话首条消息
MEMORY.md
长期记忆(安全敏感内容)
仅主会话

⌨️常用 CLI 命令

Gateway 管理

# 查看状态openclaw gateway status# 启动/停止/重启openclaw gateway startopenclaw gateway stopopenclaw gateway restart

配置管理

# 运行配置向导openclaw onboard# 获取/设置配置值openclaw config get agents.defaults.workspaceopenclaw config set agents.defaults.model.primary "openai/gpt-5.2"

诊断工具

# 健康检查openclaw doctor# 自动修复openclaw doctor --fix# 查看日志openclaw logs --follow

🔒安全最佳实践

⚠️

永远不要在未经保护的情况下公开 DM:使用 dmPolicy: "pairing" 或 allowlist 而非 open

多用户环境

{"session":{"dmScope":"per-channel-peer"}}

沙盒执行

{"agents":{"defaults":{"sandbox":{"mode":"non-main","scope":"agent"}}}}

🔧故障排除

常见错误及解决方案
错误
原因
解决
Config validation failed
配置格式错误
运行 openclaw doctor
Unauthorized
API Key 无效
检查 auth 配置
Session not found
会话已过期
发送 /new 重置

🔗资源链接

  • 官网
    : openclaw.ai
  • 文档
    : docs.openclaw.ai
  • GitHub
    : github.com/openclaw/openclaw
  • Discord
    : discord.gg/clawd
  • 技能市场
    : clawhub.com

📝总结

OpenClaw 是一个功能强大、灵活的个人 AI 助手平台。关键要点:

  1. Gateway 是核心
     - 所有功能都围绕 Gateway 展开
  2. Workspace 是工作空间
     - 保持文件整洁,控制 token 使用
  3. 配置即代码
     - openclaw.json 定义一切行为
  4. 安全第一
     - 默认使用配对模式,谨慎开放 DM
  5. 多智能体支持
     - 可以为不同任务创建专门的助手