🤖

Clawdbot 中文教程

← 返回首页

快速入门 - 5 分钟上手 Clawdbot

本教程将带你从零开始，完成从安装到第一次对话的完整流程。确保你已经按照安装指南完成了 Clawdbot 的安装。

01

创建工作空间

首先创建一个目录作为你的 Clawdbot 工作空间，这个目录将存放所有配置文件和会话记录：

# 创建并进入工作目录
mkdir ~/my-clawdbot
cd ~/my-clawdbot

# 查看当前目录
pwd  # 应该显示 /home/你的用户名/my-clawdbot

💡 小提示： 工作目录可以放在任何地方，比如 ~/clawdbot、~/projects/clawdbot 等。选择一个你容易记住的位置即可。

02

初始化配置文件

使用 clawdbot init 命令初始化配置文件，这将在当前目录创建必要的配置文件：

# 初始化配置
clawdbot init

# 这将创建以下文件：
# ✅ AGENTS.md      - Agent 配置文件（AI 模型、人设等）
# ✅ MEMORY.md      - 长期记忆文件
# ✅ SOUL.md        - 个性化设置（你的 AI 的性格）
# ✅ TOOLS.md       - 工具配置
# ✅ USER.md        - 用户偏好设置

运行后，你可以使用 ls -la 命令查看创建的文件。

03

配置 AI 模型

Clawdbot 需要连接一个 AI 模型才能工作。最常用的是 OpenAI 的 GPT 模型。编辑 AGENTS.md 文件来配置：

3.1 编辑 AGENTS.md

# 使用 nano 编辑器打开 AGENTS.md
nano AGENTS.md

# 添加以下内容（设置默认 AI 模型）
default_model: openai/gpt-4

# 按 Ctrl+O 保存，然后 Ctrl+X 退出

3.2 设置 OpenAI API Key

你需要一个 OpenAI API Key。如果没有，请访问 OpenAI API Keys 页面 创建一个。

# 设置环境变量（临时有效，仅当前会话）
export OPENAI_API_KEY="sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 永久保存到 shell 配置文件
echo 'export OPENAI_API_KEY="sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"' >> ~/.bashrc

# 重新加载配置
source ~/.bashrc

📌 注意： API Key 需要以 sk- 开头。请妥善保管你的 API Key，不要分享给他人。

04

启动 Gateway 服务

Gateway 是 Clawdbot 的核心服务，负责处理所有消息和请求。启动 Gateway：

# 启动 Gateway 服务
clawdbot gateway start

# 你应该看到类似输出：
# ✅ Gateway started successfully
# 🎯 Session key: main

💡 进阶： 如果需要 Gateway 在后台持续运行（即使关闭终端），可以使用 nohup 或配置 systemd 服务。

05

配置第一个聊天平台

现在配置一个聊天平台，让我们选择 Telegram（最简单）或 Discord。以下是 Telegram 的配置步骤：

5.1 在 Telegram 创建机器人

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot 命令
  3. 按照提示输入机器人的名字（如：MyClawdbotBot）
  4. BotFather 会返回一个 Bot Token（类似：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）
  5. 记下这个 Token，后续配置需要用到

5.2 在 Clawdbot 中配置 Telegram

# 运行配置命令
clawdbot configure --channel telegram

# 按照提示输入你的 Bot Token
# Bot Token: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

# 配置完成后，Clawdbot 会自动连接到你的机器人
06

开始第一次对话

现在打开 Telegram，找到你创建的机器人，发送第一条消息：

你发送的消息：

你好，我是第一次使用 Clawdbot

Clawdbot 的回复（示例）：

你好！欢迎来到 Clawdbot。我是你的 AI 助手，可以帮你处理各种任务。有什么我可以帮助你的吗？

🎉 恭喜！ 你已经成功完成了从零开始的设置，现在可以与你的 AI 助手对话了！

🔧 常见问题

Q: Gateway 启动失败，提示 "command not found"

A: 确保已经正确安装了 Clawdbot（npm install -g clawdbot），并且添加到了系统 PATH 中。尝试重启终端或运行 source ~/.bashrc

Q: 机器人没有回复消息

A: 检查 API Key 是否正确设置，Gateway 是否正在运行（clawdbot gateway status），以及 Telegram Bot Token 是否正确

Q: 如何停止 Gateway 服务？

A: 运行 clawdbot gateway stop 命令

🚀 继续探索

现在你已经可以和 Clawdbot 对话了！接下来可以探索更多功能和命令

常用命令 →技能系统 →