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

一、环境准备与安全考虑

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：

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

macOS / Linux Terminal：

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

此脚本会自动安装 Node.js（≥22）并完成 CLI 配置。

2.2 手动安装 (适合高级用户或开发者)

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

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

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

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

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

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

三、初始化配置 (Onboarding)

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

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

向导主要包括以下步骤：

1. 选择模型提供商：
   • OpenAI (GPT-4)
   • Anthropic (Claude)
   • 本地模型（如 Llama.cpp）
   • 国内推荐：APIYI（星火）、通义千问（阿里云）。
2. 输入 API Key：
   • 将你的密钥粘贴进去，程序会自动验证。
3. 设置权限 (极其重要)：
   • OpenClaw 采用 Agent Mode，默认具备执行 Shell 权限。
   • 强烈建议：仅勾选“File System Access”和“Shell Access”，禁止“Network Access”（网络访问）以防止恶意代码外泄。
4. 生成或导入人格配置：
   • 你可以选择预设人格（如“开发者助手”），也可以自定义名称和描述。

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

四、启动网关 (Gateway) 与 Dashboard

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

# 启动网关（默认端口 18789） openclaw start # 或者使用守护进程方式（推荐用于服务器） 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 是最流行的接入方式之一。

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

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

**5.1.2 接入 Telegram

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

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

5.2 接入飞书 (Feishu / Lark)

飞书是中国企业内部沟通的主流工具，OpenClaw 对其支持非常友好。

5.2.1 前置准备：获取 App ID 和 App Secret

1. 访问 飞书开放平台（https://open.feishu.cn/ ）。
2. 创建企业自建应用，填写应用名称、图标等信息。
3. 在凭证与基础信息中获取：
   • App ID（客户端 ID）
   • App Secret（客户端密钥）
   • Verification Token（消息校验 Token，推荐开启）
4. 在机器人模块中开启机器人权限，并将机器人添加到企业（或单聊/群聊）。

5.2.2 安装飞书插件

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

5.2.3 配置飞书渠道

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

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

5.2.4 启动并验证

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

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

5.3 接入钉钉 (Dingtalk)

钉钉是阿里巴巴推出的企业通讯工具，OpenClaw 对其也有完整支持。

5.3.1 前置准备：获取 AppKey 和 AppSecret

1. 访问 钉钉开放平台（https://open.dingtalk.com/ ）。
2. 创建企业内部应用，设置名称、图标等。
3. 在应用信息页面获取：
   • AppKey（即 Client ID）
   • AppSecret（客户端密钥）
4. 配置安全设置中的机器人，获取Verification Token（可选，但建议配置）。

5.3.2 安装钉钉插件

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

5.3.3 配置钉钉渠道

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

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

5.3.4 启动并验证

# 重启网关 openclaw restart 

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

5.4 接入 Discord

Discord 是全球流行的社交与社区平台，OpenClaw 的插件支持直接接入。

5.4.1 前置准备：获取 Bot Token

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

5.4.2 安装 Discord 插件

# 安装 Discord 插件 openclaw plugins install -discord 

5.4.3 配置 Discord 渠道

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

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

5.4.4 启动并验证

# 重启网关 openclaw restart 

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

六、核心功能与日常使用

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

6.1 直接对话

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

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

如果 Agent 有 Shell 权限，它会自动读取文件内容并回复。

6.2 使用插件 (Skills)

OpenClaw 支持多种插件，例如：

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

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

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

6.3 自动化脚本 (Agent)

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

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

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

七、故障排除与进阶技巧

7.1 常见错误处理

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

Port 18789 被占用：

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

7.2 安全加固建议

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

使用 pm2 管理进程：确保服务异常退出后自动重启。

npminstall -g pm2 pm2 start "$(which openclaw)" --name openclaw pm2 save 

7.3 贡献与二次开发

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

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

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