myagents/README.md

MyClaude

一个基于 Claude Code 的个人助理工具，支持通过飞书机器人进行远程交互。

功能特性

• 🤖 多模型支持：Claude、DeepSeek、Kimi、Kimi Code
• 💬 飞书机器人集成：随时随地与 AI 助手对话
• 📝 智能记忆：自动保存对话历史和项目上下文
• 🔧 技能扩展：支持自定义 Skill 增强功能

视频教程

📺 部署流程详解：Bilibili - MyClaude 完整部署指南

快速开始

1. 安装 Claude Code

macOS/Linux:

curl -fsSL https://claude.ai/install.sh | sh
# 或使用 npm: npm install -g @anthropic-ai/claude-code

Windows:

irm https://claude.ai/install.ps1 | iex
# 或: winget install Anthropic.ClaudeCode

注意：Windows 用户需先安装 Git for Windows

💡 认证提示：运行 claude login 后，建议选择 方案 2 (API Key)，但将 API Token 留空。这样 Claude 会使用 cc-switch 的配置，方便后续通过 cc-switch 切换不同模型。

来源：Claude Code 官方文档

2. 开通大模型会员（推荐）

服务	说明	开通地址
DeepSeek	国产高性能大模型	https://platform.deepseek.com
Kimi	长文本处理专家，API 按量计费	https://kimi.moonshot.cn
Kimi Code	代码专用模型，包月/包年订阅更实惠	Kimi 内开通 Code 会员

3. 安装 cc-switch（多模型切换）

macOS:

brew tap farion1231/tap
brew install cc-switch

Windows:

1. 访问 https://github.com/farion1231/cc-switch/releases
2. 下载 .msi 安装包运行

配置模型:

cc-switch add deepseek --api-key YOUR_KEY
cc-switch add kimi --api-key YOUR_KEY
cc-switch default claude

4. 安装 Metabot

快速安装:

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/xvirobotics/metabot/main/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/xvirobotics/metabot/main/install.ps1 | iex

安装器会引导完成：工作目录设置 → Claude 认证 → IM 平台选择 → 机器人配置 → PM2 自启动

5. 配置飞书机器人

5.1 创建飞书应用

1. 访问 飞书开发者平台
2. 创建企业自建应用，添加「机器人」能力
3. 获取 AppID 和 AppSecret
4. 开通权限：im:message、im:message:readonly、im:resource

5.2 配置 bots.json

在 metabot/bots.json 创建配置（与 myclaude 项目同级目录）:

{
  "feishuBots": [
    {
      "name": "myclaude",
      "feishuAppId": "cli_xxxxx",
      "feishuAppSecret": "xxxxxxxxxxxxx",
      "defaultWorkingDirectory": "~/Documents/myResearch/myProjects/apaam/repo/myclaude"
    }
  ]
}

💡 提示：飞书应用需要先发布，再开启「长连接」事件订阅

---

使用指南

启动服务

# 启动飞书机器人
metabot start

# 本地交互模式
myclaude chat

首次使用

告诉 Claude：

"我是第一次使用，请引导式地问我一些问题，帮我建立个性化配置并更新到 CLAUDE.md 中。"

这会帮你设置：身份背景、技术栈、沟通偏好、工作模式等。

日常交互

方式 1：飞书对话

• 在飞书中找到机器人
• 直接发送消息即可对话

方式 2：本地终端

cd ~/Documents/myResearch/myProjects/apaam/repo/myclaude
myclaude chat

---

进阶配置

Skill 管理

方式 1：让 Claude 帮你找

# 安装 find-skills
npx skills add -g shubhamsaboo/awesome-llm-apps@find-skills
/skill skills-sync

然后直接对话：

"帮我找一个能处理 PDF 的 skill" 或 "我想找个前端设计的 skill"

方式 2：手动安装

# 项目级（仅当前项目）
mkdir -p .claude/skills/my-skill
cp SKILL.md .claude/skills/my-skill/

# 全局（所有项目）
mkdir -p ~/.claude/skills/my-skill
cp SKILL.md ~/.claude/skills/my-skill/

推荐 Skills:

Skill	用途	安装
pdf	PDF 处理	npx skills add -g anthropic/skills@pdf
git-proxy-clone	加速 Git 下载	npx skills add -g xvirobotics/metabot@git-proxy-clone
metabot	飞书 API 调用	npx skills add -g xvirobotics/metabot@metabot
metamemory	共享知识库	npx skills add -g xvirobotics/metabot@metamemory

Workspace 与资料管理

创建项目工作区（告诉 Claude 让它帮你操作）：

"在 workspace 下创建 myproject 目录，并链接我的 Works 文件夹和 iCloud 知识库"

Claude 会自动执行：

• 创建 workspace/myproject/
• 建立软连接到常用目录
• 初始化项目结构

Obsidian 集成（可选）:

告诉 Claude：

"帮我在 iCloud 创建 ClaudeWorkspace 文件夹，软连接到 workspace，并配置 Obsidian"

优势：

• 📱 iPhone/iPad 随时查看 Claude 生成的内容
• 📝 双向编辑（Obsidian ↔ Claude）
• 🔍 Obsidian 全文检索资料

---

常用指令

指令	说明
/help	显示帮助
/reset	重置对话（飞书卡住时用）
/stop	停止当前任务
/skills	列出可用 skills
/memory	查看记忆内容

---

常见问题

Q1: 飞书回复 error 或卡住
发送 /reset 重置对话

Q2: 切换模型

cc-switch list
cc-switch use deepseek

Q3: 飞书机器人不响应

1. 检查 metabot start 是否启动
2. 检查 bots.json 凭证是否正确
3. 飞书应用是否已发布、长连接是否开启

Q4: Windows 找不到 Git Bash
在 ~/.claude/settings.json 添加：

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

---

项目结构

myclaude/
├── .claude/
│   ├── skills/          # 自定义技能
│   ├── memory/          # 持久化记忆
│   └── conversations/   # 对话记录
├── workspace/           # 工作目录
│   ├── archives/        # 归档资料
│   ├── references/      # 参考资料
│   └── templates/       # 常用模板
├── CLAUDE.md            # 项目配置（自动生成）
└── README.md            # 本文件

License

MIT