【拥抱AI】openclaw的安装使用和部分建议

作者：CSDN博客

一、环境准备与安全考虑

OpenClaw 具备系统级权限（Agent Mode），意味着它可以执行 Shell 命令、访问文件系统等。因此，强烈建议在以下环境中运行：

推荐：Linux 服务器（如 Ubuntu 22.04）或 macOS。Windows 用户：强烈建议使用 WSL2（Linux 子系统），不要直接在原生 Windows 环境中运行（除非你非常了解风险），因为 Windows 的文件系统权限模型较为脆弱，可能导致误删系统文件。

最低硬件要求：

内存：8GB（建议 16GB，尤其是使用本地模型时）。磁盘：至少 20GB 可用空间（插件和模型缓存可能占用较多磁盘）。CPU：64位处理器，若运行大型语言模型（LLM）推荐更高频率 CPU。

---

二、安装方式

OpenClaw 提供了四种安装方式，你可以根据自己的需求选择。
2.1 推荐方式：一键安装脚本 (适合 Windows/macOS/Linux)

这是一键式安装，自动检测系统环境并完成安装。
Windows PowerShell：

1. # 设置执行权限Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
3. # 运行一键脚本iwr-useb https://openclaw.ai/install.ps1 |iex

复制代码

macOS / Linux Terminal：

1. # 直接运行脚本curl -fsSL https://openclaw.ai/install.sh |bash

复制代码

此脚本会自动安装 Node.js（≥22）并完成 CLI 配置。
2.2 手动安装 (适合高级用户或开发者)

如果你想自定义安装路径或贡献代码，可以手动安装。

1. # 1. 安装 Node.js (建议使用 nvm)curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh |bashsource ~/.bashrc
2. nvm install22
3. nvm use 22# 2. 安装 OpenClaw CLInpm i -g openclaw@latest   # 或者 pnpm add -g openclaw@latest

复制代码

2.3 Docker 部署 (适合生产环境或想隔离运行)

Docker 是最安全的运行方式，因为它将 OpenClaw 完全隔离在容器中。

1. docker run -d \
2.   -p 18789:18789 \
3.   -e OPENCLAW_ENDPOINT="http://127.0.0.1:18789"\
4.   --restart unless-stopped \
5.   ghcr.io/openclaw/openclaw:latest

复制代码

Docker 镜像中已预装了 Node.js，省去了系统环境配置的麻烦。

---

三、初始化配置 (Onboarding)

安装完成后，你需要进行一次初始化向导来完成服务注册、模型配置和权限设置。

1. # 进入交互式配置向导
2. openclaw onboard

复制代码

向导主要包括以下步骤：

选择模型提供商：

OpenAI (GPT-4)Anthropic (Claude)本地模型（如 Llama.cpp）国内推荐：APIYI（星火）、通义千问（阿里云）。

输入 API Key：

将你的密钥粘贴进去，程序会自动验证。

设置权限 (极其重要)：

OpenClaw 采用 Agent Mode，默认具备执行 Shell 权限。强烈建议：仅勾选“File System Access”和“Shell Access”，禁止“Network Access”（网络访问）以防止恶意代码外泄。

生成或导入人格配置：

你可以选择预设人格（如“开发者助手”），也可以自定义名称和描述。

⚠️ 权限警告：如果你选择了“无风险模式（No Risk）”，OpenClaw 将仅作为一个聊天机器人，失去自动化执行任务的能力。

---

四、启动网关 (Gateway) 与 Dashboard

配置完成后，你需要启动网关服务并打开 Web Dashboard。

1. # 启动网关（默认端口 18789）
2. openclaw start
4. # 或者使用守护进程方式（推荐用于服务器）
5. openclaw onboard --install-daemon

复制代码

网关默认监听 http://127.0.0.1:18789  ，可以通过浏览器访问 Web 控制面板。
访问 Dashboard

打开浏览器，输入 http://127.0.0.1:18789  ，你将看到类似以下的控制面板：

Skill Market：技能商城。Agent Settings：Agent 设置。Plugins：插件管理。Chat：即时对话窗口。

---

5. 接入即时通讯渠道 (Channel Integration)

