diff --git a/website/guide.html b/website/guide.html index 0e4d204..8270dce 100644 --- a/website/guide.html +++ b/website/guide.html @@ -126,6 +126,9 @@ ul{padding-left:20px} 国产模型（免翻墙） 国际模型 DeepSeek 配置 + Kimi 配置 + 通义千问配置 + OpenRouter 统一网关 @@ -157,6 +160,24 @@ ul{padding-left:20px} +
+
▶ 📋 日常使用
+
+ 定时任务 + 多模型与省钱 +
+
+ +
+
▶ 🔒 进阶部署
+
+ VPS 部署 + 安全加固 + 配置文件参考 + 社区资源 +
+
+
▶ 📖 官方文档
@@ -473,6 +494,18 @@ git clone https://gitee.com/dongsheng123132/u-claw.git 豆包字节跳动Volcano Engine火山引擎 MiniMaxMiniMaxMiniMax语音、多模态 + +

新手首次配置推荐

+

如果你是第一次配置 AI 模型，以下模型配置最简单，适合入门：

+ + + + + + + +
模型配置难度说明
Kimi (月之暗面)最简单注册即用，向导直接选择
智谱 GLM简单免费额度，配置直观
通义千问 Qwen简单阿里云生态，免费额度大
DeepSeek简单需填 Custom Provider + Base URL
腾讯混元中等腾讯云生态
+
注意：不建议新手使用淘宝等渠道购买的第三方 API Key。这类 Key 来源不明，调试困难，容易出问题。请直接到各模型官网注册获取。
@@ -484,6 +517,18 @@ git clone https://gitee.com/dongsheng123132/u-claw.git GPT-4OpenAI兼容性广 GeminiGoogle免费额度 + +
国际模型 API 需要翻墙或使用中转站。推荐使用 OpenRouter 统一管理。
+ +

通过 OpenRouter（推荐）

+

OpenRouter 汇聚了主流 AI 模型，一个 API Key 用所有模型，部分有免费额度。

