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

Ne0inhk

— 10 min read
【拥抱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 自动化平台，核心优势在于自托管（数据不出本地）和系统级权限（可执行实际任务）。通过以上步骤，你已经拥有了一个属于自己的“数字员工”。祝你玩得愉快 🎉

Read more

GitHub热榜----上帝视角玩转未来！MiroFish：基于群体智能的万物预测引擎

GitHub热榜----上帝视角玩转未来！MiroFish：基于群体智能的万物预测引擎

摘要：你是否想过像《黑客帝国》或《西部世界》那样，构建一个平行的数字世界？或者在小说写到瓶颈时，让书中人物自己“活”过来推演结局？今天介绍的开源项目 MiroFish，正是一个基于**多智能体（Multi-Agent）**技术的通用群体智能引擎。它能通过你上传的“种子信息”，自动生成成千上万个具备独立人格和记忆的智能体，在数字沙盘中演化未来。 🚀 前言：当 AI 拥有了“社会属性” 在 ChatGPT 单打独斗的时代，我们问它：“如果发生X，会产生什么后果？”它只能基于训练数据给出概率性的回答。 但在 MiroFish 构建的多智能体系统 (MAS) 中，AI 不再是一个孤独的对话框。MiroFish 让无数个 AI 智能体组成一个社会，它们有记忆、有性格、有社交关系。当你在系统中投入一个变量（比如一条突发新闻），你会看到这些智能体如何反应、

By Ne0inhk
如何在VsCode中使用git（免敲命令版本！保姆级！建议收藏！）

如何在VsCode中使用git（免敲命令版本！保姆级！建议收藏！）

目录 文章目录 前言 一、电脑安装git 二、在vscode安装git插件 三、克隆仓库 四、提交代码 五、创建分支、切换分支、合并分支 1、创建分支 2、切换分支 3、合并分支 六、创建标签和推送标签 七、解决冲突 八、拉取、抓取仓库 九、Reivew代码 总结 前言 随着Vscode的推出和普及，Git的使用也发生了变化，从原来的命令行管理仓库，再到现在用vscode从提交代码、解决冲突、reivew代码，整个管理仓库的过程全部都是可视化，大大降低了新手的使用难度，让新手也能轻松使用git 一、电脑安装git git官网：Git - 安装 Git 安装完git后，打开vscode显示这样的界面就是安装成功了

By Ne0inhk