OpenClaw 最强大的特性是可以通过聊天软件与 AI 交互。以下是接入 WhatsApp、飞书、钉钉和 Discord 的详细步骤。
5.1.1 接入 WhatsApp (保姆级)

WhatsApp 是最流行的接入方式之一。

1. # 安装 WhatsApp 渠道插件
2. openclaw add-channel whatsapp
4. # 按提示配置：# 1. 输入你的 WhatsApp Business API Key# 2. 输入你的手机号码（完整的国际区号格式）# 3. 完成后重启服务
5. openclaw restart-whatsapp

复制代码

*WhatsApp 需要申请 Business API，建议使用第三方服务商（如 Twilio）。
**5.1.2 接入 Telegram

Telegram 对开发者非常友好，免费且安全。

1. # 安装 Telegram 插件
2. openclaw add-channel telegram
4. # 按提示输入 Bot Token（通过 BotFather 创建机器人获取）
5. openclaw restart-telegram

复制代码

5.2 接入飞书 (Feishu / Lark)

飞书是中国企业内部沟通的主流工具，OpenClaw 对其支持非常友好。
5.2.1 前置准备：获取 App ID 和 App Secret

访问 飞书开放平台（https://open.feishu.cn/  ）。创建企业自建应用，填写应用名称、图标等信息。

• 在凭证与基础信息中获取：
  
  App ID（客户端 ID）App Secret（客户端密钥）Verification Token（消息校验 Token，推荐开启）
  
  在机器人模块中开启机器人权限，并将机器人添加到企业（或单聊/群聊）。
  

5.2.2 安装飞书插件

1. # 安装通用插件包（包含飞书插件）
2. openclaw plugins install -china/channels

复制代码

5.2.3 配置飞书渠道

1. # 启用飞书 Channel
2. openclaw config set channels.feishu.enabled true# 配置凭证（请替换 YOUR_APP_ID 和 YOUR_APP_SECRET）
3. openclaw config set channels.feishu.appId "YOUR_APP_ID"
4. openclaw config set channels.feishu.appSecret "YOUR_APP_SECRET"# 配置安全策略（推荐配置）
5. openclaw config set channels.feishu.connectionMode "websocket"# 推荐使用 websocket 连接
6. openclaw config set channels.feishu.dmPolicy "pairing"# 私聊策略：仅已配对用户
7. openclaw config set channels.feishu.groupPolicy "allowlist"# 群聊策略：仅白名单群聊
8. openclaw config set channels.feishu.requireMention true# 群聊中必须 @机器人 才响应

复制代码

说明：以上配置会在 -/.openclaw/openclaw.json 中生成对应的 JSON 配置块。

5.2.4 启动并验证

1. # 重启网关以加载新配置
2. openclaw restart

复制代码

在飞书中搜索你的 Bot 并发送 ping 或 !help，如果回复成功则表示接入成功。

---

5.3 接入钉钉 (Dingtalk)

钉钉是阿里巴巴推出的企业通讯工具，OpenClaw 对其也有完整支持。
5.3.1 前置准备：获取 AppKey 和 AppSecret

访问 钉钉开放平台（https://open.dingtalk.com/  ）。创建企业内部应用，设置名称、图标等。

• 在应用信息页面获取：
  
  AppKey（即 Client ID）AppSecret（客户端密钥）
  
  配置安全设置中的机器人，获取Verification Token（可选，但建议配置）。
  

5.3.2 安装钉钉插件

1. # 同样使用通用插件包（已包含钉钉插件）
2. openclaw plugins install -china/channels

复制代码

5.3.3 配置钉钉渠道

1. # 启用钉钉 Channel
2. openclaw config set channels.dingtalk.enabled true# 配置凭证（请替换 YOUR_APP_KEY 和 YOUR_APP_SECRET）
3. openclaw config set channels.dingtalk.clientId "YOUR_APP_KEY"
4. openclaw config set channels.dingtalk.clientSecret "YOUR_APP_SECRET"# 配置安全策略（推荐配置）
5. openclaw config set channels.dingtalk.connectionMode "websocket"
6. openclaw config set channels.dingtalk.dmPolicy "pairing"
7. openclaw config set channels.dingtalk.groupPolicy "allowlist"
8. openclaw config set channels.dingtalk.requireMention true