+
1
注册 OpenRouter
访问 openrouter.ai，GitHub 登录。
+
2
获取 API Key
Keys → Create Key → 复制。
+
3
配置 +
openclaw onboard
+# 选择 OpenRouter
+# API Key: 粘贴
+# Model: 选择你要用的模型
@@ -1160,6 +1205,7 @@ openclaw plugin uninstall <插件名> 启用 SSH（可选，让其他电脑远程控制） 
sudo bash /media/*/Ventoy/u-claw-linux/enable-ssh.sh
+

如果 U 盘脚本找不到，也可以手动启用（见下方"远程控制"章节）

首次启动 Ubuntu

@@ -1194,6 +1240,44 @@ sudo bash /media/*/Ventoy/u-claw-linux/format-persistence.sh
  • 关机前正常关闭 Ubuntu（不要直接拔 U 盘）
    • +

    远程控制（用另一台电脑管理 Linux）

    + +
    +

    适用场景：你有一台 Mac / Windows / Linux 电脑（比如 Mac mini），想远程控制这台从 U 盘启动的 Linux 机器——安装 OpenClaw、改配置、调试问题，全程不用跑到 Linux 电脑面前操作。

    +
    + +

    方法一：用 U 盘自带脚本（推荐）

    +

    如果 U 盘里有 u-claw-linux/ 目录：

    +
    sudo bash /media/*/Ventoy/u-claw-linux/enable-ssh.sh
    +

    脚本会自动安装 SSH、让你设密码、显示 IP 地址。

    + +

    方法二：手动启用 SSH（3 条命令）

    +

    如果脚本找不到，或者没有 U 盘，手动也很简单：

    + +
    1
    安装并启动 SSH 服务 +
    sudo apt update && sudo apt install -y openssh-server && sudo systemctl start ssh
    +

    粘贴后回车，可能需要输入密码确认

    +
    + +
    2
    设置登录密码 +
    sudo passwd $USER
    +

    输入两次新密码。如果 Ubuntu Live 用户名是 ubuntu，密码就是给 ubuntu 用户设的

    +
    + +
    3
    查看 IP 地址 +
    hostname -I
    +

    会显示类似 192.168.18.45 的地址，记下来

    +
    + +

    从另一台电脑连接

    +

    在 Mac / Windows / Linux 的终端输入：

    +
    ssh ubuntu@192.168.18.xx
    +

    把 192.168.18.xx 换成上一步显示的实际 IP，输入刚才设的密码即可连接。

    + +
    配合 Claude Code 使用：在 Mac mini 上打开 Claude Code，告诉它 ssh ubuntu@192.168.18.xx 密码是 xxx，Claude Code 就能通过 Bash 工具远程执行命令——安装 OpenClaw、改配置、调试，全程自动化。
    + +
    外网远程（不在同一 WiFi）：两台电脑都安装 Tailscale，用同一账号登录，即可通过 Tailscale IP（100.x.x.x）从任何地方连接，无需公网 IP。
    +

    常见问题

    USB 启动不了

    @@ -1307,6 +1391,32 @@ npm install -g openclaw@latest --registry=https://registry.npmmirror.com # 验证 openclaw --version +

    用 pnpm 安装（更快）

    +
    # 如果没有 pnpm，先安装
+npm install -g pnpm
+
+# 用 pnpm 安装 OpenClaw
+pnpm add -g openclaw@latest
+pnpm approve-builds -g
+openclaw onboard --install-daemon
    + +

    从源码构建（开发者）

    +
    git clone https://github.com/openclaw/openclaw.git
+cd openclaw && pnpm install && pnpm ui:build && pnpm build
+pnpm link --global
+openclaw --version
    + +

    常见安装问题

    +
    sharp 构建失败？添加环境变量跳过本地编译： +
    SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
    + +
    找不到 openclaw 命令？PATH 未包含全局 bin 目录： +
    # 添加到 ~/.zshrc 或 ~/.bashrc
+export PATH="$(npm prefix -g)/bin:$PATH"
+source ~/.zshrc
    + +
    Windows 用户建议：推荐使用 WSL2（Windows Subsystem for Linux）安装，兼容性最好。原生 Windows 可能遇到路径和权限问题。
    +

    第四步：配置国产 AI 模型

    启动配置向导：

    # 启动引导向导 + 安装后台守护进程
@@ -1385,6 +1495,167 @@ fnm install 22 && fnm use 22
    运行诊断：openclaw doctor --repair 可以自动检测和修复常见问题。
    + +
    +

    Kimi / 月之暗面 配置

    +
    1
    注册
    访问 platform.moonshot.cn，注册账号。
    +
    2
    获取 API Key
    控制台 → 开发者 → 创建密钥 → 复制保存。
    +
    3
    配置 +
    openclaw onboard
+# 选择 Moonshot AI
+# API Key: 粘贴你的 Key
+# Model: moonshot-v1-128k（或 moonshot-v1-8k）
    +

    或手动配置 Base URL：https://api.moonshot.cn/v1

    +
    +
    + + +
    +

    通义千问 Qwen 配置

    +

    阿里云生态，免费额度大，适合免费体验。

    +
    1
    注册阿里云
    访问 dashscope.console.aliyun.com，用支付宝一键登录。
    +
    2
    开通 DashScope
    进入控制台 → 开通 DashScope 服务（免费）。
    +
    3
    创建 API Key
    控制台 → API Key 管理 → 创建 → 复制保存。
    +
    4
    配置 +
    openclaw onboard
+# 选择 Qwen
+# API Key: 粘贴你的 Key
    +
    + + +
    +

    OpenRouter 统一网关

    +

    OpenRouter 汇聚了主流 AI 模型，一个 API Key 用所有模型，部分有免费额度。

    +
    1
    注册 OpenRouter
    访问 openrouter.ai，GitHub 登录。
    +
    2
    获取 API Key
    Keys → Create Key → 复制。
    +
    3
    配置 +
    openclaw onboard
+# 选择 OpenRouter
+# API Key: 粘贴
+# Model: 选择你要用的模型
    + +

    直连方式

    + + + + + +
    模型注册地址Base URL
    Claudeconsole.anthropic.com默认即可
    OpenAIplatform.openai.com默认即可
    Geminiai.google.dev默认即可
    +
    + + +
    +

    定时任务

    +

    通过 cron 设置自动执行的任务，让 AI 助手定时完成工作。

    +
    # 每天早上 8 点发送天气预报
+openclaw cron add "0 8 * * *" "查看今天深圳天气并发送到飞书"
+
+# 每小时检查邮件
+openclaw cron add "0 * * * *" "检查新邮件，有重要的通知我"
+
+# 每天下午 6 点总结工作
+openclaw cron add "0 18 * * *" "总结今天的工作进度"
+
+# 查看所有定时任务
+openclaw cron list
    +
    + + +
    +

    多模型与省钱技巧

    +
      +
    1. 日常对话用 DeepSeek（~1元/百万 token），复杂任务切 Claude
      2. +
    2. 用 OpenRouter 统一管理多个模型，一个 Key 用所有
      3. +
    3. 为不同聊天平台配置不同模型（QQ 用便宜的，工作飞书用好的）
      4. +
    4. 善用免费额度：通义千问、Gemini 都有大量免费额度
      5. +
    +
    + + +
    +

    VPS 部署（24/7 在线）

    +

    在云服务器上部署 OpenClaw，实现 24 小时在线的 AI 助手。

    + +

    推荐配置

    + + + + +
    配置规格价格参考
    最低1核 2GB~50元/月
    推荐2核 4GB~100元/月
    + +

    Docker 一键部署

    +
    git clone https://github.com/openclaw/openclaw.git
+cd openclaw
+cp .env.example .env
+# 编辑 .env，填入 API Key 和 Bot Token
+docker compose up -d
    +
    + + +
    +

    安全加固

    + +
    + + +
    +

    配置文件参考

    +

    配置文件位置：~/.openclaw/openclaw.json（U-Claw 用户：U-Claw/data/.openclaw/openclaw.json）

    + +
    {
+  "gateway": {
+    "mode": "local",
+    "port": 18789,
+    "bind": "127.0.0.1",
+    "auth": { "token": "你的Token" }
+  },
+  "models": {
+    "providers": {
+      "deepseek": {
+        "baseUrl": "https://api.deepseek.com/v1",
+        "apiKey": "sk-xxx",
+        "api": "openai-completions",
+        "models": [{ "id": "deepseek-chat", "contextWindow": 128000 }]
+      }
+    }
+  },
+  "agents": {
+    "defaults": {
+      "model": { "primary": "deepseek/deepseek-chat" }
+    }
+  },
+  "channels": {
+    "telegram": { "enabled": true, "botToken": "xxx:xxx" },
+    "qqbot": { "enabled": true, "appId": "xxx", "appSecret": "xxx" }
+  }
+}
    +
    配置文件支持热重载，修改后自动生效，无需重启网关。
    +
    + + +
    +

    社区资源

    + + + + + + + + + + + + +
    分类项目说明
    U-ClawU-Claw 官网下载、文档、技能市场
    GitHub源码、Issue、Release
    上游OpenClaw 官方上游仓库
    ClawHub官方技能市场
    教程hello-clawDatawhale 体系化入门教程
    openclaw-docs276 篇源码级深度文档
    awesome-openclaw-skills社区精选技能合集
    社区教程官方安装手册（中文）OpenClaw 官方中文安装文档，含 pnpm、源码构建等
    工具NapCatQQQQ 机器人框架（备选）
    openclaw-wechat微信接入插件
    +
    +