danghuangshang/docs/tutorial-basics.md

🏛️ 保姆级教程：30 分钟搭建你的 AI 朝廷（基础篇）

← 返回 README | 📚 文档索引

适用人群：完全零基础小白 | 预计耗时：30-45 分钟

最终效果：拥有一台永久免费的云服务器，运行你的 AI 朝廷团队

---

📖 目录

1. 领免费服务器（10 分钟）
2. 连接服务器（5 分钟）
3. 一键安装 OpenClaw（5 分钟）
4. 配置 API Key（5 分钟）
5. 搭建朝廷架构（15 分钟）
6. 启动并测试（5 分钟）
7. 常见问题 Q&A
8. 15 张配图清单

---

一、领免费服务器（10 分钟）

1.1 打开云服务商官网

推荐（均有免费套餐）：

• Oracle Cloud：https://cloud.oracle.com （永久免费 ARM 4核24G，首选）
• AWS：https://aws.amazon.com （12个月免费 t2.micro）
• Google Cloud：https://cloud.google.com （$300 试用额度）

以下以 Oracle Cloud 为例，其他云服务商流程类似。

1.2 填写基本信息

• Country/Territory：选择 China
• Name：你的真实姓名（拼音）
• Email：推荐 Gmail/Outlook（QQ 邮箱可能收不到验证码）
• 点击 "Verify my email"

⏱️ 耗时：1 分钟 ❗ 易错点：邮箱一定要能正常收海外邮件！

1.3 验证邮箱

1. 打开邮箱，找到 Oracle Cloud 发的验证邮件
2. 复制 6 位验证码
3. 粘贴回注册页面，点击 "Verify Code"

1.4 设置密码

密码要求：至少 8 个字符，含大写 + 小写 + 数字 + 特殊字符

💡 建议格式：MyCloud2026! 这种

1.5 选择主区域（⚠️ 最重要！）

选定后无法更改！ 推荐：

区域	推荐指数	说明
🇯🇵 日本东京	⭐⭐⭐⭐⭐	延迟低，容量足
🇯🇵 日本大阪	⭐⭐⭐⭐	备选
🇺🇸 美西凤凰城	⭐⭐⭐⭐	容量大

❗ 易错点：不要选新加坡/首尔！经常缺货抢不到！

1.6 填写地址和手机

• Address：随便填个英文地址（合理即可）
• Phone：+86 你的手机号
• 选择 "Text me a code" 收短信验证

❗ +86 有时收不到短信，多试几次或换个时间段

1.7 添加信用卡

🔒 不会扣费！ 只是身份验证，Oracle 会预授权 $1（之后退回）

支持的卡	说明
✅ Visa 信用卡/借记卡	推荐
✅ MasterCard 信用卡/借记卡	推荐
❌ 银联卡	不支持
❌ 预付费卡	大概率失败

❗ 必须是 Visa 或 MasterCard！确保卡上有 $1 余额！

1.8 完成注册

1. 勾选同意条款
2. 点击 "Start my free trial"
3. 等待激活（通常几分钟到几小时）

📍 成功标志：收到邮件 "Your Oracle Cloud account is activated" ✅

1.9 登录控制台

1. 访问：https://cloud.oracle.com
2. 输入 Cloud Account Name
3. 选择 "Oracle Cloud Infrastructure Direct Sign-In"
4. 输入邮箱和密码登录

1.10 创建服务器实例

1. 点击左上角 ☰ 汉堡菜单
2. 选择 Compute → Instances
3. 点击 "Create Instance"

配置实例：

配置项	推荐值	说明
Name	openclaw-server	随便起
Image	Ubuntu 24.04	⚠️ 一定要改！默认不是 Ubuntu
Shape	VM.Standard.A1.Flex	ARM 架构
OCPUs	4	免费最大 4 核
Memory	24 GB	免费最大 24GB
Public IP	Assign	必须分配公网 IP
SSH 密钥	Generate	⚠️ 下载私钥保存好！只能下载一次！
Boot Volume	200GB	免费最大

