OpenClaw AI 智能体平台部署与技能配置指南

全局安装 OpenClaw：

npm install -g openclaw@latest

初始化配置：

openclaw onboard --install-daemon

这一步会进入交互式配置，关键选择如下：

• 模式：选择 QuickStart。
• 模型：推荐选择 Moonshot AI (Kimi) 或 Qwen（国内用户友好）。
• API Key：输入从 Kimi 或阿里云百炼平台获取的 Key。
• 聊天载体：新手先选 Skip，使用内置的 TUI 测试。
• 网络搜索：选择对应的搜索 API（如 Kimi 搜索或 Tavily）。

验证部署： 启动网关并访问 Web 控制台：

openclaw gateway start

浏览器打开 http://127.0.0.1:18789，输入生成的 Token 即可看到 Dashboard。

3.2 云服务器部署（以阿里云为例）

云端部署适合需要 24 小时在线的任务。

1. 购买服务器：

   • 进入阿里云轻量应用服务器购买页。
   • 镜像选择：应用镜像 -> OpenClaw (Moltbot) 官方镜像。
   • 地域选择：建议选美国（弗吉尼亚）或中国香港，避免国内网络限制导致的联网搜索功能受限。
   • 配置：内存必须 ≥2GiB。

2. 配置防火墙：

   • 在服务器控制台放行端口：18789（核心端口）和 8080（WebUI）。

3. 配置大模型 API（阿里云百炼）：

   • 访问阿里云百炼控制台，开通服务并创建 API Key。
   • 在服务器应用详情页，点击'一键配置'，填入 API Key。

4. 获取访问地址：

   • 执行命令生成 Token，点击'打开网站页面'即可开始使用。

第四部分：技能篇 —— 让 OpenClaw 真正干活

核心原则：先装 Skill-Vetter 做安检，再装其他技能；任何新技能必先扫描再使用。

4.1 必装的四大核心技能

1. Skill-Vetter：安全安检员（装机前置必备） 这是第一道防线，用于扫描恶意代码和风险权限，避免 API Key 泄露。

   • 安装：npx clawhub@latest install skill-vetter
   • 使用：clawhub scan --all（扫描所有已装技能）

2. Find-Skills-Skill：技能搜索神器 解决'不会找、找不对'的痛点，直接在终端搜索技能库。

   • 安装：npx clawhub@latest install find-skills-skill
   • 使用：clawhub find 办公自动化（搜索相关技能）

3. Tavily-Search：实时联网搜索 赋予 AI 实时联网能力，返回结构化搜索结果和可信度评分。

   • 前置：注册 Tavily 获取免费 API Key。
   • 配置：

     export TAVILY_API_KEY="tvly-your-key"
     

   • 使用：clawhub run tavily-search "今天的科技新闻"

4. Browser-Use / Office-Automation：网页与办公自动化 让 OpenClaw 直接操控浏览器（点击、登录、填表）或处理 Excel/Word 文档，是'落地执行'的关键。

   • 安装：npx clawhub@latest install browser-use
   • 使用：clawhub run browser-use --task "登录 OA 系统下载本月报表"

4.2 技能通用管理命令

• 安装流程：npx clawhub@latest install <技能名> -> openclaw restart -> clawhub list。
• 卸载：clawhub uninstall <技能名>。

第五部分：进阶篇 —— 集成与自动化

5.1 接入钉钉 / 飞书

OpenClaw 支持接入即时通讯软件，变成群里的'数字员工'。

1. 安装插件：openclaw plugins install @openclaw/dingtalk-connector（以钉钉为例）。
2. 配置凭证：
   • 在钉钉开放平台创建应用，获取 Client ID 和 Client Secret。
   • 编辑配置文件 ~/.openclaw/openclaw.json，填入凭证并设置 channel 类型为 dingtalk。
3. 启动与测试：
   • 重启网关：openclaw gateway restart。
   • 在钉钉群里 @机器人 即可下达指令。

5.2 大模型 API 配置指南

• 阿里云千问（Qwen）：

  openclaw config set models.providers.qianwen.apiKey=你的 Key
  openclaw config set models.providers.qianwen.baseUrl=https://dashscope.aliyuncs.com/compatible-mode/v1
  

• Kimi（Moonshot）： 在初始化时选择 .cn 接入点，填入平台生成的 Key。
• 免费方案：可使用 MiniMax 或智谱 GLM 的免费额度进行测试。

5.3 科研辅助实战案例

OpenClaw 可以辅助完成复杂的科研任务，例如：

• 文献检索：通过 QQ/钉钉发送指令'搜索 2026 年大模型相关的顶会论文'。
• 自动下载：OpenClaw 调用 Scholar-Search-Skill，下载 PDF 到指定目录。
• 发送邮件：自动将下载的论文打包发送到指定邮箱。
• 撰写综述：指令'根据下载的文献，写一份 2000 字的研究综述'，OpenClaw 生成 Word 文档发回。

第六部分：避坑与维护

6.1 常见故障排查

• 端口未对齐：
  • 现象：界面可开，但会话不通。
  • 解决：检查 App 连接的端口（默认 18789）与 CLI 和 Gateway 是否一致。
• 命令未找到：
  • 现象：终端提示 openclaw: command not found。
  • 解决：将 npm 全局包路径加入 PATH：

    export PATH=$(npm prefix -g)/bin:$PATH
    

• 国内网络超时：
  • 解决：配置 npm 镜像 npm config set registry https://registry.npmmirror.com。
• 钉钉签名验证失败：
  • 解决：检查系统时间是否同步（NTP），确认加密 Key 正确。

6.2 安全红线

• 权限最小化：不要给 OpenClaw 根目录的读写权限，限制其访问范围。
• 隔离环境：建议在虚拟机或 Docker 中运行敏感任务。
• 定期审计：每季度轮换 API Key，检查技能来源。

6.3 性能调优

对于高并发场景（如企业客服），可调整 config.json 中的参数：

{
  "worker_threads": 4,
  "message_queue_size": 1000
}

结语

至此，你已经完成了从零基础到进阶应用的 OpenClaw 全攻略学习。核心总结三点：

1. 先跑通链路：把 App、Gateway、CLI 三者协作跑顺，不要急于追新插件。
2. 技能为王：装对 4 个核心技能（安检、搜索、找技能、自动化），解决 80% 的需求。
3. 安全第一：所有第三方技能必经 Skill-Vetter 扫描。