复制代码

提示：钉钉的配置键名通常是 clientId 和 clientSecret，请参考实际插件文档。

5.3.4 启动并验证

1. # 重启网关
2. openclaw restart

复制代码

在钉钉中私聊你的机器人或在群中 @机器人 发送 ping，如果收到回复则表示接入成功。

---

5.4 接入 Discord

Discord 是全球流行的社交与社区平台，OpenClaw 的插件支持直接接入。
5.4.1 前置准备：获取 Bot Token

访问 Discord 开发者门户（https://discord.com/developers/applications  ）。创建一个新应用，进入Bot标签页，开启 Bot 并获取 Bot Token（形如 MzU2...）。在OAuth2 -> URL Generator中勾选bot权限，生成邀请链接，将 Bot 邀请到目标服务器中。

5.4.2 安装 Discord 插件

1. # 安装 Discord 插件
2. openclaw plugins install -discord

复制代码

5.4.3 配置 Discord 渠道

1. # 启用 Discord Channel
2. openclaw config set channels.discord.enabled true# 配置 Bot Token
3. openclaw config set channels.discord.token "YOUR_BOT_TOKEN"# 配置安全策略（推荐配置）
4. openclaw config set channels.discord.connectionMode "websocket"
5. openclaw config set channels.discord.dmPolicy "pairing"
6. openclaw config set channels.discord.groupPolicy "allowlist"
7. openclaw config set channels.discord.requireMention true

复制代码

说明：Discord 通常只需要填入 Bot Token，其他策略默认即可，但强烈建议开启 requireMention 防止被刷屏。

5.4.4 启动并验证

1. # 重启网关
2. openclaw restart

复制代码

在 Discord 服务器中私聊 Bot 或在频道中 @Bot 发送 !help，如果 Bot 回复帮助信息则表示接入成功。

---

六、核心功能与日常使用

配置完成后，你可以像使用 ChatGPT 那样开始对话，并利用它的强大功能。
6.1 直接对话

在 Dashboard 或你的聊天软件中输入：

1. 帮我检查一下 `/etc/hosts` 文件是否被篡改？

复制代码

如果 Agent 有 Shell 权限，它会自动读取文件内容并回复。
6.2 使用插件 (Skills)

OpenClaw 支持多种插件，例如：

File System：读写本地文件。Bash：执行 Shell 命令。Web Scraper：抓取网页信息。

你可以通过指令启用或查看插件列表：

1. # 查看已安装的插件
2. openclaw skills list
4. # 启用 Bash 插件（危险操作，请确保安全）
5. openclaw skills enablebash

复制代码

6.3 自动化脚本 (Agent)

在对话中输入以下格式的指令，OpenClaw 会自动生成脚本并执行：

1. 写一个 Bash 脚本，每隔 5 分钟检查一次 CPU 使用率是否超过 80%，如果超过就发送邮件提醒。

复制代码

它会输出脚本内容，并提示你是否执行。

---

七、故障排除与进阶技巧

7.1 常见错误处理

• Port 18789 被占用：
  1. # 查看占用情况lsof -i:18789
  3. # 更改端口（编辑配置文件）nano ~/.config/openclaw/config.yaml

  复制代码
  Node.js 版本不兼容：确保使用 node -v 检查版本，必须是 22+。
  Docker 端口映射错误：确保 Docker 运行命令中的 -p 18789:18789 正确。
  

7.2 安全加固建议

不在生产服务器上开启网络访问权限，除非你明确知道对方在做什么。

• 使用 pm2 管理进程：确保服务异常退出后自动重启。
  1. npminstall -g pm2
  2. pm2 start "$(which openclaw)" --name openclaw
  3. pm2 save

  复制代码

7.3 贡献与二次开发

OpenClaw 是开源项目。如果你想自定义 Agent 行为或开发新插件：

Fork 项目源码。在 plugins/ 目录下编写新的插件。提交 Pull Request。

---

写在最后：
OpenClaw 是一个极具潜力的 AI 自动化平台，核心优势在于自托管（数据不出本地）和系统级权限（可执行实际任务）。通过以上步骤，你已经拥有了一个属于自己的“数字员工”。祝你玩得愉快