❗ 超级易错点：

• 必须选 ARM（Ampere），AMD 的免费实例只有 1GB 内存几乎不能用！
• SSH 密钥只能下载一次！关掉页面就没了！

1.11 等待实例创建

点击 "Create" 后，等待状态变为 "RUNNING"（约 2-5 分钟），记下 Public IP Address（如 144.24.xxx.xxx）。

---

⚠️ 中国大陆用户特别说明

可能遇到的问题：

• 🚫 中国大陆 IP 可能被限制注册
• 🚫 免费额度抢手，可能显示 "Out of capacity"
• 🚫 需要国际信用卡（Visa/MasterCard）

解决方案：

方案	说明
🟢 方案 1：挂梯子注册（推荐）	用香港/日本节点，邮箱用 Gmail/Outlook，成功率 90%+
🟡 方案 2：用其他云服务商	AWS 12 个月免费 / Google Cloud $300 额度 / 腾讯云学生机 ¥9.9/月
🟡 方案 3：本地运行	Mac/Windows 直接装 OpenClaw，不用服务器但需保持开机

⚠️ 本地安装有安全风险！ Agent 拥有工作区内完整读写权限。新手强烈建议先用云服务器！ 如果一定要本地装：workspace 设为专用目录（如 ~/clawd），给所有 Agent 开 sandbox 隔离。

---

二、连接服务器（5 分钟）

Windows 用户

方法一：PowerShell（推荐）

# 1. 打开 PowerShell（Win+X → 终端）

# 2. 设置密钥权限
icacls "C:\Users\你的用户名\Downloads\ssh-key-2025-xx-xx.key" /inheritance:r /grant:r "%USERNAME%:R"

# 3. 连接服务器
ssh -i "C:\Users\你的用户名\Downloads\ssh-key-2025-xx-xx.key" ubuntu@你的服务器IP

方法二：MobaXterm（图形界面）

1. 下载：https://mobaxterm.mobatek.net/download.html
2. 打开 → Session → SSH
3. 填写 Remote host / username: ubuntu / Use private key
4. 点击 OK 连接

Mac / Linux 用户

# 1. 设置密钥权限
chmod 400 ~/Downloads/ssh-key-2025-xx-xx.key

# 2. 连接服务器
ssh -i ~/Downloads/ssh-key-2025-xx-xx.key ubuntu@你的服务器IP

首次连接确认

首次会提示 Are you sure you want to continue connecting (yes/no)?，输入 yes 回车。

📍 成功标志：看到 ubuntu@openclaw-server:~$ 提示符就对了！✅

❗ 用户名是 ubuntu，不是 root！如果提示 Permission denied，检查密钥路径和权限。

---

三、一键安装（5 分钟）

SSH 连上服务器后，复制粘贴这一行：

bash <(curl -fsSL https://raw.githubusercontent.com/wanikua/danghuangshang/main/install.sh)

脚本自动完成：系统更新、防火墙配置、Swap、Node.js 22、GitHub CLI、OpenClaw 安装、工作区初始化。

安装完成后验证：

openclaw --version

⏱️ 耗时：3-5 分钟 📍 成功标志：能看到版本号就对了！✅

💡 如果 npm 下载慢：npm install -g openclaw --registry=https://registry.npmmirror.com

---

四、配置 API Key（5 分钟）

4.1 获取 LLM API Key

1. 访问你的 LLM 服务商控制台
2. 注册/登录账号
3. 在 API Keys 页面创建新 Key
4. 复制 Key

🔴 API Key 只显示一次！ 复制后妥善保存！

💡 费用说明：新账号通常有 $5 免费额度，正常使用每月 $10-30 够了。

4.2 保存好你的 API Key

先复制到记事本保存好，下一步会把它填进配置文件 openclaw.json。

💡 不需要设环境变量，API Key 直接写在配置文件里就行。

---

五、搭建朝廷架构（15 分钟）

5.1 自定义核心文件

一键脚本已经创建好了 SOUL.md、IDENTITY.md、USER.md，你只需要按需修改：

cd ~/clawd
ls -la

# 编辑个人信息
nano USER.md

# 按需修改行为准则和架构定义
nano SOUL.md
nano IDENTITY.md

5.2 配置 OpenClaw

nano ~/.openclaw/openclaw.json

一键脚本已生成包含 7 个部门的完整模板。基础篇只用 4 个（司礼监+兵部+户部+礼部），你可以直接在模板上修改。

精简配置示例（记得替换 API Key 和 Bot Token）：

{
  "models": {
    "providers": {
      "your-provider": {
        "baseUrl": "https://your-llm-provider-api-url",
        "apiKey": "你的LLM_API_KEY",
        "api": "openai",
        "models": [
          {
            "id": "fast-model",
            "name": "快速模型",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "strong-model",
            "name": "强力模型",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "workspace": "/home/ubuntu/clawd",
      "model": { "primary": "your-provider/fast-model" },
      "sandbox": { "mode": "non-main" }
    },
    "list": [
      {
        "id": "silijian",
        "name": "司礼监",
        "model": { "primary": "your-provider/fast-model" },
        "sandbox": { "mode": "off" }
      },
      {
        "id": "bingbu",
        "name": "兵部",
        "model": { "primary": "your-provider/strong-model" },
        "identity": { "theme": "你是兵部尚书，专精软件工程、系统架构、代码审查。" },
        "sandbox": { "mode": "all", "scope": "agent" }
      },
      {
        "id": "hubu",
        "name": "户部",
        "model": { "primary": "your-provider/strong-model" },
        "identity": { "theme": "你是户部尚书，专精财务分析、成本管控、电商运营。" },
        "sandbox": { "mode": "all", "scope": "agent" }
      },
      {
        "id": "libu",
        "name": "礼部",
        "model": { "primary": "your-provider/fast-model" },
        "identity": { "theme": "你是礼部尚书，专精品牌营销、社交媒体、内容创作。" },
        "sandbox": { "mode": "all", "scope": "agent" }
      }
    ]
  },
  "channels": {
    "discord": {
      "enabled": true,
      "groupPolicy": "open",
      "allowBots": "mentions",
      "accounts": {
        "silijian": { "name": "司礼监", "token": "司礼监的Bot Token", "applicationId": "司礼监的Application ID", "groupPolicy": "open" },
        "bingbu": { "name": "兵部", "token": "兵部的Bot Token", "applicationId": "兵部的Application ID", "groupPolicy": "open" },
        "hubu": { "name": "户部", "token": "户部的Bot Token", "applicationId": "户部的Application ID", "groupPolicy": "open" },
        "libu": { "name": "礼部", "token": "礼部的Bot Token", "applicationId": "礼部的Application ID", "groupPolicy": "open" }
      }
    }
  },
  "bindings": [
    { "agentId": "silijian", "match": { "channel": "discord", "accountId": "silijian" } },
    { "agentId": "bingbu", "match": { "channel": "discord", "accountId": "bingbu" } },
    { "agentId": "hubu", "match": { "channel": "discord", "accountId": "hubu" } },
    { "agentId": "libu", "match": { "channel": "discord", "accountId": "libu" } }
  ]
}

⚠️ 重要配置说明：

• workspace 是 Agent 的"领地"，设为 /home/ubuntu/clawd ✅，不要设成家目录 ❌
• groupPolicy: "open" 在 channels 和每个 account 里都要加，否则群聊消息会被丢弃
• allowBots: "mentions" Bot 只在被@时响应其他 Bot（防止无限循环）

5.3 创建 Discord Bot（每个部门一个）

💡 多 Bot 架构：每个部门 = 一个独立的 Discord Bot！基础篇需要 4 个 Bot。

第一步：创建 Application（重复 4 次）

1. 打开 https://discord.com/developers/applications
2. 点击 "New Application"
3. 名字填部门名（司礼监、兵部、户部、礼部）

第二步：创建 Bot 并获取 Token

对每个 Application：

1. 左边菜单点 "Bot"
2. 点击 "Reset Token" → 复制 Token（只显示一次！）
3. 把 Token 填到 openclaw.json 的 accounts 对应位置

⚠️ 同一页面往下滚，每个 Bot 都要开启：

• ✅ Message Content Intent（必须！否则收不到消息）
• ✅ Server Members Intent
• Presence Intent（可选）

第三步：邀请所有 Bot 到你的服务器

对每个 Application：

1. 左边菜单点 "OAuth2"
2. 勾选 bot
3. Bot Permissions 勾选：Send Messages ✅ / Read Message History ✅ / View Channels ✅
4. 复制生成的邀请链接 → 浏览器打开 → 选择服务器 → Authorize
5. 重复 4 次，直到 4 个 Bot 都加入

保存配置：nano 中按 Ctrl+O → 回车保存 → Ctrl+X 退出

---

六、启动并测试（5 分钟）

6.1 启动 Gateway

# 安装 Gateway 服务
openclaw gateway install

# 启动
systemctl --user start openclaw-gateway

# 查看状态
systemctl --user status openclaw-gateway

📍 成功标志：看到 "active (running)" 就对了！✅

6.2 测试对话

在 Discord 的任意频道测试：

@司礼监 你好，自我介绍一下
@兵部 用 Python 写个 Hello World
@户部 如何控制 AI API 成本
@礼部 写条小红书文案，主题是 AI 工具推荐

📍 成功标志：每个 Bot 的回复风格不一样就对了！🎉

6.3 常用命令

systemctl --user status openclaw-gateway    # 查看状态
systemctl --user restart openclaw-gateway   # 重启
journalctl --user -u openclaw-gateway --since today  # 查看日志
systemctl --user stop openclaw-gateway      # 停止

---

七、常见问题 Q&A

💡 更多 FAQ 见 完整 FAQ 和 README

Q: Oracle Cloud 注册一直失败？ 换梯子节点、确认 Visa/MasterCard、换 Gmail 邮箱。实在不行用 AWS/腾讯云。

Q: 显示 "Out of capacity"？ 换区域（tokyo/osaka/phoenix）、换时间段（凌晨成功率高）、等几天再试。

Q: SSH 连接被拒绝？ 确认实例是 RUNNING、用户名是 ubuntu、私钥文件正确、安全组开放 22 端口。

Q: openclaw 命令找不到？ 运行 source ~/.bashrc，还不行就 sudo npm install -g openclaw。

Q: Gateway 启动失败？

journalctl --user -u openclaw-gateway --since today --no-pager
openclaw doctor

常见原因：API Key 未填、JSON 格式错误、Bot Token 无效。

---

八、15 张配图清单

编号	内容	截图位置	标注重点
1	Oracle Cloud 注册页	cloud.oracle.com	圈出 "Sign Up"
2	注册表单	邮箱输入区域	圈出邮箱框和验证按钮
3	验证邮件	邮箱收件箱	圈出 6 位验证码
4	密码设置	密码输入页面	标注密码要求
5	区域选择	Home Region 下拉框	圈出 "ap-tokyo-1"
6	信用卡填写	卡号输入页面	圈出 Visa/MasterCard
7	Oracle Cloud 控制台	cloud.oracle.com	圈出登录入口
8	Instances 页面	Compute → Instances	圈出 "Create Instance"
9	实例配置页	Shape 和 SSH 密钥	圈出 ARM 选择
10	实例详情页	实例运行状态	圈出公网 IP
11	MobaXterm 配置	Session 设置窗口	圈出 IP、密钥
12	安装完成截图	终端输出	圈出 "部署完成！"
13	LLM API 页	服务商控制台	圈出 "Create Key"
14	~/clawd 目录	ls -la 输出	圈出 SOUL.md 等
15	配置文件	openclaw.json	圈出 agents.list

---

🎉 恭喜完成！ 现在你拥有一台永久免费的云服务器和一个 AI 朝廷团队。

下一步：→ 进阶篇 — tmux、GitHub、Notion、Cron、Prompt 技巧